graph-polymarket-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| GRAPH_API_KEY | Yes | A free Graph API key obtained from The Graph Studio (https://thegraph.com/studio/). Required to query Polymarket subgraphs. |
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| list_subgraphsA | List all available Polymarket subgraphs with descriptions and key entities |
| get_subgraph_schemaA | Get the full GraphQL schema (introspection) for a Polymarket subgraph |
| query_subgraphB | Execute a custom GraphQL query against a Polymarket subgraph |
| get_market_dataB | Get Polymarket market/condition data including outcomes and volumes from the Main subgraph |
| get_account_pnlB | Get a trader's P&L and performance metrics from the Beefy P&L subgraph |
| get_user_positionsA | Get a user's current positions from the Slimmed P&L subgraph. Falls back gracefully if indexers are behind. |
| get_recent_activityB | Get recent splits, merges, and redemptions from the Activity subgraph |
| get_orderbook_tradesC | Get recent order fills from the Orderbook subgraph |
| get_global_statsA | Get aggregate Polymarket platform statistics. Combines market counts from the Main subgraph with accurate volume/fee/trade data from the Orderbook subgraph. |
| get_daily_statsA | Get daily platform statistics from the Beefy P&L subgraph: volume, fees, trader counts, and market activity per day. Use this for trend analysis and historical performance. |
| get_top_tradersA | Get the top Polymarket traders ranked by realized P&L, win rate, or volume from the Beefy P&L subgraph. |
| get_market_positionsA | Get the top positions for a specific market token from the Beefy P&L subgraph. Shows who holds the largest positions and their P&L. |
| get_market_open_interestB | Get the top Polymarket markets ranked by open interest (USDC locked in outstanding positions). This data is unique to the Open Interest subgraph — no other Polymarket subgraph tracks OI. |
| get_oi_historyA | Get hourly open interest snapshots for a specific Polymarket market. Use this to chart OI trends over time. The conditionId can be obtained from get_market_open_interest or the main subgraph. |
| get_global_open_interestA | Get the total open interest across all Polymarket markets — the aggregate USDC locked in outstanding positions platform-wide. |
| get_market_resolutionA | Get the UMA oracle resolution status for Polymarket markets. Shows whether a market is initialized, proposed, disputed, or resolved, plus proposed/final prices and dispute history. |
| get_disputed_marketsA | Get Polymarket markets that were disputed during the UMA oracle resolution process. Disputes happen when someone challenges a proposed outcome — these are high-signal events. |
| get_market_revisionsA | Get moderator revisions/updates for Polymarket markets. Shows when and how moderators intervened in market resolution. |
| get_trader_profileA | Get a trader's on-chain profile from the Traders subgraph: when they first appeared, their recent CTF events (splits, merges, transfers), and USDC flows. |
| get_trader_usdc_flowsA | Get USDC deposit/withdrawal history for a trader. Shows inbound and outbound USDC transfers, useful for tracking when traders fund or withdraw from Polymarket. |
| search_marketsA | Search Polymarket prediction markets by text query. Returns market metadata including question, prices, volume, liquidity, and CLOB token IDs. Uses the Gamma API for real-time market discovery. Chain with: get_clob_market(conditionId) for live order books, get_live_prices(clobTokenIds) for token-level pricing, get_market_open_interest for capital locked, or get_market_resolution for oracle status. |
| get_market_infoA | Get detailed Polymarket market info by slug or condition ID. Returns full market metadata from the Gamma API including description, prices, outcomes, and CLOB token IDs. Use the returned conditionId to query get_clob_market for live CLOB data, get_market_open_interest for OI, or get_market_resolution for oracle status. |
| list_polymarket_eventsB | List Polymarket events (groups of related markets). Events bundle multiple Yes/No markets under one topic (e.g. 'US Presidential Election 2024' contains many candidate markets). Uses the Gamma API. |
| get_polymarket_eventA | Get a single Polymarket event with all its associated markets. An event groups related prediction markets under one topic. |
| get_live_pricesA | Get real-time CLOB prices for Polymarket outcome tokens. Returns the current best price for buying or selling. Token IDs come from: clobTokenIds in search_markets/get_market_info, or token_id in get_clob_market. |
| get_live_spreadA | Get the real-time bid-ask spread for a Polymarket outcome token. Returns best bid, best ask, and spread. Useful for assessing market liquidity and trading costs. |
| get_live_orderbookA | Get the full real-time order book (bids and asks) for a Polymarket outcome token from the CLOB. Shows all resting limit orders with prices and sizes. |
| get_price_historyB | Get historical price data for a Polymarket outcome token. Returns time-series price points for charting and trend analysis. |
| get_last_tradeB | Get the last trade price for a Polymarket outcome token from the CLOB. |
| get_clob_marketA | Get CLOB market details by condition ID. Returns token IDs (token_id) with live prices, minimum order/tick sizes, and market status. This is the bridge between on-chain condition IDs and CLOB trading data. Use the returned token_id values with get_live_prices, get_live_spread, get_live_orderbook, get_price_history, or get_market_positions. |
| search_markets_enrichedA | Power tool: search Polymarket markets then auto-enrich each result with live CLOB prices and on-chain resolution status. Combines Gamma API + CLOB API + The Graph in one call — no need to chain tools manually. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| analyze_trader | Analyze a Polymarket trader's full profile: P&L, positions, and recent activity |
| market_overview | Get a comprehensive overview of Polymarket platform activity |
| explore_subgraph | Explore a specific Polymarket subgraph's schema and sample data |
| daily_trends | Analyze Polymarket daily trading trends over a time period |
| oi_analysis | Analyze Polymarket open interest — which markets have the most capital locked in and how OI is trending |
| market_deep_dive | Deep dive into a specific Polymarket market — combining off-chain metadata with on-chain analytics and live CLOB data |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/PaulieB14/graph-polymarket-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server