@the-situation/mcp

MCP servers for The Situation stack.

Binaries

• situation-indexer-mcp
  • Read-only indexer tools (indexer_*).
  • Uses SITUATION_INDEXER_URL (default https://situation-indexer.fly.dev).
• situation-market-read-mcp
  • Read-only on-chain market tools (market_read_*) via @the-situation/sdk.
  • Uses SITUATION_NODE_URL (default https://api.cartridge.gg/x/starknet/sepolia).
• situation-trade-mcp
  • Trade planning and guarded execution tools (trade_*).
  • Writes are gated and disabled by default.

All servers return compact summaries and persist full payloads in sqlite cache.

Cache

All tools cache full payloads in sqlite and return cache metadata in responses.

• Env: SITUATION_MCP_CACHE_DB (default /data/workspace/state/superforecast/mcp_cache.db, falls back to ./.state/superforecast/mcp_cache.db when /data is not writable)
• Per-server cache tools:
  • indexer_cache_list, indexer_cache_get
  • market_read_cache_list, market_read_cache_get
  • trade_cache_list, trade_cache_get

Trade Policy Gates

Trade execution (trade_execute_guarded) requires all gates to pass:

• SITUATION_MCP_ENABLE_TRADING=true
• Matching confirmationPhrase argument (default phrase from SITUATION_MCP_TRADE_CONFIRM_PHRASE, default EXECUTE_TRADE)
• If configured, market must be in SITUATION_MCP_TRADE_ALLOWED_MARKETS
• If configured, projected collateral must be <= SITUATION_MCP_MAX_COLLATERAL
• SITUATION_ACCOUNT_ADDRESS and SITUATION_PRIVATE_KEY must be present
• Confirmation mismatch errors do not echo the configured phrase value

Local Run

cd the-situation-sdk
bun run --filter '@the-situation/mcp' build

# Run one server on stdio
bun run --filter '@the-situation/mcp' start:indexer

# Or run the others
bun run --filter '@the-situation/mcp' start:market-read
bun run --filter '@the-situation/mcp' start:trade