MCP Server
Query Prediction Hunt data natively in Claude, Cursor, and other AI assistants via the Model Context Protocol. Ask about live odds, cross-platform matches, arbitrage, and +EV opportunities in plain English — no glue code required.
MCP calls share your API key and count against your existing plan's rate limit. Free tier users get read-only market data; arbitrage and +EV tools require a Dev or Pro plan.
What is MCP?
The Model Context Protocol is an open standard that lets AI assistants connect to external data sources through a consistent tool interface. Instead of writing API clients, you install an MCP server once and your assistant gains the ability to answer questions like:
- “What's the current price of Bitcoin hitting 100k on Polymarket and Kalshi?”
- “Find me all +EV opportunities across prediction markets right now”
- “Show me live arbitrage between Polymarket and Kalshi for the 2028 election”
- “What's the orderbook depth on the next Fed rate decision market?”
- “Pull the 1-hour candle history for the Super Bowl champion market”
- “Which NBA games tonight have matched markets on Kalshi and Polymarket?”
Installation
Prerequisite: install uv (one-time setup)
The MCP server ships as a Python package and runs via uv, Astral's Python package runner. If you don't have it yet, install it first — every config snippet below assumes uv is on your PATH.
brew install uv
curl -LsSf https://astral.sh/uv/install.sh | sh
With uv installed, the MCP server runs with a single command — no clone, no virtualenv, no pip install. The MCP clients below all launch it for you automatically; this is only for a one-off sanity check:
uvx prediction-hunt-mcp
If the command prints nothing and waits (instead of erroring), the server started successfully. Hit Ctrl+C to exit.
Configuration
Pick your client and drop the snippet into its MCP config. Replace your-api-key-here with a real key from /api/docs.
Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows), then restart Claude Desktop.
{
"mcpServers": {
"prediction-hunt": {
"command": "uvx",
"args": ["prediction-hunt-mcp"],
"env": {
"PREDICTION_HUNT_API_KEY": "your-api-key-here"
}
}
}
}To verify the server starts correctly, run uvx prediction-hunt-mcp in your terminal. Your client handles this automatically after configuration.
Available Tools
27 tools spanning the full v2 API surface. Each tool is a thin wrapper around the equivalent HTTP endpoint, so rate limits, authentication, and response shapes match the REST API exactly.
Core Resources
list_eventsBrowse events with matched market groups across platforms.search_eventsFree-text search across events and markets.list_marketsBrowse individual markets with current prices, filtered by platform/category/status.Cross-Platform Matching
match_marketsFind the same market across platforms via query, Polymarket key, or Kalshi ticker.match_markets_by_urlPaste a market URL from any supported platform — auto-detects and finds matches.match_sports_marketsGame-level matched markets for NBA, NFL, NHL, MLB, CFB, CBB, EPL, UCL and more.Prices & Orderbook
get_bulk_pricesCurrent prices for up to 100 markets at once.get_price_historyOHLC candle data with 1m / 5m / 15m / 1h / 1d intervals.get_orderbookLive bid/ask ladder for a single market on Polymarket, Kalshi, or Opinion.get_unified_orderbookCross-platform combined orderbook merged at the match-group level.Analytics
get_arbitrage_opportunitiesLive cross-platform arbitrage with configurable min ROI. Requires a paid tier.get_positive_evLive +EV opportunities with configurable ROI and side filters. Requires a paid tier.get_sector_analyticsPolymarket vs Kalshi volume, open interest, and unique users over time (daily). No API key required.Alerts
get_smart_money_alertsLarge, sharp, or unusual trades flagged in real time — see where informed money is moving.get_fade_finder_alertsTrades worth considering fading, surfaced for contrarian strategies.Polymarket
get_polymarket_market_priceCurrent or historical price for a single Polymarket outcome token.get_polymarket_candlesticks_by_tokenOHLCV candlesticks for a raw Polymarket outcome token.get_polymarket_candlesticksMarket-level OHLCV candlesticks normalized to the YES side.get_polymarket_token_volumeCumulative trading-volume time series for a Polymarket token.get_polymarket_volume_chartPer-period trading volume with a YES/NO breakdown for a market.get_polymarket_open_interestCurrent open interest broken down by outcome for a market.get_polymarket_activityA wallet's trades, splits, merges, redeems, conversions, and rewards.get_polymarket_leaderboardTrader leaderboard ranked by PnL or volume, with category and period filters.Trades
get_tradesUnified per-trade feed across Polymarket and Kalshi with keyset pagination.Wallets
get_wallet_positionsA Polymarket wallet's open positions with normalized realized/unrealized PnL.get_wallet_identityA Polymarket wallet's handle, lifetime volume, and lifetime PnL.System
get_api_statusHealth check per platform. The only tool that works without an API key.Authentication
The MCP server reads your API key from the PREDICTION_HUNT_API_KEY environment variable, set via the env block in the config snippets above. The server forwards the key to the v2 API on every tool call as an X-API-Key header, so rate limits and tier restrictions apply exactly as they do for direct HTTP usage.
Don't have a key yet? Grab a free one on the API docs page — it takes about a minute.