trading-swarm-mcp — the checkers that gate live capital, as MCP servers

The pre-trade invariants and data assembly that guard live capital in the 1.21 Initiative trading swarm, packaged as Model Context Protocol (MCP) servers you can run locally — in Cursor, Claude Desktop, or Claude Code — against your own strategies.

No provider credentials. No DRM. No order-placement code path. And no unlimited plans: capacity is bounded by what you pay for, on purpose.

What it does

Three servers, extracted from the same code that gates real money every market day:

• Warden — validate a proposed order against the house floors (25% position cap, 60% gross), audit a feature manifest for lookahead leakage, convert a gross edge into net-of-cost reality, explain the live C# risk engine's sizing math step by step, and validate a genome against the bounded schema.
• Data — derived-only market analytics (trend/volatility/oscillator/volume percentile ranks + causal regime labels), point-in-time feature vectors with provenance guards, order-flow imbalance / VPIN toxicity / effective-spread snapshots, volume forecasts expressed as ratios (never raw counts), and cross-sectional ranking.
• Gym — label causal regimes, replay a genome on a capped episode-seed matrix and surface per-regime fragility, and estimate the hosted tournament run. Promotions are never issued locally — undecidable outputs name the exact missing inputs and hand off server-side.

The data policy that makes this trustworthy

• Derived-only. Responses contain ratios, percentile ranks, labels, buckets, and counts. Raw open/high/low/close/volume, provider quote values, and headline text are never echoed back. Tools accept optional caller-supplied bars for symbols the shared cache doesn't carry.
• Runs on your machine. Your orders, features, and genomes never leave it. No tool can place, cancel, or route an order — there is no order-placement code path.
• No provider credentials. Data flows through the hosted relay under your token; you never need an Alpaca or Finnhub key.

Plans & billing

Pro is credit-based by design — you buy a fixed pool of calls, use them at your own pace, and buy again when you need more. There is no subscription and no unlimited plan; the credit pool on your token is the only capacity you can consume. Credits are metered per call, expire 90 days after purchase, and stack — buying again extends your window.

Quickstart

Get a free token at https://1.21initiative.com/mcp/ (instant), then add the servers to your client:

{
  "mcpServers": {
    "swarm-data":   { "command": "uvx", "args": ["--from", "trading-swarm-mcp", "swarm-data-mcp"],   "env": { "SWARM_MCP_ACCESS_TOKEN": "" } },
    "swarm-warden": { "command": "uvx", "args": ["--from", "trading-swarm-mcp", "swarm-warden-mcp"], "env": { "SWARM_MCP_ACCESS_TOKEN": "" } },
    "swarm-gym":    { "command": "uvx", "args": ["--from", "trading-swarm-mcp", "swarm-gym-mcp"],    "env": { "SWARM_MCP_ACCESS_TOKEN": "" } }
  }
}