polymarket-blade-mcp

Polymarket prediction market data — events, markets, orderbooks, prices, analytics.

Token-efficient, rate-limited MCP server for the Sidereal platform.

Why another Polymarket MCP?

What this MCP covers

Three Polymarket APIs, all public (no credentials):

• Gamma API — events, markets, tags, search, sports (discovery)
• CLOB API — orderbooks, prices, midpoints, spreads, price history (pricing)
• Data API — open interest, top holders, leaderboard, volume (analytics)

Quick Start

Claude Code / Claude Desktop

{
  "mcpServers": {
    "polymarket": {
      "command": "uvx",
      "args": ["polymarket-blade-mcp"]
    }
  }
}

From source

git clone https://github.com/Groupthink-dev/polymarket-blade-mcp
cd polymarket-blade-mcp
make install-dev
make run

Configuration

All optional — the server works with zero configuration.

Tool Reference

System (1)

Discovery (8)

Pricing (7)

Analytics (4)

Batch (2)

Security

• Read-only v1 — no trading, no wallet keys, no credentials required
• No SSRF — every endpoint is explicitly mapped. No generic pass-through tools
• Rate limiting — per-endpoint token buckets matching Polymarket's documented limits
• Credential scrubbing — sensitive values stripped from error output
• Write gates (v2) — POLYMARKET_WRITE_ENABLED env + per-call confirm=true parameter
• HTTP transport auth — optional bearer token for remote deployment

Rate Limits

Token-bucket rate limiter per endpoint group:

Development

make install-dev   # Install all dependencies
make test          # Run unit tests (99 tests)
make test-cov      # Tests with coverage report
make check         # Lint + format + typecheck

Tech stack

• Python 3.12+ / FastMCP / httpx / Pydantic
• uv (package manager) / ruff (lint+format) / mypy (strict types) / pytest

License

MIT