prediction-hunt-mcp 0.1.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_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