Predexon MCP Server

MCP server for the Predexon prediction market data API. Provides 19 tools for accessing market data from Polymarket, Kalshi, and Dflow.

Installation

npm install -g predexon-mcp

Or run directly with npx:

npx predexon-mcp

API Key

Each tool call requires an api_key parameter. Get your API key at dashboard.predexon.com

This design allows different agents/users to use their own API keys without server reconfiguration.

Usage with Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json):

{
  "mcpServers": {
    "predexon": {
      "command": "npx",
      "args": ["predexon-mcp"]
    }
  }
}

Example Tool Call

Every tool requires an api_key parameter:

{
  "tool": "list_polymarket_markets",
  "params": {
    "api_key": "your_api_key_here",
    "search": "bitcoin",
    "limit": 10
  }
}

Available Tools (19)

Cross-Platform Matching

• find_matching_markets - Find equivalent markets across Polymarket and Kalshi
• get_matched_pairs - Get all active exact-matched market pairs

Polymarket (10 tools)

• list_polymarket_markets - List markets with filtering and sorting
• get_polymarket_price - Get current or historical token price
• get_polymarket_candlesticks - Get OHLCV candlestick data
• get_polymarket_volume - Get historical volume time series
• get_polymarket_open_interest - Get historical open interest
• get_polymarket_orderbooks - Get historical orderbook snapshots
• get_polymarket_trades - Query historical trade data
• get_polymarket_activity - Get user trading activity (SPLIT, MERGE, REDEEM)
• get_polymarket_positions - Get wallet positions with P&L
• get_polymarket_pnl - Get cumulative realized P&L over time

Kalshi (3 tools)

• list_kalshi_markets - List markets with filtering and sorting
• get_kalshi_trades - Fetch historical trade data
• get_kalshi_orderbooks - Get historical orderbook snapshots

Dflow (3 tools)

• get_dflow_trades - Fetch trade history for a wallet
• get_dflow_positions - Get current positions
• get_dflow_pnl - Get cumulative realized P&L history

Utility

• health_check - Check if the Predexon API is operational

Features

• 30s request timeout - Prevents hanging requests
• Automatic retry - Retries on rate limits (429) and server errors (5xx)
• URL encoding - Path parameters are safely encoded

License

MIT