Graph Polymarket MCP
UnclaimedMCP server for Polymarket prediction markets — 31 tools combining The Graph subgraphs + Polymarket REST APIs (Gamma + CLOB) for market search, live prices, order books, trader P&L, open interest, and resolution data
Set up this server
01 / Choose your client
02 / Before you connect
Authentication is not specified. Check the project instructions before connecting.
Project instructions03 / Add the configuration
claude mcp add --transport stdio 'graph-polymarket-mcp' -- 'npx' '-y' 'graph-polymarket-mcp'04 / Check it in your client
Open your client’s MCP settings and confirm the server connects and lists its tools. A copied configuration does not confirm a working connection.
More in Search & Web
Browse the full directoryUnclaimed listing
Is this your MCP server?
This listing was auto-indexed from the public record. Claim it to edit the page, set compatibility and unlock growth tools. Takes under two minutes.
Claim this serverSecurity profile
Claimed and verified servers get a weekly static scan that shows what the code can reach: external services, environment variables, shell commands, agent configuration folders, plus any dependencies with known advisories. Claim this listing to get one. How the security profile works
35 of 35 tools
Documented tools (35)
From project documentation. A server handshake does not verify each tool’s description or behavior.
check_subgraph_freshness
How far behind chainhead any subgraph is, read live from its meta block
get_account_pnl
Get a trader's P&L and performance metrics (winRate, profitFactor, maxDrawdown)
get_builder_activity
Recent fills routed by one builder code, plus that builder's aggregate totals
get_builder_leaderboard
Rank V2 builders by routed volume, order count or fees, with each builder's share of V2 volume. No V1 equivalent — the V1 contracts never emitted a builder code
get_clob_market
CLOB market details: token IDs, live prices, min order/tick sizes
get_daily_stats
Daily volume, fees, trader counts, and market activity (1–90 days)
get_disputed_markets
Markets disputed during oracle resolution (high-signal events)
get_global_open_interest
Total platform-wide open interest and market count
get_global_stats
Get platform stats: market counts + real volume/fees/trades
get_last_trade
Last trade price for an outcome token
get_live_orderbook
Full order book (all resting bids and asks) for a token
get_live_prices
Real-time CLOB prices for outcome tokens (buy/sell, single or batch)
get_live_spread
Bid-ask spread + midpoint for assessing market liquidity
get_market_data
Get market/condition data with outcomes and resolution status
get_market_info
Get detailed market metadata by slug or condition ID
get_market_open_interest
Top markets ranked by USDC locked in outstanding positions. Cross-refs Main subgraph to flag ⚠ dead money OI on resolved markets (losing-side tokens that will never be redeemed on-chain).
get_market_positions
Top holders for a specific outcome token with their P&L
get_market_resolution
UMA oracle resolution status with filtering by status
get_market_revisions
Moderator interventions and updates on market resolution
get_oi_history
Hourly OI snapshots for a specific market (for charting trends)
get_orderbook_trades
Get recent order fills with maker/taker filtering
get_polymarket_event
Get a single event with all its associated markets
get_price_history
Historical price time-series (1m to max interval, configurable fidelity)
get_recent_activity
Unified chronological feed interleaving splits, merges, and redemptions with orderbook fills. Supports optional address filter.
get_subgraph_schema
Get the full GraphQL schema for a specific subgraph
get_top_traders
Leaderboard ranked by PnL, winRate, volume, or profitFactor. Cross-refs Orderbook to flag rows where OB volume exceeds Beefy-tracked volume and surface OB-only traders absent from the leaderboard.
get_trader_profile
Full trader profile combining CTF events and USDC flows with Orderbook fills. Classifies wallet as hybrid / orderbook-only / split-collateral-only and warns when P&L subgraphs are unreliable.
get_trader_usdc_flows
USDC deposit/withdrawal history with direction filtering
get_user_positions
Current token positions. Cross-refs Orderbook: flags ⚠ orderbook-only entry when totalBought=0 but OB volume exists, and ⚠ mixed entry when OB volume > 2× split collateral.
get_v2_top_traders
Top real V2 traders, with the exchange contracts filtered out
list_polymarket_events
Browse events (groups of related markets) with tag/status filters
list_subgraphs
List all available Polymarket subgraphs with descriptions and key entities
query_subgraph
Execute a custom GraphQL query against any subgraph
search_markets
Search markets by text query with filters (active, closed, sort by volume/liquidity)
search_markets_enriched
Power tool: search + auto-enrich with live CLOB prices AND on-chain resolution status in one call
Tool change history
FAQ
Questions about Graph Polymarket MCP Server
- How do I connect Graph Polymarket MCP Server to Claude?
- Run `claude mcp add graph-polymarket-mcp -- npx -y graph-polymarket-mcp` in Claude Code, or add the same command and arguments under mcpServers in Cursor's mcp.json or Claude Desktop's claude_desktop_config.json, then restart the client. The blocks above are ready to paste.
- Is Graph Polymarket MCP Server free?
- The listed licence is MIT. Check the upstream terms for permitted use and commercial requirements; a public repository does not by itself mean the software is free or open source. Connected APIs and hosted services may have separate charges.
- What can Graph Polymarket MCP Server do?
- Graph Polymarket MCP Server documents 35 tools to the agent, including check_subgraph_freshness, get_account_pnl, get_builder_activity. The descriptions above come from project documentation. A live handshake does not test individual tool behavior.