Predexon MCP Server

MCP server for the Predexon prediction market data API. Provides 42 tools for accessing market data, smart-wallet analytics, and trading insights across Polymarket, Kalshi, Dflow, Binance, Limitless, Opinion, and Predict.Fun.

Installation

npm install -g predexon-mcp

Or run directly with npx:

npx predexon-mcp

API Key

Get your API key at dashboard.predexon.com.

Recommended: Set PREDEXON_API_KEY in your MCP config so the key is never exposed in conversation:

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

Alternatively, you can pass api_key as a parameter on each tool call. Per-request keys take priority over the env var.

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"],
      "env": {
        "PREDEXON_API_KEY": "your_api_key_here"
      }
    }
  }
}

Example Tool Call

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

Available Tools (42)

Cross-Platform Matching (2 tools)

• find_matching_markets - Find equivalent markets across Polymarket and Kalshi (LLM-powered matching)
• get_matched_pairs - Get all active exact-matched market pairs with similarity scores

Polymarket - Market Data (10 tools)

• list_polymarket_markets - List markets with filtering, sorting, and rolling metric filters
• 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 time series
• get_polymarket_orderbooks - Get historical orderbook snapshots
• get_polymarket_trades - Query historical trade data
• get_polymarket_activity - Get wallet trading activity (SPLIT, MERGE, REDEEM)
• get_polymarket_positions - Get wallet positions with P&L
• get_polymarket_pnl - Get cumulative realized P&L over time

Polymarket - Smart Wallet Analytics (13 tools)

• get_polymarket_wallet_profile - Get complete smart wallet profile with style classifications
• get_polymarket_leaderboard - Global leaderboard ranked by PnL, volume, ROI, and more
• get_polymarket_market_leaderboard - Per-market leaderboard of top traders
• get_polymarket_top_holders - Top token holders for a market (Yes/No sides)
• get_polymarket_wallet_markets - Per-market performance breakdown for a wallet
• get_polymarket_wallets_filter - Filter wallets by multi-market trades with AND/OR logic
• get_polymarket_smart_activity - Discover markets where high-performing wallets are active
• get_polymarket_smart_money - Smart money positioning (net buyers vs sellers) for a market
• get_polymarket_similar_wallets - Find wallets with similar portfolios (copy-trade detection)
• get_polymarket_cohort_stats - Compare performance across trading style cohorts
• get_polymarket_volume_chart - Per-period volume breakdown for a market with YES/NO split
• get_polymarket_wallet_volume_chart - Per-period volume chart for a wallet with BUY/SELL split
• get_polymarket_wallet_profiles - Batch smart wallet profiles for multiple wallets

Polymarket - Discovery & Streaming (3 tools)

• get_polymarket_crypto_updown - Crypto up/down prediction markets (BTC, ETH, SOL, XRP)
• get_polymarket_events - List events with filtering and sorting
• get_polymarket_all_positions - Global positions feed across all wallets for analytics/backfill

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

Binance (2 tools)

• get_binance_ticks - Raw book ticker data at microsecond granularity (BTCUSDT, ETHUSDT, SOLUSDT, XRPUSDT)
• get_binance_candles - OHLCV candlestick data with configurable intervals

Limitless (2 tools)

• list_limitless_markets - List markets with filtering and sorting
• get_limitless_orderbooks - Historical orderbook snapshots for Limitless markets

Opinion (2 tools)

• list_opinion_markets - List markets with filtering and sorting
• get_opinion_orderbooks - Historical orderbook snapshots for Opinion markets

Predict.Fun (2 tools)

• list_predictfun_markets - List markets with filtering and sorting
• get_predictfun_orderbooks - Historical orderbook snapshots for Predict.Fun markets

Utility

• health_check - Check if the Predexon API is operational

Features

• v2 API - Targets the latest Predexon API with expanded schemas and endpoints
• 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