Skip to main content

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

Metadata

Release files for prediction-hunt-mcp 0.2.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for prediction-hunt-mcp 0.2.0
File Size Uploaded Provenance Actions
prediction_hunt_mcp-0.2.0.tar.gz 11.5 kB With provenance Details for prediction_hunt_mcp-0.2.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for prediction-hunt-mcp 0.2.0
File Interpreter ABI Platform Actions
prediction_hunt_mcp-0.2.0-py3-none-any.whl Python 3 none any Details for prediction_hunt_mcp-0.2.0-py3-none-any.whl

Total release size: 25.4 kB

Release files / prediction_hunt_mcp-0.2.0.tar.gz

Download URL prediction_hunt_mcp-0.2.0.tar.gz
Size 11.5 kB
Tags Source
SHA-256 checksum
How to use checksums
80541e38c6e12b806ea48128d0fac3bb7e91c6ce1477164d297c2b33219075b1
BLAKE2b-256 checksum
How to use checksums
633e2abcd36c7e62d87b5067b85a6847b64c32781fa30410bcfc82d3640bd114
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 22, 2026.

Transparency log

Release files / prediction_hunt_mcp-0.2.0-py3-none-any.whl

Download URL prediction_hunt_mcp-0.2.0-py3-none-any.whl
Size 13.9 kB
Tags Python 3
SHA-256 checksum
How to use checksums
6cc0883ac1355da311a8929706d0e348a12994a378b07746e94741ef0a2b3a85
BLAKE2b-256 checksum
How to use checksums
cdff489746c98a13380cdd804302fa01882f6a41e0b4952c0ec5a23e385547c8
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
Yes
Uploaded via twine/6.1.0 CPython/3.13.12

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 22, 2026.

Transparency log

Security for prediction-hunt-mcp 0.2.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

Full provenance

All 2 files in this release have been uploaded with provenance metadata.

Select from 2 files

Attestation for prediction_hunt_mcp-0.2.0.tar.gz

PyPI Publish Attestation

PyPI verified that this artifact, at this checksum, originated from the publisher listed below.

Signed by GitHub Actions, verified by PyPI on May 22, 2026.

Transparency log

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.2.0 This release

2 release files Full provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page