1. Home
  2. Docs
  3. Agents

Docs

Use Slop City from your agent

Connect Claude, Cursor or any MCP client: install snippets, the REST API and the OpenAPI description.

$ npx add-mcptools/listok 11 tools

Slop City is built to be driven by agents as well as people. Your AI assistant can read your city (ideas, designs, products, listings, orders, the bank) and approve or reject work in the Town Hall queue, through an MCP server or a REST API. It works the same for print-on-demand and dropshipping stores.

1. Get an API key

API access is included on City and Metropolis. Create a key in Settings. It is shown once and only its hash is stored. Keep it in an environment variable, never in a repo.

2. Connect over MCP

Claude Code

shell
claude mcp add --transport http slop-city https://app.slopship.com/mcp --header "Authorization: Bearer $API_KEY"

Cursor (.cursor/mcp.json)

json
{
  "mcpServers": {
    "slop-city": {
      "url": "https://app.slopship.com/mcp",
      "headers": {
        "Authorization": "Bearer ${env:API_KEY}"
      }
    }
  }
}

Claude Desktop (claude_desktop_config.json)

json
{
  "mcpServers": {
    "slop-city": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://app.slopship.com/mcp",
        "--header",
        "Authorization: Bearer ${API_KEY}"
      ],
      "env": {
        "API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

The server speaks JSON-RPC over HTTP (initialize, ping, tools/list, tools/call) and keeps no session. Ask for tools/list to see the current tools.

3. Or use the REST API

shell
curl -H "Authorization: Bearer $API_KEY" https://app.slopship.com/api/v1/bank
curl -X POST -H "Authorization: Bearer $API_KEY" https://app.slopship.com/api/v1/approvals/ITEM_ID/approve

The full OpenAPI 3.1 description is at https://app.slopship.com/openapi.json.

What an agent can do

  • Read: buildings, ideas, designs, IP checks, products, listings, orders, the bank summary, stuck crates and pending approvals.
  • Write: approve or reject an item, set a building's autonomy.
  • A write never publishes, orders or spends by itself. Auto mode must be switched on by you, on a plan that includes it.

Discovery files

  • /llms.txt and /llms-full.txt: plain-text descriptions for AI assistants
  • /.well-known/mcp: MCP endpoint metadata
  • /server.json: MCP registry document
  • /openapi.json: REST API description
  • /sitemap.xml

Keys are checked on every request. If your plan stops including API access, the key stops working at once.

Open your city. Let it sell while you sleep.

Pick a plan and your city is ready in minutes.

Start your city