Polymarket MCP Server

Overview

The Polymarket MCP Server enables AI assistants to trade, analyze, and manage positions on Polymarket prediction markets. With 45 tools across five categories, it provides comprehensive access to market discovery, deep analysis, order execution, portfolio tracking, and real-time WebSocket monitoring — all through natural language.

Key Features

Installation

Quick Start (DEMO mode, no wallet needed)

git clone https://github.com/caiovicentino/polymarket-mcp-server.git
cd polymarket-mcp-server
./quickstart.sh

Full Production Install

git clone https://github.com/caiovicentino/polymarket-mcp-server.git
cd polymarket-mcp-server
python -m venv venv
source venv/bin/activate
pip install -e .

Configure environment:

cp .env.example .env
# Edit .env with your Polygon wallet credentials

Claude Desktop Configuration

{
  "mcpServers": {
    "polymarket": {
      "command": "/path/to/venv/bin/python",
      "args": ["-m", "polymarket_mcp.server"],
      "cwd": "/path/to/polymarket-mcp-server",
      "env": {
        "POLYGON_PRIVATE_KEY": "your_private_key",
        "POLYGON_ADDRESS": "0xYourAddress"
      }
    }
  }
}

Common Use Cases

• Market Discovery: Find trending markets, search by category, browse sports and crypto predictions
• Trading Execution: Place limit orders, execute market orders, batch submissions, and rebalance positions
• Portfolio Analysis: Track positions, calculate P&L, analyze risk concentration, and optimize allocations
• Real-time Monitoring: Subscribe to live price feeds, track order status, and receive market resolution alerts

Sources

• GitHub - caiovicentino/polymarket-mcp-server
• Polymarket
• Polymarket API Docs