Polyrouter MCP

Model Context Protocol (MCP) server for Polyrouter - a unified API for prediction markets.

Query markets across Polymarket, Kalshi, Limitless, and Manifold through a single interface. Optionally trade on Kalshi and Polymarket.

Setup

1. Install Dependencies

bun install

2. Configure Environment

cp .env.example .env

Edit .env and add your Polyrouter API key:

POLYROUTER_API_KEY=your_api_key_here
POLYROUTER_BASE_URL=https://api-v2.polyrouter.io

# Optional: Trading credentials
KALSHI_API_KEY=
KALSHI_API_SECRET=        # RSA private key (single line with \n)
POLYMARKET_PRIVATE_KEY=   # Ethereum private key (0x...)

Get your Polyrouter API key from polyrouter.io.

3. Build & Run

bun run build
bun run start

Or for development:

bun run dev

Related MCP server: Polymarket MCP Server

Claude Code Integration

Add to ~/.claude.json:

{
  "mcpServers": {
    "polyrouter": {
      "command": "bun",
      "args": ["/path/to/polyrouter-mcp/dist/index.js"]
    }
  }
}

Available Tools

Market Data

• health_check - API health status

• get_api_info - API information

• list_markets - List/search markets

• get_market - Get market details

• get_orderbook - Real-time orderbook

• search_markets - Search across platforms

• list_platforms - Available platforms

Events & Series

• list_events / get_event - Event data

• list_series / get_series - Series data

Sports

• list_games / get_game - Sports games

• list_awards / get_award - Award markets (MVP, etc.)

• list_futures / get_future - Championship futures

• get_league_info - League metadata

Historical Data

• get_trades - Trade history

• get_historical_orderbook - Orderbook snapshots

• get_price_history - OHLC price data

User Data

• get_user_profile - User profile & metrics

• get_user_trades - User trade history

Trading (Optional)

Requires Kalshi or Polymarket credentials in .env:

• preview_order / confirm_order - Two-step order placement

• cancel_order / cancel_all_orders - Cancel orders

• get_orders / amend_order - Manage orders

• get_balance - Account balance

• get_positions - Current positions

• get_fills - Fill history

Troubleshooting

API Key Not Set

Error: POLYROUTER_API_KEY environment variable not set

Make sure .env exists with your API key.

Server Won't Start

bun install
bun run type-check

License

MIT