INITIATIVE / live capital systems
Get a free token
Reference

MCP documentation

What this is

trading-swarm-mcp exposes three MCP servers derived from the trading swarm: swarm-data-mcp (point-in-time data assembly, derived market/sentiment snapshots), swarm-warden-mcp (pre-trade invariant and leakage auditing), and swarm-gym-mcp (regime-fragility probing). No tool places, cancels, or routes orders, and no tool accepts provider credentials.

Authentication

Get a token at /mcp/ (free, instant). Set it in each server's environment:

SWARM_MCP_ACCESS_TOKEN=121_xxxxxxxx

Hosted endpoints accept it as a Bearer credential over streamable HTTP.

Plans & quotas

  • Free: ~250 relay data calls/month, 10 symbols/call, 365-day backfill window. All warden checkers plus derived market/sentiment snapshots, cache stats, and offline mode.
  • Credit packs (Pro): one-time packs — 10,000 calls (£19) or 100,000 calls (£149), valid 90 days from purchase, no subscription and no auto-renewal. Unlocks the full tool catalog, 50 symbols/call, and the full backfill window.
  • Burst limit: 60 relay calls per 60 seconds per token, durable across instances.

Tool catalog

ServerFreePro
swarm-warden-mcpwarden.validate_order · warden.cost_check · warden.explain_sizing · warden.validate_genome · warden.audit_featureswarden.promotion_verdict
swarm-data-mcpmarket.pulse · market.sentiment · market.regime · cache.stats · cache.offlinefeatures.build · cache.warm · market.microstructure · volume.forecast · market.screen · market.rank
swarm-gym-mcp—gym.label_regimes · gym.probe_fragility · gym.paired_preview · gym.estimate_cloud_run

Every response is derived-only: ratios, percentile ranks, labels, buckets, and counts. Raw provider values are never echoed. Tools accept optional caller-supplied bars for symbols the shared cache does not carry.

Error codes

  • 401 — token rejected, revoked, or missing.
  • 402 — plan/quota refusal with a structured body (reason: quota_exceeded | credits_exhausted | credits_expired | plan_required) and an upgrade_url. Pro tools on free tokens return UPGRADE_REQUIRED envelopes on stdio.
  • 429 — burst limit (60 calls/60s).
  • 5xx — service unavailable; provider details are never leaked to clients.

Install

uvx --from trading-swarm-mcp swarm-data-mcp
uvx --from trading-swarm-mcp swarm-warden-mcp
uvx --from trading-swarm-mcp swarm-gym-mcp

Hosted endpoints: https://swarm-mcp-503318750546.europe-west1.run.app/mcp/data · /mcp/warden · /mcp/gym. Source: github.com/blink1217/trading-swarm-mcp. Not investment advice — see Terms.