polymarket-mcp

Overview

The polymarket-mcp server serves as a bridge between AI assistants and Polymarket's Gamma Markets API, allowing AI systems to query prediction market data, access market details, retrieve order book information, and analyze market trends. It provides both Docker and UV installation methods, making it accessible for various deployment scenarios.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• get_markets

  Get a list of all available markets with comprehensive filtering options

  Try:Show me all available marketsTry:List prediction markets about electionsTry:Get markets with more than $100k volume
• get_market_by_id

  Get detailed information about a specific market

  Try:Get details for market 0x123Try:Show me information about market ID 0x456Try:What's the status of market 0x789?
• get_order_book

  [EXPERIMENTAL] Get the current order book for a market

  Try:Show me the order book for market 0x123Try:What are the current bids and asks for market 0x456?Try:Get order book data for election markets
• get_recent_trades

  [EXPERIMENTAL] Get latest trades for a market

  Try:Show me recent trades for market 0x123Try:What's the latest trading activity for market 0x456?Try:Get recent trades on prediction markets
• get_market_history

  [EXPERIMENTAL] Get historical market data

  Try:Show me the price history for market 0x123Try:Get historical data for market 0x456Try:How has this prediction market evolved over time?
• search_markets

  Search for markets by keyword using slug filtering

  Try:Search for markets about the presidential electionTry:Find markets related to AITry:Search for sports betting markets
• get_events

  Get a list of all available events with comprehensive filtering options

  Try:Show me all available eventsTry:List events related to politicsTry:Get upcoming sporting events
• get_event_by_id

  Get detailed information about a specific event

  Try:Get details for event 123Try:Show me information about event 456Try:What's the status of event 789?

Comparable tools

Installation

docker build -t polymarket-mcp-server .

{
  "mcpServers": {
    "polymarket": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "GAMMA_API_URL",
        "-e", "GAMMA_REQUIRES_AUTH",
        "polymarket-mcp-server"
      ],
      "env": {
        "GAMMA_API_URL": "https://gamma-api.polymarket.com",
        "GAMMA_REQUIRES_AUTH": "false"
      }
    }
  }
}

cp .env.template .env
# Edit .env with your configuration

{
  "mcpServers": {
    "polymarket": {
      "command": "/usr/local/bin/uv",
      "args": [
        "run",
        "-m", "polymarket_mcp_server.main"
      ],
      "cwd": "<full path to polymarket-mcp directory>",
      "env": {
        "GAMMA_API_URL": "https://gamma-api.polymarket.com",
        "GAMMA_REQUIRES_AUTH": "false"
      }
    }
  }
}

FAQ

What is the Gamma Markets API?

Gamma Markets API is Polymarket's official API for accessing prediction market data, including markets, events, order books, and historical data.

How do I authenticate with the API?

Set GAMMA_REQUIRES_AUTH=true in your environment and provide appropriate authentication credentials in your requests.

Compare polymarket-mcp with