Back

Stock Predictions MCP

Coming Soon — Stock prediction MCP tools are under development. The tool specifications below are the target API. Connect to the main EventTrader MCP endpoint for currently available tools.

The Model Context Protocol (MCP) server will expose 3,700+ stock prediction markets to LLM clients (Claude Desktop, Claude Code, MCP-compatible agents). Ask your AI assistant which stocks are beating the S&P 500, read orderbooks, and place trades — all through natural language.

REST & WebSocket Python SDK MCP Tools All Stock Markets

Server Endpoint

https://cymetica.com/mcp/v1

EventTrader exposes a single MCP surface — the same endpoint serves arena, exchange, TGE-launch, and stock prediction markets. The tools below filter to stock prediction markets when called.

Discovery: GET /.well-known/mcp.json · Tools: GET /mcp/v1/tools · Register: POST /mcp/v1/register

For Claude Desktop, add to claude_desktop_config.json:

{
  "mcpServers": {
    "eventtrader": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://cymetica.com/mcp/v1"]
    }
  }
}

Tools

Tool	Args	Description
`list_stock_markets`	`sector?`	Return all stock prediction markets, optionally filtered by sector (Materials, Technology, Energy, etc.).
`get_market`	`market_id`	Full detail for a single market including assets, epoch, pool size.
`get_orderbook`	`market_id, symbol`	Return CLOB orderbook depth + best bid/ask for a stock ticker.
`get_trades`	`market_id, symbol, limit`	Recent fills (chart + Time & Sales source of truth).
`place_order`	`market_id, symbol, side, price, size`	Place a limit order. Requires authenticated MCP session.
`cancel_order`	`market_id, order_id, symbol`	Cancel a resting order.
`place_bet`	`market_id, symbol, amount, user_address`	Bet into the parimutuel pool. Requires authenticated MCP session.

Authentication

Read tools work unauthenticated. Trade tools require an EventTrader API key passed as Authorization: Bearer <key> in the MCP transport headers, or via the OAuth flow surfaced by your MCP client.

Example LLM Prompts

"List all materials stocks with active prediction markets."
"What's the spread on the AAPL vs SPY orderbook?"
"Buy 10 shares of AAPL-beats-SPY at $0.55."
"Show me which tech stocks have the biggest pools right now."
"What were the last 10 trades on the TSLA market?"

Tool Reference

list_stock_markets

{
  "name": "list_stock_markets",
  "description": "List all active stock prediction markets (stock vs S&P 500).",
  "inputSchema": {"type":"object","properties":{
    "sector":{"type":"string","description":"Filter by sector (Materials, Technology, Energy, Financials, etc.)"}
  }}
}

get_orderbook

{
  "name": "get_orderbook",
  "inputSchema": {"type":"object","required":["market_id","symbol"],"properties":{
    "market_id":{"type":"string"},
    "symbol":{"type":"string","description":"Stock ticker (e.g. AAPL, TSLA)"}
  }}
}

place_order

{
  "name": "place_order",
  "inputSchema": {"type":"object","required":["market_id","symbol","side","price","size"],"properties":{
    "market_id":{"type":"string"},
    "symbol":{"type":"string","description":"Stock ticker"},
    "side":{"type":"string","enum":["buy","sell"]},
    "price":{"type":"number","minimum":0.01,"maximum":0.99},
    "size":{"type":"number","exclusiveMinimum":0}
  }}
}

place_bet

{
  "name": "place_bet",
  "description": "Place a parimutuel bet into the prediction pool for a stock vs S&P 500.",
  "inputSchema": {"type":"object","required":["market_id","symbol","amount","user_address"],"properties":{
    "market_id":{"type":"string"},
    "symbol":{"type":"string","description":"Stock ticker (e.g. AAPL)"},
    "amount":{"type":"number","exclusiveMinimum":0,"description":"Bet amount in USDC"},
    "user_address":{"type":"string","description":"User wallet address"}
  }}
}

Limits

MCP tool calls share the same rate limits as the underlying REST endpoints — 200 reads/min, 60 trades/min per account.

EventTrader