MCP Server

The Predexon MCP server lets AI assistants like Claude, Cursor, Codex, and others directly query prediction market data from Polymarket, Kalshi, and Dflow.

What is MCP?

Model Context Protocol (MCP) is an open standard that allows AI assistants to interact with external tools and data sources. With the Predexon MCP server, you can ask your AI assistant questions like:

“What are the top prediction markets by volume?”
“Show me the price history for this market”
“Find matching markets across Polymarket and Kalshi”
“What positions does this wallet hold?”

Installation

Install the Predexon MCP server from npm:

npm install -g predexon-mcp

Or run directly with npx (no installation required):

npx predexon-mcp

Configuration

Edit your Claude Desktop configuration file:macOS: ~/Library/Application Support/Claude/claude_desktop_config.jsonWindows: %APPDATA%\Claude\claude_desktop_config.json

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

Restart Claude Desktop after saving.

Add the MCP server via CLI:

claude mcp add predexon npx predexon-mcp

Or manually edit ~/.claude.json:

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

Cursor supports both global and project-specific MCP configuration.Global (all projects): ~/.cursor/mcp.jsonProject-specific: .cursor/mcp.json in your project root

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

Verify the connection in Settings > Cursor Settings > MCP. A green dot indicates the server is connected.Cursor MCP Docs

VS Code supports MCP servers through GitHub Copilot.Global: Open your user mcp.json via Command PaletteProject-specific: .vscode/mcp.json in your workspace

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

Or add via CLI:

code --add-mcp '{"name":"predexon","command":"npx","args":["-y","predexon-mcp"]}'

VS Code MCP Docs

In Cline, click the MCP Servers icon in the sidebar, then click Edit MCP Settings to open the configuration file. Add:

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

Cline MCP Docs

OpenAI Codex CLI uses TOML configuration. Edit ~/.codex/config.toml:

[mcp_servers.predexon]
command = "npx"
args = ["-y", "predexon-mcp"]

Or add via CLI:

codex mcp add predexon -- npx -y predexon-mcp

Codex MCP Docs

Available Tools

The MCP server exposes 37 tools covering market data, smart-wallet analytics, and trading insights. Your API key is passed per-request, allowing multi-user setups.

Cross-Platform Matching

Tool	Description
`find_matching_markets`	Find equivalent markets across Polymarket and Kalshi (LLM-powered)
`get_matched_pairs`	Get all active matched market pairs (LLM-powered)

Market matching is LLM-powered. While highly accurate, a small number of matches may be incorrect-verify critical matches independently.

Polymarket - Market Data

Tool	Description
`list_polymarket_markets`	List markets with filtering and sorting
`get_polymarket_events`	List events (top-level groupings of markets)
`get_polymarket_crypto_updown`	List crypto up/down prediction markets (BTC, ETH, SOL, XRP, HYPE, DOGE, BNB)
`get_polymarket_price`	Get current or historical price for a token
`get_polymarket_candlesticks`	Get OHLCV candlestick data
`get_polymarket_volume`	Get cumulative volume time series
`get_polymarket_volume_chart`	Get per-period volume with YES/NO side split
`get_polymarket_open_interest`	Get historical open interest
`get_polymarket_orderbooks`	Get historical orderbook snapshots

Polymarket - Trading

Tool	Description
`get_polymarket_trades`	Query historical trade data
`get_polymarket_activity`	Get on-chain activity (split/merge/redeem events)
`get_polymarket_positions`	Get positions for a wallet
`get_polymarket_all_positions`	Fetch positions across all wallets (analytics/streaming)
`get_polymarket_pnl`	Get realized P&L history for a wallet

Polymarket - Smart Wallet Analytics

Smart wallet tools require a Dev plan API key or higher.

Tool	Description
`get_polymarket_wallet_profile`	Get complete wallet profile with metrics and style classifications
`get_polymarket_wallet_profiles`	Batch wallet profiles - fetch up to 20 profiles in a single request
`get_polymarket_leaderboard`	Global leaderboard of smart wallets
`get_polymarket_market_leaderboard`	Wallet rankings for a specific market
`get_polymarket_top_holders`	Top token holders for a market by position size
`get_polymarket_wallet_markets`	Per-market performance breakdown for a wallet
`get_polymarket_wallet_volume_chart`	Per-period volume with BUY/SELL breakdown for a wallet
`get_polymarket_wallets_filter`	Filter wallets by market trades with AND/OR logic
`get_polymarket_smart_activity`	Discover markets where high-performing wallets are active
`get_polymarket_smart_money`	Net buyers vs sellers among smart wallets 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

Kalshi

Tool	Description
`list_kalshi_markets`	List markets with filtering and sorting
`get_kalshi_trades`	Fetch historical trade data
`get_kalshi_orderbooks`	Fetch historical orderbook snapshots

Dflow

Tool	Description
`get_dflow_trades`	Fetch trade history for a wallet
`get_dflow_positions`	Get current positions for a wallet
`get_dflow_pnl`	Get cumulative P&L history

Binance

Binance tools require a Dev plan API key or higher. Supported symbols: BTCUSDT, ETHUSDT, SOLUSDT, XRPUSDT.

Tool	Description
`get_binance_ticks`	Get raw book ticker data at microsecond granularity
`get_binance_candles`	Get OHLCV candlestick data from book ticker mid-prices

Example Usage

Once configured, you can ask your AI assistant questions naturally:

"What are the top 5 Polymarket markets by volume right now?"

Authentication

Each tool call requires an api_key parameter. When using the MCP server, include your API key when making requests:

"Using API key abc123, show me the top markets on Polymarket"

Get your free API key at dashboard.predexon.com

Source Code

The MCP server is open source:

npm: npmjs.com/package/predexon-mcp

Next Steps

API Reference

Explore all available endpoints

Getting Started

Data API

Trading API

Integrations

What is MCP?

Installation

Configuration

Available Tools

Cross-Platform Matching

Polymarket - Market Data

Polymarket - Trading

Polymarket - Smart Wallet Analytics

Kalshi

Dflow

Binance

Example Usage

Authentication

Source Code

Next Steps

API Reference

Get API Key

Getting Started

Data API

Trading API

Integrations

​What is MCP?

​Installation

​Configuration

​Available Tools

​Cross-Platform Matching

​Polymarket - Market Data

​Polymarket - Trading

​Polymarket - Smart Wallet Analytics

​Kalshi

​Dflow

​Binance

​Example Usage

​Authentication

​Source Code

​Next Steps

API Reference

Get API Key

What is MCP?

Installation

Configuration

Available Tools

Cross-Platform Matching

Polymarket - Market Data

Polymarket - Trading

Polymarket - Smart Wallet Analytics

Kalshi

Dflow

Binance

Example Usage

Authentication

Source Code

Next Steps