Graph Polymarket Mcp
Connects Claude to Polymarket prediction markets through The Graph's on-chain indexers and Polymarket's REST APIs. You get 31 tools split between historical blockchain data (trader P&L, open interest, market resolution status, position tracking across 8 subgraphs) and live orderbook operations (market search, real-time prices, spreads, order books, price history). The Graph integration requires a free API key and handles the heavy analytics work, while the Gamma and CLOB API tools hit public endpoints for current market state. Useful when you need to analyze prediction market dynamics, track trader performance, or build agents that reason about market liquidity and pricing. Cross-references multiple data sources to flag discrepancies like orderbook-only traders missing from P&L leaderboards or open interest trapped in resolved markets.
- GitHub stars
- 2
- tools
- 35
- auth
- Secret needed
- transport
- STDIO
- env var
- 1
- last updated
- Mar 7, 2026
Tools
35 toolsPublic tool metadata for what this MCP can expose to an agent.
list_subgraphsList all available Polymarket subgraphs with descriptions and key entities
List all available Polymarket subgraphs with descriptions and key entities
No parameter schema in public metadata yet.
get_subgraph_schemaGet the full GraphQL schema for a specific subgraph
Get the full GraphQL schema for a specific subgraph
No parameter schema in public metadata yet.
query_subgraphExecute a custom GraphQL query against any subgraph
Execute a custom GraphQL query against any subgraph
No parameter schema in public metadata yet.
get_market_dataGet market/condition data with outcomes and resolution status
Get market/condition data with outcomes and resolution status
No parameter schema in public metadata yet.
get_global_statsGet platform stats: market counts + real volume/fees/trades
Get platform stats: market counts + real volume/fees/trades
No parameter schema in public metadata yet.
get_account_pnlGet a trader's P&L and performance metrics (winRate, profitFactor, maxDrawdown)
Get a trader's P&L and performance metrics (winRate, profitFactor, maxDrawdown)
No parameter schema in public metadata yet.
get_top_tradersLeaderboard ranked by PnL, winRate, volume, or profitFactor, cross-referenced with Orderbook data
Leaderboard ranked by PnL, winRate, volume, or profitFactor, cross-referenced with Orderbook data
No parameter schema in public metadata yet.
get_daily_statsDaily volume, fees, trader counts, and market activity (1–90 days)
Daily volume, fees, trader counts, and market activity (1–90 days)
No parameter schema in public metadata yet.
get_market_positionsTop holders for a specific outcome token with their P&L
Top holders for a specific outcome token with their P&L
No parameter schema in public metadata yet.
get_user_positionsCurrent token positions, cross-referenced with Orderbook data
Current token positions, cross-referenced with Orderbook data
No parameter schema in public metadata yet.
get_recent_activityUnified chronological feed interleaving splits, merges, and redemptions with orderbook fills
Unified chronological feed interleaving splits, merges, and redemptions with orderbook fills
No parameter schema in public metadata yet.
get_orderbook_tradesGet recent order fills with maker/taker filtering
Get recent order fills with maker/taker filtering
No parameter schema in public metadata yet.
get_market_open_interestTop markets ranked by USDC locked in outstanding positions
Top markets ranked by USDC locked in outstanding positions
No parameter schema in public metadata yet.
get_oi_historyHourly OI snapshots for a specific market (for charting trends)
Hourly OI snapshots for a specific market (for charting trends)
No parameter schema in public metadata yet.
get_global_open_interestTotal platform-wide open interest and market count
Total platform-wide open interest and market count
No parameter schema in public metadata yet.
get_market_resolutionUMA oracle resolution status with filtering by status
UMA oracle resolution status with filtering by status
No parameter schema in public metadata yet.
get_disputed_marketsMarkets disputed during oracle resolution (high-signal events)
Markets disputed during oracle resolution (high-signal events)
No parameter schema in public metadata yet.
get_market_revisionsModerator interventions and updates on market resolution
Moderator interventions and updates on market resolution
No parameter schema in public metadata yet.
get_trader_profileFull trader profile combining CTF events and USDC flows with Orderbook fills
Full trader profile combining CTF events and USDC flows with Orderbook fills
No parameter schema in public metadata yet.
get_trader_usdc_flowsUSDC deposit/withdrawal history with direction filtering
USDC deposit/withdrawal history with direction filtering
No parameter schema in public metadata yet.
search_marketsSearch markets by text query with filters (active, closed, sort by volume/liquidity)
Search markets by text query with filters (active, closed, sort by volume/liquidity)
No parameter schema in public metadata yet.
get_market_infoGet detailed market metadata by slug or condition ID
Get detailed market metadata by slug or condition ID
No parameter schema in public metadata yet.
list_polymarket_eventsBrowse events (groups of related markets) with tag/status filters
Browse events (groups of related markets) with tag/status filters
No parameter schema in public metadata yet.
get_polymarket_eventGet a single event with all its associated markets
Get a single event with all its associated markets
No parameter schema in public metadata yet.
get_live_pricesReal-time CLOB prices for outcome tokens (buy/sell, single or batch)
Real-time CLOB prices for outcome tokens (buy/sell, single or batch)
No parameter schema in public metadata yet.
get_live_spreadBid-ask spread + midpoint for assessing market liquidity
Bid-ask spread + midpoint for assessing market liquidity
No parameter schema in public metadata yet.
get_live_orderbookFull order book (all resting bids and asks) for a token
Full order book (all resting bids and asks) for a token
No parameter schema in public metadata yet.
get_price_historyHistorical price time-series (1m to max interval, configurable fidelity)
Historical price time-series (1m to max interval, configurable fidelity)
No parameter schema in public metadata yet.
get_last_tradeLast trade price for an outcome token
Last trade price for an outcome token
No parameter schema in public metadata yet.
get_clob_marketCLOB market details: token IDs, live prices, min order/tick sizes
CLOB market details: token IDs, live prices, min order/tick sizes
No parameter schema in public metadata yet.
search_markets_enrichedSearch and auto-enrich with live CLOB prices and on-chain resolution status in one call
Search and auto-enrich with live CLOB prices and on-chain resolution status in one call
No parameter schema in public metadata yet.
get_builder_leaderboardRank V2 builders by routed volume, order count or fees, with each builder's share of V2 volume
Rank V2 builders by routed volume, order count or fees, with each builder's share of V2 volume
No parameter schema in public metadata yet.
get_builder_activityRecent fills routed by one builder code, plus that builder's aggregate totals
Recent fills routed by one builder code, plus that builder's aggregate totals
No parameter schema in public metadata yet.
get_v2_top_tradersTop real V2 traders, with the exchange contracts filtered out
Top real V2 traders, with the exchange contracts filtered out
No parameter schema in public metadata yet.
check_subgraph_freshnessHow far behind chainhead any subgraph is, read live from its _meta block
How far behind chainhead any subgraph is, read live from its _meta block
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
GRAPH_API_KEY*secretAPI key for The Graph network (optional, for higher rate limits)
Readme
graph-polymarket-mcp
MCP server for querying Polymarket prediction market data via The Graph subgraphs and Polymarket REST APIs.
Exposes 31 tools that AI agents (Claude, Cursor, etc.) can use to search markets, get real-time CLOB prices and order books, query on-chain data, trader P&L, positions, activity, open interest, market resolution status, and trader profiles.
Details
- Repository
- github.com/paulieb14/graph-polymarket-mcp
- Package
graph-polymarket-mcp- Transport
- STDIO
- Auth
- Required
- Registry
- MCP registry, active