prediction-hunt-mcp 0.2.0

MCP server for querying Prediction Hunt — live prices, cross-platform matches, arbitrage, and +EV signals across Kalshi, Polymarket, PredictIt, ProphetX, and Opinion

Prediction Hunt MCP Server

Query prediction market data from Prediction Hunt directly in AI assistants like Claude, Cursor, and Claude Code.

Get prices, events, cross-platform matching, orderbooks, arbitrage, and +EV opportunities across Kalshi, Polymarket, PredictIt, ProphetX, and Opinion.

Setup

1. Get an API key

Sign up at predictionhunt.com/api/docs and generate a free API key.

2. Configure your MCP client

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "prediction-hunt": {
      "command": "uvx",
      "args": ["prediction-hunt-mcp"],
      "env": {
        "PREDICTION_HUNT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "prediction-hunt": {
      "command": "uvx",
      "args": ["prediction-hunt-mcp"],
      "env": {
        "PREDICTION_HUNT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

Add to .claude/settings.json:

{
  "mcpServers": {
    "prediction-hunt": {
      "command": "uvx",
      "args": ["prediction-hunt-mcp"],
      "env": {
        "PREDICTION_HUNT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Local development (from source)

{
  "mcpServers": {
    "prediction-hunt": {
      "command": "uvx",
      "args": ["--from", "/path/to/mcp-server", "prediction-hunt-mcp"],
      "env": {
        "PREDICTION_HUNT_API_KEY": "your-api-key-here"
      }
    }
  }
}

Available Tools

Tool	Description
search_events	Search events and markets by text query
list_events	Browse events with filters (type, tags, date)
list_markets	Browse individual markets with current prices
match_markets	Find the same market across platforms by query/slug/ticker
match_markets_by_url	Find cross-platform matches by pasting a market URL
match_sports_markets	Get matched sports markets for a given date
get_price_history	Historical OHLC candles for a market
get_bulk_prices	Current prices for up to 100 markets at once
get_orderbook	Live orderbook for a single market
get_unified_orderbook	Cross-platform combined orderbook
get_arbitrage_opportunities	Cross-platform arbitrage signals
get_positive_ev	Positive expected value opportunities
get_sector_analytics	Cross-platform volume / open interest / unique users — Polymarket vs Kalshi over time
get_smart_money_alerts	Smart-money alert feed — large/sharp/unusual trades
get_fade_finder_alerts	Fade-finder alert feed — trades worth fading
get_polymarket_market_price	Current or historical price for a Polymarket outcome token
get_polymarket_candlesticks_by_token	OHLCV candlesticks for a Polymarket outcome token
get_polymarket_candlesticks	Market-level OHLCV candlesticks, normalized to YES
get_polymarket_token_volume	Cumulative volume time series for a Polymarket token
get_polymarket_volume_chart	Per-period volume with YES/NO breakdown for a market
get_polymarket_open_interest	Current open interest by outcome for a market
get_polymarket_activity	A Polymarket wallet's trades, splits, merges, redeems
get_polymarket_leaderboard	Polymarket trader leaderboard by PnL or volume
get_trades	Unified per-trade feed across Polymarket and Kalshi
get_wallet_positions	A Polymarket wallet's open positions with normalized PnL
get_wallet_identity	A Polymarket wallet's handle, lifetime volume, and PnL
get_api_status	API health check (no key required)

Example Prompts

• "What NBA games have prediction markets today?"
• "Find arbitrage opportunities above 2% ROI"
• "Compare Bitcoin 100k prices across Kalshi and Polymarket"
• "Show me the orderbook for this Kalshi market: KXBTC-25APR04"
• "What are the best +EV bets right now?"

Environment Variables

Variable	Required	Default	Description
PREDICTION_HUNT_API_KEY	Yes (for most tools)	—	Your API key
PREDICTION_HUNT_API_URL	No	https://www.predictionhunt.com/api/v2	Custom API base URL

License

MIT