get_market_positions
Top holders for a specific outcome token with their P&L
How to use it
Project documentation lists get_market_positions for the Graph Polymarket MCP MCP server. Add the server to your MCP client (Claude Desktop, Cursor, Windsurf and others), then check which tools your installed version makes available. Tool availability can depend on configuration and credentials. A server handshake does not verify this tool’s behavior. See the full listing for setup details.
Install Graph Polymarket MCP
npx -y graph-polymarket-mcpOther tools in Graph Polymarket MCP (34)
How far behind chainhead any subgraph is, read live from its meta block
Get a trader's P&L and performance metrics (winRate, profitFactor, maxDrawdown)
Recent fills routed by one builder code, plus that builder's aggregate totals
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
CLOB market details: token IDs, live prices, min order/tick sizes
Daily volume, fees, trader counts, and market activity (1–90 days)
Markets disputed during oracle resolution (high-signal events)
Total platform-wide open interest and market count
Get platform stats: market counts + real volume/fees/trades
Last trade price for an outcome token
Full order book (all resting bids and asks) for a token
Real-time CLOB prices for outcome tokens (buy/sell, single or batch)
Bid-ask spread + midpoint for assessing market liquidity
Get market/condition data with outcomes and resolution status
Get detailed market metadata by slug or condition ID
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).
UMA oracle resolution status with filtering by status
Moderator interventions and updates on market resolution
Hourly OI snapshots for a specific market (for charting trends)
Get recent order fills with maker/taker filtering
Get a single event with all its associated markets
Historical price time-series (1m to max interval, configurable fidelity)
Unified chronological feed interleaving splits, merges, and redemptions with orderbook fills. Supports optional address filter.
Get the full GraphQL schema for a specific subgraph
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.
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.
USDC deposit/withdrawal history with direction filtering
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.
Top real V2 traders, with the exchange contracts filtered out
Browse events (groups of related markets) with tag/status filters
List all available Polymarket subgraphs with descriptions and key entities
Execute a custom GraphQL query against any subgraph
Search markets by text query with filters (active, closed, sort by volume/liquidity)
Power tool: search + auto-enrich with live CLOB prices AND on-chain resolution status in one call