Graph Polymarket MCP

Query Polymarket prediction market data via The Graph subgraphs and Polymarket REST APIs (Gamma + CLOB) — market search, live prices, order books, trader P&L, positions, open interest, resolution status, and trader profiles.

Tools

Polymarket REST API (no API key needed)

• - searchmarkets — Search markets by text query with filters (active, closed, sort by volume/liquidity)
• getmarketinfo — Get detailed market metadata by slug or condition ID
• listpolymarketevents — Browse events (groups of related markets) with tag/status filters
• getpolymarketevent — Get a single event with all its associated markets
• getliveprices — Real-time CLOB prices for outcome tokens (buy/sell, single or batch)
• getlivespread — Bid-ask spread + midpoint for assessing market liquidity
• getliveorderbook — Full order book (all resting bids and asks) for a token
• getpricehistory — Historical price time-series (1m to max interval, configurable fidelity)
• getlasttrade — Last trade price for an outcome token
• getclobmarket — CLOB market details: token IDs, live prices, min order/tick sizes
• searchmarkets_enriched — Power tool: search + auto-enrich with live CLOB prices AND on-chain resolution status

The Graph Subgraphs (requires GRAPHAPIKEY)

• - listsubgraphs — List all available Polymarket subgraphs with descriptions and key entities
• getsubgraphschema — Get the full GraphQL schema for a specific subgraph
• querysubgraph — Execute a custom GraphQL query against any subgraph
• getmarketdata — Get market/condition data with outcomes and resolution status
• getglobalstats — Platform stats: market counts, volume, fees, trades
• getaccountpnl — Trader P&L and performance metrics (winRate, profitFactor, maxDrawdown)
• gettoptraders — Leaderboard ranked by PnL, winRate, volume, or profitFactor
• getdailystats — Daily volume, fees, trader counts, and market activity
• getmarketpositions — Top holders for a specific outcome token with their P&L
• getuserpositions — A user's current token positions
• getrecentactivity — Recent splits, merges, and redemptions
• getorderbooktrades — Recent order fills with maker/taker filtering
• getmarketopeninterest — Top markets ranked by USDC locked in positions
• getoihistory — Hourly OI snapshots for a specific market
• getglobalopeninterest — Total platform-wide open interest and market count
• getmarketresolution — UMA oracle resolution status with filtering
• getdisputedmarkets — Markets disputed during oracle resolution
• getmarketrevisions — Moderator interventions and updates on market resolution
• gettraderprofile — Full trader profile: first seen, CTF events, USDC flows
• gettraderusdc_flows — USDC deposit/withdrawal history with direction filtering

Requirements

• - Runtime: Node.js >= 18 (runs via npx)
• Environment variables:

Install

CODEBLOCK0

Network & Data Behavior

• - Subgraph tools make GraphQL requests to The Graph Gateway (gateway.thegraph.com) using your API key.
• REST API tools query Polymarket's public endpoints (gamma-api.polymarket.com and clob.polymarket.com) directly — no authentication needed.
• Eight subgraphs are queried: Main, Beefy P&L, Slimmed P&L, Activity, Orderbook, Open Interest, Resolution, and Traders.
• No local database or persistent storage is used.
• The SSE transport (--http / --http-only) starts a local HTTP server on port 3851 (configurable via MCP_HTTP_PORT env var).

Use Cases

• - Search and discover prediction markets by topic, category, or keyword
• Get real-time prices, order books, and spreads for any market
• Analyze price history and market trends
• Get platform-wide stats, volume, and market rankings
• Analyze trader P&L, performance metrics, and leaderboards
• Track open interest trends and market positions
• Monitor market resolution lifecycle and disputed markets
• Run custom GraphQL queries against 8 specialized Polymarket subgraphs