MCP Server

The Predexon MCP server lets AI assistants like Claude, Cursor, Windsurf, 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

Edit the Windsurf MCP configuration file:Path: ~/.codeium/windsurf/mcp_config.json

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

You can also add MCP servers from the MCP icon in the Cascade panel, or via Windsurf Settings > Cascade > MCP Servers.Windsurf 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 all Predexon Data API endpoints as tools. 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

Tool	Description
`list_polymarket_markets`	List markets with filtering and sorting
`get_polymarket_price`	Get current or historical price for a token
`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 trading activity for a wallet
`get_polymarket_positions`	Get positions for a wallet
`get_polymarket_pnl`	Get realized P&L history for a wallet

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

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

API Reference

Cross-Platform Matching

Polymarket

Kalshi

Dflow

What is MCP?

Installation

Configuration

Available Tools

Cross-Platform Matching

Polymarket

Kalshi

Dflow

Example Usage

Authentication

Source Code

Next Steps

API Reference

Get API Key

Getting Started

API Reference

Cross-Platform Matching

Polymarket

Kalshi

Dflow

​What is MCP?

​Installation

​Configuration

​Available Tools

​Cross-Platform Matching

​Polymarket

​Kalshi

​Dflow

​Example Usage

​Authentication

​Source Code

​Next Steps

API Reference

Get API Key

What is MCP?

Installation

Configuration

Available Tools

Cross-Platform Matching

Polymarket

Kalshi

Dflow

Example Usage

Authentication

Source Code

Next Steps