Polymarket MCP Server

What is Polymarket MCP Server?

A Model Context Protocol (MCP) server that integrates with Polymarket's Gamma Markets API, allowing AI assistants to query prediction market data and analyze markets through standardized MCP interfaces.

How to use Polymarket MCP Server?

Configure the server for Claude Desktop using either Docker (build the image and add the docker command to mcpServers in claude_desktop_config.json) or uv (set environment variables in a .env file and specify the uv command with the full path). The server loads environment variables from a .env file; required variables are GAMMA_API_URL (default https://gamma-api.polymarket.com) and GAMMA_REQUIRES_AUTH (default false).

Key features of Polymarket MCP Server

• Market and event data access with extensive filtering options
• Get detailed market and event information by ID
• Search markets by keyword
• Retrieve order book data (experimental)
• View recent trades and historical market data (experimental)
• Support for Docker containerization
• Configurable list of tools to reduce context window usage

Use cases of Polymarket MCP Server

• AI assistants querying available prediction markets and events
• Analyzing market details, order books, and recent trades for a given market
• Searching for markets by keyword to find relevant prediction topics
• Running automated market data analysis in a containerized environment

FAQ from Polymarket MCP Server

What API does Polymarket MCP Server use?

It uses Polymarket's Gamma Markets API, with the environment variable GAMMA_API_URL defaulting to https://gamma-api.polymarket.com.

How do I configure authentication?

Set GAMMA_REQUIRES_AUTH to false (default) for read-only access, or to true if you need authenticated access. The server supports environment variables via a .env file.

Can I choose which tools are available to the MCP client?

Yes, the list of tools is configurable, so you can select only the tools you need to avoid taking up too much of the context window.

What runtime dependencies are needed?

The server is written in Python and uses uv for dependency management. It can be run directly with uv or via Docker. For Docker, you must build the image first with docker build -t polymarket-mcp-server ..

What should I do if I see "Error: spawn uv ENOENT" in Claude Desktop?

Specify the full path to uv in the command field of the server configuration, or set the environment variable NO_UV=1 in the configuration.