Connect your client to quant-swarm

All three servers work remote (OAuth 2.1, no token in configs) or via stdio with an access token. Free token at /mcp/; pit.analysis answers on the free tier (lite).

Claude Code

CLI setup

If the client shows nothing: check that uv is installed (`uv --version`) and that Python 3.11+ is on PATH. Tools always LIST without a token; a call that returns an access-required envelope means the email-code consent (remote) or SWARM_MCP_ACCESS_TOKEN (stdio) is missing.

Cursor

CLI setup

The /mcp page renders live deep links for this client from the install manifest.

If the client shows nothing: check that uv is installed (`uv --version`) and that Python 3.11+ is on PATH. Tools always LIST without a token; a call that returns an access-required envelope means the email-code consent (remote) or SWARM_MCP_ACCESS_TOKEN (stdio) is missing.

VS Code

CLI setup

The /mcp page renders live deep links for this client from the install manifest.

If the client shows nothing: check that uv is installed (`uv --version`) and that Python 3.11+ is on PATH. Tools always LIST without a token; a call that returns an access-required envelope means the email-code consent (remote) or SWARM_MCP_ACCESS_TOKEN (stdio) is missing.

Claude Desktop

Config file: claude_desktop_config.json

{
  "mcpServers": {
    "swarm-data": {
      "command": "uvx",
      "args": [
        "--from",
        "quant-swarm==0.5.0",
        "swarm-data-mcp"
      ],
      "env": {
        "SWARM_MCP_ACCESS_TOKEN": "<token>"
      }
    },
    "swarm-warden": {
      "command": "uvx",
      "args": [
        "--from",
        "quant-swarm==0.5.0",
        "swarm-warden-mcp"
      ],
      "env": {
        "SWARM_MCP_ACCESS_TOKEN": "<token>"
      }
    },
    "swarm-gym": {
      "command": "uvx",
      "args": [
        "--from",
        "quant-swarm==0.5.0",
        "swarm-gym-mcp"
      ],
      "env": {
        "SWARM_MCP_ACCESS_TOKEN": "<token>"
      }
    }
  }
}

Path not taking effect? Claude Desktop config changes require a full restart of the app.

Codex / Gemini CLI

CLI setup

If the client shows nothing: check that uv is installed (`uv --version`) and that Python 3.11+ is on PATH. Tools always LIST without a token; a call that returns an access-required envelope means the email-code consent (remote) or SWARM_MCP_ACCESS_TOKEN (stdio) is missing.

Windsurf / Zed / Cline

Config file: mcp_config.json

{
  "mcpServers": {
    "swarm-data": {
      "command": "uvx",
      "args": [
        "--from",
        "quant-swarm==0.5.0",
        "swarm-data-mcp"
      ],
      "env": {
        "SWARM_MCP_ACCESS_TOKEN": "<token>"
      }
    },
    "swarm-warden": {
      "command": "uvx",
      "args": [
        "--from",
        "quant-swarm==0.5.0",
        "swarm-warden-mcp"
      ],
      "env": {
        "SWARM_MCP_ACCESS_TOKEN": "<token>"
      }
    },
    "swarm-gym": {
      "command": "uvx",
      "args": [
        "--from",
        "quant-swarm==0.5.0",
        "swarm-gym-mcp"
      ],
      "env": {
        "SWARM_MCP_ACCESS_TOKEN": "<token>"
      }
    }
  }
}

Path not taking effect? Claude Desktop config changes require a full restart of the app.

claude.ai / ChatGPT connectors

Web connector (OAuth)

data: https://1.21initiative.com/mcp/data

warden: https://1.21initiative.com/mcp/warden

gym: https://1.21initiative.com/mcp/gym

Consent page says "Unknown client"? The client must register (POST redirect URIs) first; that happens automatically in Connectors UIs. If the code email does not arrive, check spam, then retry after a minute (rate limit is 10 emails/hour).

Smithery

CLI setup

https://smithery.ai/server/io.github.blink1217/quant-swarm

Listing lives on Smithery; use it for one-click installs in editors that support the Smithery registry.