Polymarket MCP Server
About
A Model Context Protocol (MCP) server for Polymarket's Gamma Markets API.
Details
- Author
- pab1it0
- GitHub stars
- 7
- Downloads
- 382
- Categories
- Other, AI
Jump to
- 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
Setting up with Highlight
This MCP is not yet compatible with Highlight’s one-click setup. However, you can still use it with Highlight by following these steps:
- Download and install Highlight from highlightai.com/download
- Navigate to the plugins tab and select "Add Custom Plugin"
-
Configure the plugin with the settings below
Plugin Name
Polymarket MCP ServerCommand (node, npx, python, etc.)Please refer to the README for specific instructions on how to obtain API keys or other required environment variables.
- Enable "Start Automatically" if you want the plugin to start when Highlight launches
From the repository
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).
Claude Desktop / Cursor
Paste into your MCP client config file to install this server.
{
"mcpServers": {
"polymarket mcp server": {
"polymarket-mcp-pab1it0": {
"command": "uv",
"args": [
"venv"
]
}
}
}
}McpServers
{
"polymarket-mcp-pab1it0": {
"command": "uv",
"args": [
"venv"
]
}
}Polymarket MCP Server
A [Model Context Protocol][mcp] (MCP) server for Polymarket's Gamma Markets API.
This provides access to Polymarket's prediction markets and market data through standardized MCP interfaces, allowing AI assistants to query market data and analyze prediction markets.
[mcp]: https://modelcontextprotocol.io
Features
- [x] Market and Event data access
- [x] List all available markets and events with extensive filtering options
- [x] Get detailed market and event information
- [x] Search markets by keyword
- [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 is configurable, so you can choose which tools you want to make available to the MCP client.
This is useful if you don't use certain functionality or if you don't want to take up too much of the context window.
Usage with Claude Desktop
Docker Setup
To use the containerized server with Claude Desktop, add this to your Claude Desktop configuration:
{
"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"
}
}
}
}
> Note: You'll need to build the Docker image first with docker build -t polymarket-mcp-server .
UV Setup (Alternative Method)
If you prefer not to use Docker, you can use uv to run the server directly:
1. Create and configure a .env file in the project root directory:
```bash
Sign in to leave a review
Use Google, GitHub, or an email account so ratings stay tied to real people.
No reviews posted yet.
