Polymarket MCP Server
About
A Model Context Protocol (MCP) server for Polymarket's Gamma Markets API.
Explore
- [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.
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
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
get_markets
Market Data
get_market_by_id
Market Data
get_order_book
Market Data
get_recent_trades
Market Data
get_market_history
Market Data
search_markets
Market Data
get_events
Event Data
get_event_by_id
Event Data
| Tool | Category | Description |
| --- | --- | --- |
| get_markets | Market Data | Get a list of all available markets with comprehensive filtering options |
| get_market_by_id | Market Data | Get detailed information about a specific market |
| get_order_book | Market Data | [EXPERIMENTAL] Get the current order book for a market |
| get_recent_trades | Market Data | [EXPERIMENTAL] Get latest trades for a market |
| get_market_history | Market Data | [EXPERIMENTAL] Get historical market data |
| search_markets | Market Data | Search for markets by keyword using slug filtering |
| get_events | Event Data | Get a list of all available events with comprehensive filtering options |
| get_event_by_id | Event Data | Get detailed information about a specific event |
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"
]
}
}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.
