Quant Swarm MCP · Client Setup

Connect Your AI Agent in 2 Minutes: 3 Simple Steps.

Whether you use Claude Code, Cursor, VS Code, or Claude Desktop, you can connect via Zero-Install Hosted HTTP (OAuth 2.1 browser consent, nothing to install) or Local uvx stdio (runs on your CPU so raw backtest arrays never leave your laptop).

Step 3A · Access Token

1. Claim Your Free Token (+100 Bonus Pro Credits)

Generate your free SWARM_MCP_ACCESS_TOKEN in 10 seconds at /mcp/#signup. Every new token includes 250 free monthly relay calls, unlimited local warden.* and audit.* checks, plus 100 bonus Pro trial credits so you can immediately test pit.analysis, gym.prop_challenge_sim, and gym.probe_fragility with no credit card required.

Step 3B · Client Configuration

2. Add the 3 Servers to Your AI Client

Select your client below and copy the one-line command or JSON block.

Point your client at the streamable-HTTP endpoint and send your token as Authorization: Bearer. Set SWARM_MCP_ACCESS_TOKEN in your environment first. Repeat with the data and gym endpoints as needed.

Hosted MCP endpoints
Server	Tools	Streamable-HTTP endpoint
`swarm-data-mcp`	19	`https://swarm-mcp-503318750546.europe-west1.run.app/mcp/data`
`swarm-warden-mcp`	16	`https://swarm-mcp-503318750546.europe-west1.run.app/mcp/warden`
`swarm-gym-mcp`	11	`https://swarm-mcp-503318750546.europe-west1.run.app/mcp/gym`

Last verified 2026-10-31.

Claude Code

Setup documented · end-to-end check pending Last tested: not yet recorded

claude mcp add --transport http swarm-warden https://swarm-mcp-503318750546.europe-west1.run.app/mcp/warden --header "Authorization: Bearer $SWARM_MCP_ACCESS_TOKEN"

Config: Project or user scope, managed with the claude mcp command
Reload: Run /mcp inside Claude Code to confirm the server is connected.

Cursor

Setup documented · end-to-end check pending Last tested: not yet recorded

{
  "mcpServers": {
    "swarm-warden": {
      "url": "https://swarm-mcp-503318750546.europe-west1.run.app/mcp/warden",
      "headers": {
        "Authorization": "Bearer ${env:SWARM_MCP_ACCESS_TOKEN}"
      }
    }
  }
}

Config: ~/.cursor/mcp.json (or .cursor/mcp.json in a project)
Reload: Reload the window, then enable the server under Settings, MCP.

Requires uv and Python 3.11 or later. The version is pinned so your client starts exactly quant-swarm==0.7.0. Replace swarm-warden-mcp with swarm-data-mcp or swarm-gym-mcp for the other servers.

Claude Code

Setup documented · end-to-end check pending Last tested: not yet recorded

claude mcp add swarm-warden --env SWARM_MCP_ACCESS_TOKEN=<your token> -- uvx --from quant-swarm==0.7.0 swarm-warden-mcp

Config: Project or user scope, managed with the claude mcp command
Reload: Run /mcp inside Claude Code to confirm the server is connected.

Cursor

Setup documented · end-to-end check pending Last tested: not yet recorded

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

Config: ~/.cursor/mcp.json (or .cursor/mcp.json in a project)
Reload: Reload the window, then enable the server under Settings, MCP.

VS Code

Setup documented · end-to-end check pending Last tested: not yet recorded

{
  "servers": {
    "swarm-warden": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "--from",
        "quant-swarm==0.7.0",
        "swarm-warden-mcp"
      ],
      "env": {
        "SWARM_MCP_ACCESS_TOKEN": "<your token>"
      }
    }
  }
}

Config: .vscode/mcp.json
Reload: Use MCP: List Servers, then start the server.

Claude Desktop

Setup documented · end-to-end check pending Last tested: not yet recorded

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

Config: claude_desktop_config.json (Settings, Developer, Edit Config)
Reload: Quit and reopen Claude Desktop.

Step 3C · First Verification Call

3. Paste Your First Verification Prompt

Once connected, paste any of these starter prompts into your agent to verify your setup end-to-end:

"Use pit.analysis on NVDA as of today and explain which alternative-data signals pass the Benjamini-Hochberg q ≤ 0.05 gate vs which are noise."

Tests swarm-data-mcp · Free tier (1 symbol lite)

"Run warden.prop_challenge_check on a $100,000 TwoStep account at $105,800 equity before I risk 1.2% on NVDA, and verify whether 0.55x Target-Lock Taper applies."

Tests swarm-warden-mcp · Free tier (0 credits)

"Call audit.symbolic_check on 'rank(ts_delta(close, 21) / ts_std(ret_1d, 21))' and check for lookahead, AST complexity, or magic-constant overfitting."

Tests swarm-warden-mcp · Free tier (0 credits)

Claim Free Token (+100 Pro Credits) → Next: Step 4 — Prop-Firm Survival Suite Troubleshooting & All 6 Clients