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 credentials does it need?

It reads `GAMMA_API_URL`, `GAMMA_REQUIRES_AUTH` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

Polymarket MCP Server

A Model Context Protocol (MCP) server for Polymarket's Gamma Markets API.

Local serverstdio

What is the Polymarket MCP Server?

A Model Context Protocol (MCP) server for Polymarket's Gamma Markets API.

What it actually does

Market and Event data access
List all available markets and events with extensive filtering options
Get detailed market and event information
Search markets by keyword
Get order book data
View recent trades

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

Maintainer setup documentation.

Recorded tools

Check the linked publisher documentation and your connected client's tool list. Names and availability can vary with the server version and account permissions.

Tool	What it does
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

How to install the Polymarket MCP Server

{
  "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"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.