Polymarket MCP server

Polymarket MCP

MCP server that exposes read-only Polymarket prediction market data to AI agents. Tools wrap Polymarket's public Gamma (market discovery) and Data (positions, portfolio, leaderboard) APIs. There is no CLOB integration — this server cannot place trades or read order books.

<!-- mcp-name: io.github.0xChron/polymarket-mcp -->

Tools

All tools return markdown formatted for agent consumption. No API keys or wallet signing are required.

Resources

Static reference context (no API calls). Attach in MCP clients or read via Inspector.

Prompts

User-triggered workflow templates that orchestrate tools:

Requirements

• Python 3.12+
• uv (recommended) or Docker
• Node.js (optional, only for MCP Inspector)

Quick start

This server uses streamable HTTP at http://127.0.0.1:8000/mcp. Start the server first, then connect your MCP client to that URL.

git clone https://github.com/0xChron/polymarket-mcp.git
cd polymarket-mcp
uv sync
uv run polymarket-mcp

On Windows, use the same commands in PowerShell, Command Prompt, or Git Bash. Leave the terminal open while your MCP client is connected.

Docker

Works the same on all platforms if Docker Desktop is installed:

git clone https://github.com/0xChron/polymarket-mcp.git
cd polymarket-mcp
docker build -t polymarket-mcp .
docker run --rm -p 8000:8000 -e FASTMCP_HOST=0.0.0.0 polymarket-mcp

FASTMCP_HOST=0.0.0.0 lets the server accept connections from outside the container.

Verify the server

Open MCP Inspector in another terminal:

npx -y @modelcontextprotocol/inspector

Connect to http://localhost:8000/mcp using the Streamable HTTP transport.

Connect from an MCP client

This server uses the streamable-http transport (not stdio). Start the server first (see Quick start), then add the config below to your MCP client.

Claude Desktop

Go to Claude → Settings → Developer → Edit Config to open claudedesktopconfig.json, then include the following:

{
  "mcpServers": {
    "polymarket": {
      "url": "http://localhost:8000/mcp"
    }
  }
}

If you already have other MCP servers configured, add the "polymarket" entry inside your existing mcpServers object instead of replacing the whole file.

Config file location if you prefer to edit it manually:

Save the file and fully quit and restart Claude Desktop. The server must be running in a terminal before you start a new chat.

Shortened. The full README is on GitHub.