Skip to main content
Glama
PaulieB14

graph-polymarket-mcp

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
GRAPH_API_KEYYesA 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

CapabilityDetails
tools
{
  "listChanged": true
}
prompts
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription
analyze_traderAnalyze a Polymarket trader's full profile: P&L, positions, and recent activity
market_overviewGet a comprehensive overview of Polymarket platform activity
explore_subgraphExplore a specific Polymarket subgraph's schema and sample data
daily_trendsAnalyze Polymarket daily trading trends over a time period
oi_analysisAnalyze Polymarket open interest — which markets have the most capital locked in and how OI is trending
market_deep_diveDeep 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

NameDescription

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