PolyMarket MCP Server

Name: PolyMarket MCP Server
Author: berlinbra

@berlinbra

代码仓库

关于 PolyMarket MCP Server

MCP Server for PolyMarket API

#polymarket #prediction-market #api-server

基本信息

分类

其他

传输方式

stdio

发布者

berlinbra

配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

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

工具

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

概览

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.