PolyMarket MCP Server

Name: PolyMarket MCP Server
Author: berlinbra

@berlinbra

Repository

About PolyMarket MCP Server

MCP Server for PolyMarket API

#polymarket #prediction-market #api-server

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "polymarket-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@smithery/cli",
        "install",
        "polymarket_mcp",
        "--client",
        "claude"
      ]
    }
  }
}

Tools

Get detailed information about a specific prediction market

List available prediction markets with filtering options

Get current prices and trading information

Get historical price and volume data

Overview

What is PolyMarket MCP Server?

PolyMarket MCP Server is a Model Context Protocol (MCP) server that provides access to prediction market data through the PolyMarket API. It implements a standardized interface for retrieving market information, prices, and historical data, intended for use with MCP-compatible AI clients.

How to use PolyMarket MCP Server?

Install via Smithery (npx -y @smithery/cli install polymarket_mcp --client claude) or manually by cloning the repository, installing dependencies with uv pip install -e ., and creating a .env file with your PolyMarket API key and wallet address. Then add the server configuration to your MCP client JSON and run uv run src/polymarket_mcp/server.py.

Key features of PolyMarket MCP Server

Real-time prediction market data with current prices and probabilities
Detailed market information including categories, resolution dates, and descriptions
Historical price and volume data with customizable timeframes (1d, 7d, 30d, all)
Built-in error handling and rate limit management
Clean data formatting for easy consumption
Filterable market listing with pagination (up to 100 markets)

Use cases of PolyMarket MCP Server

Query detailed information about a specific prediction market
List available prediction markets with optional status filtering
Retrieve current prices and trading information for a market
Fetch historical price and volume data for trend analysis

FAQ from PolyMarket MCP Server

What are the dependencies and runtime requirements?

Python 3.9 or higher, plus the packages httpx (>=0.24.0), mcp-core, and python-dotenv (>=1.0.0).

How does authentication work?

You must provide a PolyMarket API key and a wallet address (Funder) via a .env file. Missing or invalid credentials result in 403 errors.

What transport does the server use?

The server runs locally via the command line and communicates over standard input/output (stdio), as configured in the MCP client JSON.

How does the server handle rate limits and errors?

It includes built-in handling for rate limiting (429), invalid API keys (403), invalid market IDs (404), network issues, and timeouts (30-second limit). Errors are returned in a clear, human-readable format.