Click on "Install Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Polymarket MCP Servershow me the current odds for the 2024 US presidential election"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Polymarket MCP Server
A powerful MCP (Model Context Protocol) server for querying Polymarket prediction markets. Access real-time odds, market data, price history, and order books directly from your AI assistant.
🎯 What is This?
This MCP server enables AI assistants like Claude, Cursor, and other MCP-compatible tools to interact with Polymarket's prediction markets API. Query live market odds, track price movements, analyze order books, and explore markets by category — all through natural language.
✨ Features
Tool | Description |
| List and paginate through all Polymarket prediction markets |
| Search markets by keyword (questions & descriptions) |
| Get detailed information about a specific market by ID |
| Fetch event details with all sub-markets grouped together |
| Filter markets by category (politics, crypto, sports, etc.) |
| List all available market categories |
| Discover hot markets by volume or price movement |
| Historical price/odds data for any market |
| Real-time order book depth (bids & asks) |
📦 Installation
🚀 Usage
Running the Server
Adding to Cursor IDE
Add this to your Cursor MCP settings file (~/.cursor/mcp.json):
Adding to Claude Desktop
Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):
🛠️ Tools Reference
list_markets
List prediction markets from Polymarket with pagination support.
Parameter | Type | Default | Description |
| number | 10 | Number of markets (1-100) |
| boolean | - | Filter by active status |
| boolean | - | Filter by closed status |
| number | 0 | Pagination offset |
Example: "List 20 active markets on Polymarket"
search_markets
Search for markets by keyword matching questions and descriptions.
Parameter | Type | Default | Description |
| string | required | Search query |
| number | 10 | Number of results (1-50) |
| boolean | - | Filter by active status |
| boolean | - | Filter by closed status |
Example: "Search for Bitcoin prediction markets"
get_market
Get detailed information about a specific market.
Parameter | Type | Description |
| string | The market ID to fetch |
Example: "Get details for market ID 0x..."
get_event
Fetch an event with all its sub-markets. Events group related markets together.
Parameter | Type | Description |
| string | Event slug (e.g., |
| string | Event ID |
| boolean | List available events instead |
| number | Number of events to list (default: 10) |
Example: "Show me the presidential election event on Polymarket"
get_events_by_category
Filter prediction markets by category for focused exploration.
Parameter | Type | Default | Description |
| enum | required | Category filter (see below) |
| number | 10 | Number of events (1-50) |
| boolean | true | Filter by active status |
| boolean | false | Filter by closed status |
Available Categories:
politics— Elections, government, political eventscrypto— Cryptocurrency, blockchain, DeFisports— NFL, NBA, Soccer, and moreworld— International relations, geopoliticsentertainment— Music, TV, celebritieseconomy— GDP, markets, businessscience— Technology, AI, space, climatelegal— Court cases, lawsracing— F1, NASCAR, motorsports
Example: "Show me politics markets on Polymarket"
list_categories
List all available categories for filtering markets.
Example: "What categories are available on Polymarket?"
get_trending_markets
Discover trending markets sorted by activity metrics.
Parameter | Type | Default | Description |
| enum |
| Sort metric |
| number | 10 | Number of markets (1-50) |
Sort Options:
volume24hr— 24-hour trading volumevolume1wk— Weekly trading volumeoneDayPriceChange— 24-hour price movementoneWeekPriceChange— Weekly price movement
Example: "Show me the hottest markets by 24h volume"
get_price_history
Get historical price/odds data for market analysis.
Parameter | Type | Default | Description |
| string | required | Market ID |
| number | 0 | Outcome index (0 = Yes) |
| enum |
| Time range |
Intervals: 1d, 1w, 1m, 3m, 1y, max
Example: "Show price history for market 0x... over the past month"
get_order_book
Get real-time order book depth showing current bids and asks.
Parameter | Type | Default | Description |
| string | required | Market ID |
| number | 0 | Outcome index (0 = Yes) |
Example: "Show me the order book for market 0x..."
💡 Example Queries
Once configured, you can ask your AI assistant:
"Show me politics markets with more than 50% odds for Yes"
"What are the trending crypto markets right now?"
"Search for Trump prediction markets"
"Get the price history for the Bitcoin $100k market"
"List all sports betting markets"
"What's the order book depth for the presidential election market?"
Prompt Templates
Quick prompts to try with your AI assistant:
🔧 Development
📄 API Sources
This server uses the following Polymarket APIs:
Gamma API (
gamma-api.polymarket.com) — Market and event dataCLOB API (
clob.polymarket.com) — Order books and price history
🤝 Contributing
Contributions are welcome! Please feel free to submit a Pull Request.
📜 License
MIT License - see LICENSE for details.
🔗 Links
Polymarket — The prediction market platform
Model Context Protocol — MCP specification
MCP TypeScript SDK — Official SDK
Keywords: Polymarket, MCP, Model Context Protocol, prediction markets, AI assistant, Claude, Cursor, betting odds, crypto markets, political betting, sports betting, market analysis, order book, price history