Skip to content

Prediction Markets MCP

Prediction Markets MCP Server

CI codecov License: MIT

An MCP server providing unified access to prediction market data from Kalshi and Polymarket.

Why Use This?

Prediction markets aggregate crowd wisdom into real-time probabilities. This MCP server lets you:

  • Unify platforms — Query Kalshi and Polymarket through one interface
  • Use natural language — Ask "What are the odds?" instead of parsing JSON APIs
  • Get real-time data — Access prices, orderbooks, and trade history instantly
  • Search efficiently — Full-text search across thousands of markets in <1ms

Instead of manually browsing market websites or writing API integration code, ask your AI assistant directly.

Quick Start

Add to your MCP client configuration (e.g., ~/.claude.json for Claude Code):

{
  "mcpServers": {
    "prediction-markets": {
      "command": "npx",
      "args": ["-y", "prediction-mcp"],
      "env": {
        "KALSHI_API_KEY": "your-api-key",
        "KALSHI_PRIVATE_KEY_PATH": "/path/to/key.pem"
      }
    }
  }
}

Note: Polymarket works without credentials. Kalshi credentials are optional.

Restart your MCP client to load the server.

What Can You Ask?

Once connected, try these natural language queries:

Market Discovery

  • "What are the current odds on Polymarket for the next Fed rate decision?"
  • "Show me all open Kalshi markets about the 2024 election"
  • "What are the top trending markets on Polymarket right now?"
  • "Find Polymarket events tagged with Politics"

Price & Orderbook Analysis

  • "Show me the orderbook for the next Fed rate decision on Kalshi"
  • "What's the current price for 'Yes' on this Polymarket market?"
  • "Show me the price history for this market over the last week"

Search & Research

  • "Search Kalshi for markets about climate change"
  • "Find all markets related to the Federal Reserve"
  • "What prediction markets exist for tech company earnings?"

See Tools Reference for the complete list of available operations.

Platforms

Kalshi

US-regulated prediction exchange with event contracts on politics, economics, weather, and more.

Polymarket

Decentralized prediction market on Polygon with deep liquidity on major events.

  • No auth required: All read operations are public

Tools

Kalshi

Tool Description Auth
kalshi_list_markets List available markets on Kalshi —
kalshi_get_market Get detailed information about a specific Kalshi market i... —
kalshi_get_orderbook Get the current orderbook for a Kalshi market —
kalshi_get_trades Get recent trade history for Kalshi markets —
kalshi_get_series Get series metadata including title for URL construction —
kalshi_get_event Get event metadata including title for URL construction —
kalshi_search Search across Kalshi events and markets using keyword mat... —
kalshi_search_events Search Kalshi events by keyword —
kalshi_search_markets Search Kalshi markets by keyword —
kalshi_cache_stats Get search cache statistics including event/market counts... —
kalshi_get_price_history Get historical candlestick (OHLCV) data for a Kalshi market —
kalshi_get_balance Get your Kalshi account balance and portfolio value Required
kalshi_get_positions Get your open positions on Kalshi markets Required

Polymarket

Tool Description Auth
polymarket_list_markets List available markets on Polymarket —
polymarket_get_market Get detailed information about a specific Polymarket mark... —
polymarket_list_events List events on Polymarket —
polymarket_get_event Get detailed event information by slug —
polymarket_list_tags List available category tags on Polymarket —
polymarket_get_orderbook Get the current orderbook for a Polymarket outcome token —
polymarket_get_price Get the current best price for a Polymarket outcome token —
polymarket_get_price_history Get historical price data for a Polymarket outcome token —
polymarket_search Search across Polymarket events and markets using keyword... —
polymarket_search_events Search Polymarket events by keyword —
polymarket_search_markets Search Polymarket markets by keyword —
polymarket_cache_stats Get Polymarket search cache statistics including event/ma... —

See Tools Reference for full parameter documentation.