Documentation Index Fetch the complete documentation index at: https://docs.predexon.com/llms.txt
Use this file to discover all available pages before exploring further.
The Predexon MCP server lets AI assistants like Claude, Cursor, Codex, and others directly query prediction market data from Polymarket, Kalshi, Dflow, Binance, Limitless, Opinion, and Predict.Fun.
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?”
“What Limitless markets are open right now?”
“Show me Predict.Fun sports markets”
Installation Install the Predexon MCP server from npm:
npm install -g predexon-mcp
Or run directly with npx (no installation required):
Configuration Claude Desktop
Claude Code
Cursor
VS Code
Cline
Codex
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" ], "env" : { "PREDEXON_API_KEY" : "your-key" } } } }
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" ], "env" : { "PREDEXON_API_KEY" : "your-key" } } } }
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" ], "env" : { "PREDEXON_API_KEY" : "your-key" } } } }
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" ], "env" : { "PREDEXON_API_KEY" : "your-key" } } } }
Or add via CLI: code --add-mcp '{"name":"predexon","command":"npx","args":["-y","predexon-mcp"],"env":{"PREDEXON_API_KEY":"your-key"}}'
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" ], "env" : { "PREDEXON_API_KEY" : "your-key" } } } }
Cline MCP Docs OpenAI Codex CLI uses TOML configuration. Edit ~/.codex/config.toml: [ mcp_servers . predexon ] command = "npx" args = [ "-y" , "predexon-mcp" ] [ mcp_servers . predexon . env ] PREDEXON_API_KEY = "your-key"
Or add via CLI: codex mcp add predexon -- npx -y predexon-mcp
Codex MCP Docs The MCP server exposes 42 tools covering market data, smart-wallet analytics, and trading insights across seven platforms.
Tool Description find_matching_marketsFind equivalent markets across Polymarket and Kalshi (LLM-powered) get_matched_pairsGet 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_marketsList markets with filtering and sorting get_polymarket_eventsList events (top-level groupings of markets) get_polymarket_crypto_updownList crypto up/down prediction markets (BTC, ETH, SOL, XRP, HYPE, DOGE, BNB) get_polymarket_priceGet current or historical price for a token get_polymarket_candlesticksGet OHLCV candlestick data get_polymarket_volumeGet cumulative volume time series get_polymarket_volume_chartGet per-period volume with YES/NO side split get_polymarket_open_interestGet historical open interest get_polymarket_orderbooksGet historical orderbook snapshots
Polymarket - Trading Tool Description get_polymarket_tradesQuery historical trade data get_polymarket_activityGet on-chain activity (split/merge/redeem events) get_polymarket_positionsGet positions for a wallet get_polymarket_all_positionsFetch positions across all wallets (analytics/streaming) get_polymarket_pnlGet 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_profileGet complete wallet profile with metrics and style classifications get_polymarket_wallet_profilesBatch wallet profiles - fetch up to 20 profiles in a single request get_polymarket_leaderboardGlobal leaderboard of smart wallets get_polymarket_market_leaderboardWallet rankings for a specific market get_polymarket_top_holdersTop token holders for a market by position size get_polymarket_wallet_marketsPer-market performance breakdown for a wallet get_polymarket_wallet_volume_chartPer-period volume with BUY/SELL breakdown for a wallet get_polymarket_wallets_filterFilter wallets by market trades with AND/OR logic get_polymarket_smart_activityDiscover markets where high-performing wallets are active get_polymarket_smart_moneyNet buyers vs sellers among smart wallets for a market get_polymarket_similar_walletsFind wallets with similar portfolios (copy-trade detection) get_polymarket_cohort_statsCompare performance across trading style cohorts
Kalshi Tool Description list_kalshi_marketsList markets with filtering and sorting get_kalshi_tradesFetch historical trade data get_kalshi_orderbooksFetch historical orderbook snapshots
Dflow Tool Description get_dflow_tradesFetch trade history for a wallet get_dflow_positionsGet current positions for a wallet get_dflow_pnlGet 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_ticksGet raw book ticker data at microsecond granularity get_binance_candlesGet OHLCV candlestick data from book ticker mid-prices
Limitless Tool Description list_limitless_marketsList markets with filtering and sorting get_limitless_orderbooksFetch historical orderbook snapshots
Opinion Tool Description list_opinion_marketsList markets with filtering and sorting get_opinion_orderbooksFetch historical orderbook snapshots
Predict.Fun Tool Description list_predictfun_marketsList markets with filtering and sorting get_predictfun_orderbooksFetch historical orderbook snapshots
Example Usage Once configured, you can ask your AI assistant questions naturally:
Query Markets
Price History
Cross-Platform
Wallet Analysis
Limitless
Predict.Fun
"What are the top 5 Polymarket markets by volume right now?"
Authentication Set your API key via the PREDEXON_API_KEY environment variable in your MCP configuration (see the config examples above). The server reads this automatically on startup.
As a fallback, you can also pass api_key as a parameter on individual tool calls, but the env var approach is recommended — it keeps your key out of conversation text and works across all tools automatically.
Source Code The MCP server is open source:
Next Steps
API Reference Explore all available endpoints
Get API Key Sign up for free access
