v2.0.0 — Polymarket REST API Integration (Gamma + CLOB)

What's New

Integrated Polymarket's public REST APIs (inspired by polymarket-cli) alongside the existing Graph subgraph tools. 31 tools total, up from 20.

11 New Tools (no API key needed)

Market Discovery (Gamma API)

• search_markets — search by text query with filters (active, closed, sort by volume/liquidity)
• get_market_info — detailed market metadata by slug or condition ID
• list_polymarket_events — browse event groups with tag/status filters
• get_polymarket_event — single event with all child markets

Real-Time Trading Data (CLOB API)

• get_live_prices — real-time buy/sell prices (single or batch)
• get_live_spread — bid-ask spread + midpoint
• get_live_orderbook — full order book (all resting bids/asks)
• get_price_history — historical price time-series (1m to max)
• get_last_trade — last trade price

Bridging Tools

• get_clob_market — bridge condition IDs to CLOB token IDs with live prices
• search_markets_enriched — power tool: search + auto-enrich with live CLOB prices AND on-chain resolution status in one call

New Prompt

• market_deep_dive — guided workflow chaining Gamma search → CLOB prices/history → Graph OI/resolution

Improved Tool Descriptions

• All tools now explicitly document which fields (conditionId, tokenId, clobTokenIds) bridge to other tools
• Agents can naturally chain from market search → live prices → on-chain analytics

Three Data Sources, One MCP

Source	What it provides
Gamma API	Text search, market metadata, event groupings
CLOB API	Real-time prices, order books, spreads, price history
The Graph (8 subgraphs)	Trader P&L, open interest, on-chain activity, resolution disputes

Setup

claude mcp add graph-polymarket -- npx -y graph-polymarket-mcp

Free Graph API key for subgraph tools. Gamma/CLOB tools work with no key.