prediction-click-mcp-server

MCP server for prediction.click — real-time crypto fair value and Polymarket Up/Down market data.

This server gives AI agents access to mathematically derived fair values for Polymarket's short-term crypto markets (BTC, ETH, SOL, XRP, DOGE, BNB), enabling them to identify mispricings and execute trades.

Quick Start

Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "prediction-click": {
      "command": "npx",
      "args": ["-y", "prediction-click-mcp-server"]
    }
  }
}

Claude Code

claude mcp add prediction-click -- npx -y prediction-click-mcp-server

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "prediction-click": {
      "command": "npx",
      "args": ["-y", "prediction-click-mcp-server"]
    }
  }
}

Custom Base URL

By default the server connects to https://prediction.click. To use a different instance:

{
  "mcpServers": {
    "prediction-click": {
      "command": "npx",
      "args": ["-y", "prediction-click-mcp-server"],
      "env": {
        "PREDICTION_CLICK_URL": "http://localhost:3000"
      }
    }
  }
}

Tools

scan_opportunities

Scan all 24 markets (6 assets x 4 timeframes) and return the most profitable trading opportunities ranked by edge. This is the best starting point for finding trades.

Parameters: none

Example response:

{
  "scanned_at": "2026-03-20T12:00:00.000Z",
  "total_opportunities": 5,
  "opportunities": [
    { "asset": "BTC", "timeframe": "5m", "side": "UP", "edge": 4.21, "fair_value": 53.21, "market_price": 49.00 },
    { "asset": "ETH", "timeframe": "1h", "side": "DOWN", "edge": 2.85, "fair_value": 51.85, "market_price": 49.00 }
  ]
}

get_markets

Get a full grid of all market data — fair values and market prices for every asset and timeframe.

Parameters: none

get_fair_value

Get detailed fair value for a specific asset and timeframe, including model parameters, volatility, and Polymarket token IDs for trading.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | asset | BTC\|ETH\|SOL\|XRP\|DOGE\|BNB | Yes | Crypto asset | | timeframe | 5m\|15m\|1h\|4h | Yes | Market timeframe |

get_spot_price

Get the current real-time spot price from Binance, plus recent 1-minute candles (~8 hours of history).

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | asset | BTC\|ETH\|SOL\|XRP\|DOGE\|BNB | Yes | Crypto asset |

get_orderbook

Get the Polymarket CLOB orderbook (bids and asks) for a specific market.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | asset | BTC\|ETH\|SOL\|XRP\|DOGE\|BNB | Yes | Crypto asset | | timeframe | 5m\|15m\|1h\|4h | Yes | Market timeframe | | side | yes\|no | No (default: yes) | yes = UP token, no = DOWN token |

get_opportunity

Find profitable fills for a specific market by walking the orderbook. Returns fills where market price is below fair value (positive edge), with expected profit after Polymarket fees.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | asset | BTC\|ETH\|SOL\|XRP\|DOGE\|BNB | Yes | Crypto asset | | timeframe | 5m\|15m\|1h\|4h | Yes | Market timeframe |

get_history

Get historical fair value and market price data (1-second granularity). Useful for analyzing how fair value and market price have diverged over time.

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | asset | BTC\|ETH\|SOL\|XRP\|DOGE\|BNB | Yes | Crypto asset | | timeframe | 5m\|15m\|1h\|4h | Yes | Market timeframe |

get_health

Check the health status of all prediction.click backend services.

Parameters: none

Concepts

What is prediction.click?

prediction.click computes fair values for Polymarket's short-term crypto Up/Down markets using a Student-t pricing model with EWMA volatility. The edge is the gap between the mathematically derived fair value and the current market price on Polymarket.

Assets & Timeframes

• Assets: BTC, ETH, SOL, XRP, DOGE, BNB
• Timeframes: 5m, 15m, 1h, 4h

Each combination (e.g., BTC/5m) is a separate Polymarket market with UP and DOWN tokens.

Edge

Edge = Fair Value - Market Price. A positive edge means the market is underpriced relative to the model, suggesting a buying opportunity.

Typical Agent Workflow

1. Call scan_opportunities to find the best edges across all markets
2. For promising opportunities, call get_opportunity to see exact fills and expected profit
3. Use get_orderbook to check liquidity before placing orders
4. Use get_fair_value for real-time model details and token IDs needed for trading

Rate Limits

The prediction.click API allows 600 requests per minute per IP address. Exceeding this returns HTTP 429.

License

MIT