Skip to main content
— Section / Developers

MCP Server.

Model Context Protocol server. Plug Evens directly into Claude, Cursor, and other AI clients.

Predictions API Webhooks MCP

Developer Documentation

Predictions MCP Server

Connect AI agents to Evens prediction data using the Model Context Protocol. Search events and markets, get prices, explore sports and competitions — all through any MCP-compatible client like Claude Code, Claude Desktop, or Cursor.

Overview

The Evens Predictions MCP server gives AI agents read-only access to prediction market data aggregated from Kalshi, Polymarket, Smarkets, and BetRivers. It mirrors the capabilities of the REST API but speaks the Model Context Protocol — so any MCP-compatible AI client can search events, browse markets, get prices, and explore provider data with natural language.

The MCP server connects via HTTP + SSE (Server-Sent Events) and requires an API key with an active Premium subscription.

Connect

Sign in to get your API key

API access requires a Premium subscription. Sign in or create an account to get started.

Sign in Sign up

Authentication

All connections require an X-API-Key header with a valid API key. Premium subscription required.

  • 401 — Missing or invalid API key
  • 403 — Premium subscription required
  • 429 — Rate limit exceeded

Claude Desktop

Open Settings → Developer → Edit Config and add to claude_desktop_config.json:

claude_desktop_config.json
{
  "mcpServers": {
    "evens-predictions": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://evens.com/mcp/sse",
        "--header",
        "X-API-Key: YOUR_API_KEY"
      ]
    }
  }
}

Requires Node.js installed. The mcp-remote package bridges HTTP/SSE servers to Claude Desktop's stdio transport.

Claude Code

Run this command in your terminal to add the Evens MCP server:

Terminal
claude mcp add evens-predictions \
  --transport sse \
  --header "X-API-Key: YOUR_API_KEY" \
  https://evens.com/mcp/sse

Claude Code natively supports SSE transport. The server will be available in all your conversations.

Cursor

Open Settings → MCP and add a new server, or add to your project's .cursor/mcp.json:

.cursor/mcp.json
{
  "mcpServers": {
    "evens-predictions": {
      "url": "https://evens.com/mcp/sse",
      "headers": {
        "X-API-Key": "YOUR_API_KEY"
      }
    }
  }
}

Other MCP clients

Any MCP client that supports HTTP + SSE transport can connect. Point your client to the SSE endpoint and include your API key:

SSE endpoint + auth
URL:    https://evens.com/mcp/sse
Header: X-API-Key: YOUR_API_KEY

For clients that only support stdio, use npx mcp-remote https://evens.com/mcp/sse --header "X-API-Key: YOUR_API_KEY" as the command to bridge to HTTP/SSE.

Tools

All tools are read-only — they mirror the REST API capabilities. Search and browse prediction market data aggregated from Kalshi, Polymarket, Smarkets, and BetRivers.

Tool Description Key Args
search_events Search canonical events with filters query, sport, competition, status, start_after, start_before, limit
show_event Get full event details with all its markets id
search_markets Search canonical markets with filters query, market_type, status, event_id, sport, provider, limit
show_market Get full market details with provider references and current prices id
get_market_prices Get price history for a market with time-series snapshots id, provider, interval, start_time, end_time, limit
list_sports List all available sports —
list_competitions List competitions, filterable by sport sport, type
list_providers List prediction market providers with counts —

Examples

Once connected, just ask your AI agent naturally. Here are some example prompts:

Explore prediction markets

Agent prompt
# Search for events
"Find upcoming NBA events"
"Show me soccer events starting this week"

# Browse markets
"Search for markets about bitcoin"
"What player prop markets are available for basketball?"

# Get details
"Show me event 42 with all its markets"
"Show market 128 with current prices from each provider"

Compare prices across providers

Agent prompt
# Check provider coverage
"Which providers are available and how many markets do they have?"

# Compare prices
"Show me market 128 — which provider has the best yes price?"

# Historical prices
"Get hourly price history for market 128 over the last 24 hours"
"Compare daily prices from Kalshi vs Polymarket for market 128"

Browse sports and competitions

Agent prompt
# Discover what's available
"List all sports"
"Show me competitions for basketball"

# Filter by sport
"Find all open futures markets for soccer"
"What events are coming up in the NBA?"