Polymarket MCP

🚀 Polymarket MCP Server

A server for the Model Context Protocol (MCP) that supports Polymarket's Gamma market API.

This server provides AI assistants with an interface to access Polymarket's prediction markets and market data. Through the standardized MCP protocol, it allows AI to analyze prediction markets and obtain market data.

🚀 Quick Start

The Polymarket MCP Server offers AI assistants an interface to access Polymarket's prediction markets and market data via the standardized MCP protocol.

✨ Features

• [x] Market and event data access

  • [x] List all available markets and events with comprehensive filtering options
  • [x] Get detailed market and event information
  • [x] Search for markets by keywords
  • [x] Get order book data
  • [x] View recent trades
  • [x] Get historical market data

• [x] Docker containerization support

• [x] Provide interactive tools for AI assistants

The list of tools can be configured as needed. You can choose which tools to enable to suit your requirements.

💻 Usage Examples

Using Claude Desktop

Docker Setup

To use the containerized server in Claude Desktop, add the following to your Claude Desktop configuration file:

{
  "mcpServers": {
    "polymarket": {
      "command": "docker",
      "args": [
        "run",
        "--rm",
        "-i",
        "-e", "GAMMA_API_URL",
        "-e", "GAMMA_REQUIRES_AUTH",
        "polymarket"
      ],
      "env": {
        "GAMMA_API_KEY": "your_api_key_here"
      }
    }
  }
}

Then start the server with the following command:

claudius mcp-server start polymarket

UV Setup

If you choose to use uv, add the following to your Claude Desktop configuration file:

{
  "mcpServers": {
    "polymarket": {
      "command": "uv",
      "args": [
        "--port",
        "12345"
      ],
      "env": {
        "GAMMA_API_KEY": "your_api_key_here"
      }
    }
  }
}

Then start the server with the following command:

claudius mcp-server start polymarket

📚 Documentation

Available Tools

📄 License

MIT