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 install2. Configure Environment
cp .env.example .envEdit .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 startOr for development:
bun run devClaude 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 statusget_api_info- API informationlist_markets- List/search marketsget_market- Get market detailsget_orderbook- Real-time orderbooksearch_markets- Search across platformslist_platforms- Available platforms
Events & Series
list_events/get_event- Event datalist_series/get_series- Series data
Sports
list_games/get_game- Sports gameslist_awards/get_award- Award markets (MVP, etc.)list_futures/get_future- Championship futuresget_league_info- League metadata
Historical Data
get_trades- Trade historyget_historical_orderbook- Orderbook snapshotsget_price_history- OHLC price data
User Data
get_user_profile- User profile & metricsget_user_trades- User trade history
Trading (Optional)
Requires Kalshi or Polymarket credentials in .env:
preview_order/confirm_order- Two-step order placementcancel_order/cancel_all_orders- Cancel ordersget_orders/amend_order- Manage ordersget_balance- Account balanceget_positions- Current positionsget_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 ``bash bun install bun run type-check ``
License
MIT
