Skip to content
Agentmart
Submit a tool

Graph Polymarket MCP

Query Polymarket prediction markets via The Graph — 20 tools, 8 subgraphs

Connector by PaulieB14 · GitHub account verified by the MCP Registry

IndexedMITLocal (stdio)★ 4
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/paulieb14-graph-polymarket-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Query Polymarket prediction markets via The Graph — 20 tools, 8 subgraphs

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 25, 2026.

Tools
34 read · 0 write · 0 delete · 1 not yet classified
Secrets
1 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Node.js package

Tools by what they do 35

Read from the source code; the running server may list different tools.

Read 34 · Look things up without changing anything.

  • check_subgraph_freshness
  • get_account_pnl
  • get_builder_activity
  • get_builder_leaderboard
  • get_clob_market
  • get_daily_stats
  • get_disputed_markets
  • get_global_open_interest
  • get_global_stats
  • get_last_trade
  • get_live_orderbook
  • get_live_prices
Show 22 more tools
  • get_live_spread
  • get_market_data
  • get_market_info
  • get_market_open_interest
  • get_market_positions
  • get_market_resolution
  • get_market_revisions
  • get_oi_history
  • get_orderbook_trades
  • get_polymarket_event
  • get_price_history
  • get_recent_activity
  • get_subgraph_schema
  • get_top_traders
  • get_trader_profile
  • get_trader_usdc_flows
  • get_user_positions
  • get_v2_top_traders
  • list_polymarket_events
  • list_subgraphs
  • search_markets
  • search_markets_enriched

Not yet classified 1 · We could not tell from the name and description.

  • query_subgraph

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • GRAPH_API_KEY

Network hosts it talks to 6

  • clob.polymarket.com · found in code
  • gamma-api.polymarket.com · found in code
  • gateway.thegraph.com · found in code
  • github.com · found in code
  • glama.ai · found in code
  • thegraph.com · found in code

Tools (35)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • check_subgraph_freshness

    Report how far behind chainhead a subgraph is, by reading its _meta block. Worth calling before trusting any 'current' or 'latest' number, because a lagging subgraph returns stale data rather than an error — it succeeds, it is just answering about the past.

  • get_account_pnl

    Get a trader's P&L and performance metrics from the Beefy P&L subgraph

  • get_builder_activity

    Recent fills routed by one Polymarket CLOB V2 builder code, with that builder's aggregate totals. Use get_builder_leaderboard first to find a builder id. V2-era only.

  • get_builder_leaderboard

    Rank Polymarket CLOB V2 builders by routed volume, order count or fees. A 'builder' is the frontend/bot/integrator whose code is attached to a fill — this answers 'who is actually routing the flow', which no V1 subgraph can, because the V1 contracts never emitted it. V2-era only (from block 84902353, migration 2026-04-28).

  • get_clob_market

    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.

  • get_daily_stats

    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_disputed_markets

    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_global_open_interest

    Get the total open interest across all Polymarket markets — the aggregate USDC locked in outstanding positions platform-wide.

  • get_global_stats

    Get aggregate Polymarket platform statistics. Combines market counts from the Main subgraph with accurate volume/fee/trade data from the Orderbook subgraph.

  • get_last_trade

    Get the last trade price for a Polymarket outcome token from the CLOB.

  • get_live_orderbook

    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_live_prices

    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_spread

    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_market_data

    Get Polymarket market/condition data including outcomes. Defaults to the V2 Main subgraph; pass subgraph: "main" for legacy V1 / pre-2026-04-28 history.

  • get_market_info

    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.

Show 20 more tools
  • get_market_open_interest

    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_market_positions

    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_resolution

    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_market_revisions

    Get moderator revisions/updates for Polymarket markets. Shows when and how moderators intervened in market resolution.

  • get_oi_history

    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_orderbook_trades

    Get recent order fills from the Orderbook subgraph

  • get_polymarket_event

    Get a single Polymarket event with all its associated markets. An event groups related prediction markets under one topic.

  • get_price_history

    Get historical price data for a Polymarket outcome token. Returns time-series price points for charting and trend analysis.

  • get_recent_activity

    Get recent splits, merges, and redemptions from the Activity subgraph

  • get_subgraph_schema

    Get the full GraphQL schema (introspection) for a Polymarket subgraph

  • get_top_traders

    Get the top Polymarket traders ranked by realized P&L, win rate, or volume from the Beefy P&L subgraph.

  • get_trader_profile

    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_flows

    Get USDC deposit/withdrawal history for a trader. Shows inbound and outbound USDC transfers, useful for tracking when traders fund or withdraw from Polymarket.

  • get_user_positions

    Get a user's current positions from the Slimmed P&L subgraph. Falls back gracefully if indexers are behind.

  • get_v2_top_traders

    Top real traders on Polymarket CLOB V2 by volume or trade count, with the exchange contracts excluded. Use this rather than querying accounts directly: the V2 exchange is itself the `taker` when an order matches the book, so it accumulates an Account row and outranks every human by an order of magnitude. V2-era only (from block 84902353).

  • list_polymarket_events

    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.

  • list_subgraphs

    List all available Polymarket subgraphs with descriptions and key entities

  • query_subgraph

    Execute a custom GraphQL query against a Polymarket subgraph

  • search_markets

    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.

  • search_markets_enriched

    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.

Compare and alternatives

    Featured in

    Signals

    Stars
    4
    Forks
    3
    Open issues
    0
    Last commit
    Oct 15, 2026 (13 days ago)
    Last release
    Aug 9, 2026 (2 months ago)

    From GitHub (fetched Oct 24, 2026).

    Details

    Registry name
    io.github.PaulieB14/graph-polymarket-mcp
    Version
    1.4.0
    Auth
    API key
    Packages
    npm graph-polymarket-mcp
    License
    MIT
    Repository
    github.com/PaulieB14/graph-polymarket-mcp
    First seen
    Oct 24, 2026
    Last checked
    Oct 24, 2026
    Source
    Official MCP Registrygithub-graphql

    More from PaulieB14

    Cite this page

    Graph Polymarket MCP. Agent Mart. https://agentmart.dev/connectors/paulieb14-graph-polymarket-mcp (last updated 2026-10-24)