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

📦 Installation

# Clone the repository
git clone https://github.com/yourusername/poly-mcp.git
cd poly-mcp

# Install dependencies
npm install

# Build the project
npm run build

🚀 Usage

Running the Server

# Production mode
npm start

# Development mode (with hot reload)
npm run dev

# MCP Inspector (for testing)
npm run client

Adding to Cursor IDE

Add this to your Cursor MCP settings file (~/.cursor/mcp.json):

{
  "mcpServers": {
    "polymarket": {
      "command": "node",
      "args": ["/absolute/path/to/poly-mcp/dist/index.js"]
    }
  }
}

Adding to Claude Desktop

Add to your Claude Desktop config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS):

{
  "mcpServers": {
    "polymarket": {
      "command": "node",
      "args": ["/absolute/path/to/poly-mcp/dist/index.js"]
    }
  }
}

🛠️ Tools Reference

list_markets

List prediction markets from Polymarket with pagination support.

Example: "List 20 active markets on Polymarket"

search_markets

Search for markets by keyword matching questions and descriptions.

Example: "Search for Bitcoin prediction markets"

get_market

Get detailed information about a specific market.

Example: "Get details for market ID 0x..."

get_event

Fetch an event with all its sub-markets. Events group related markets together.

Example: "Show me the presidential election event on Polymarket"

get_events_by_category

Filter prediction markets by category for focused exploration.

Available Categories:

• politics — Elections, government, political events
• crypto — Cryptocurrency, blockchain, DeFi
• sports — NFL, NBA, Soccer, and more
• world — International relations, geopolitics
• entertainment — Music, TV, celebrities
• economy — GDP, markets, business
• science — Technology, AI, space, climate
• legal — Court cases, laws
• racing — 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.

Sort Options:

• volume24hr — 24-hour trading volume
• volume1wk — Weekly trading volume
• oneDayPriceChange — 24-hour price movement
• oneWeekPriceChange — Weekly price movement

Example: "Show me the hottest markets by 24h volume"

get_price_history

Get historical price/odds data for market analysis.

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.

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:

# Quick market check
What does Polymarket say about [TOPIC]? Show me the odds.

# Cross-source validation
News reports say [EVENT]. Check Polymarket and tell me if the
smart money agrees.

# Find opportunities
Find markets closing in the next 24 hours with 90%+ odds on one side.

🔧 Development

# Install dependencies
npm install

# Run in development mode
npm run dev

# Build for production
npm run build

# Test with MCP Inspector
npm run client

📄 API Sources

This server uses the following Polymarket APIs:

• Gamma API (gamma-api.polymarket.com) — Market and event data
• CLOB 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