Graph Polymarket MCP

MCP server for querying Polymarket prediction market data via The Graph subgraphs and Polymarket REST APIs. Its 35 documented tools cover market, subgraph, markets, live. It runs locally over stdio via the published package.

People connecting API integration tools to Claude, Cursor, VS Code, or another MCP client. The project is written in JavaScript.

VERIFIED ACTIVE

LAST COMMIT 2026-08-09 · ★ 3 · #75 OF 250 MAINTAINED API INTEGRATION · VERIFIED 2026-08-25

MIT · JavaScript servers · how we verify → /methodology

01 · Install Graph Polymarket MCP

before you install - you'll need

Set GRAPH_API_KEY, MCP_HTTP_PORT before connecting.

Claude Code

claude mcp add paulieb14-graph-polymarket-mcp -- npx -y graph-polymarket-mcp

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "paulieb14-graph-polymarket-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "graph-polymarket-mcp"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license MIT - declared in the repository

npm package graph-polymarket-mcp - unscoped; check the name against the project README before installing

registry namespace io.github.PaulieB14 is GitHub-verified and matches the repo owner

03 · What Graph Polymarket MCP can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can list all available Polymarket subgraphs with descriptions and key entities, get the full GraphQL schema for a specific subgraph, execute a custom GraphQL query against any subgraph, and get market/condition data with outcomes and resolution status.

Capability map

Tools grouped from the project's README - what Graph Polymarket MCP lets an agent do.

read & search

9 tools - e.g. List all available Polymarket subgraphs with descriptions and key entities; Get a trader's P&L and performance metrics (winRate, profitFactor, maxDrawdown); Daily volume, fees, trader counts, and market…

list_subgraphs · get_account_pnl · get_daily_stats · get_user_positions · get_recent_activity · get_orderbook_trades…

Market

7 tools - e.g. Get market/condition data with outcomes and resolution status; Top holders for a specific outcome token with their P Top markets ranked by USDC locked in outstanding positions. Cross-refs Main subgraph to…

get_market_data · get_market_positions · get_market_open_interest · get_market_resolution · get_market_revisions · get_market_info…

Subgraph

3 tools - e.g. Get the full GraphQL schema for a specific subgraph; Execute a custom GraphQL query against any subgraph; How far behind chainhead any subgraph is, read live from its _meta block

get_subgraph_schema · query_subgraph · check_subgraph_freshness

Markets

3 tools - e.g. Markets disputed during oracle resolution (high-signal events); Search markets by text query with filters (active, closed, sort by volume/liquidity); Power tool: search + auto-enrich with live CLOB prices…

get_disputed_markets · search_markets · search_markets_enriched

Live

3 tools - e.g. Real-time CLOB prices for outcome tokens (buy/sell, single or batch); Bid-ask spread + midpoint for assessing market liquidity; Full order book (all resting bids and asks) for a token

get_live_prices · get_live_spread · get_live_orderbook

Global

2 tools - e.g. Get platform stats: market counts + real volume/fees/trades; Total platform-wide open interest and market count

get_global_stats · get_global_open_interest

Top

2 tools - e.g. 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 ; Top real V2 traders, with the exchange…

get_top_traders · get_v2_top_traders

Trader

2 tools - e.g. Full trader profile combining CTF events and USDC flows with Orderbook fills. Classifies wallet as hybrid / orderbook-only / split-collateral-only and warns whe; USDC deposit/withdrawal history with…

get_trader_profile · get_trader_usdc_flows

Latest releases

v2.1.2 · 2026-08-09

Response to the ClawHub security audit of 2.1.1. One finding was a false positive; four were worth acting on. · 9 vulnerabilities → 0 · npm audit now reports 0 vulnerabilities, down from 9 (6 high). The cleared…

v2.1.1 · 2026-08-08

Adds Paul's four Polymarket CLOB V2 subgraphs alongside the existing V1 registry. 35 tools total - the v2.0.0 REST surface (Gamma + CLOB) is unchanged. · V1 and V2 are different eras, not old and new: the V2 subgraphs…

v2.0.0 · 2026-03-29

What's New · Integrated Polymarket's public REST APIs (inspired by polymarket-cli) alongside the existing Graph subgraph tools. 31 tools total, up from 20. · 11 New Tools (no API key needed) · Market Discovery (Gamma…

04 · Who maintains Graph Polymarket MCP

graph-polymarket-mcp is maintained by paulieb14. We track 3 MCP servers from paulieb14 - 3 actively maintained, 5 combined GitHub stars, oldest repo from Mar 2026. Full record: all servers from paulieb14.

graph-aave-mcp AAVE V2/V3 lending & governance MCP - 7 chains via The Graph subgraphs ★ 2

05 · Facts

repository: github.com/paulieb14/graph-polymarket-mcp
category: API integration - ranked #75 of 250 actively-maintained API integration servers as of 2026-08-25.
release cadence: 2 releases in the last 90 days (latest 2026-08-09)
registry: io.github.PaulieB14/graph-polymarket-mcp (active, first published 2026-03-01 · 2 versions)
packages: npm:graph-polymarket-mcp

06 · Graph Polymarket MCP FAQ

Is Graph Polymarket MCP still maintained?

Yes - as of 2026-08-25, its last commit was 2026-08-09 and it shipped 2 releases in the last 90 days. We re-verify nightly.

What can Graph Polymarket MCP do?

How do I install Graph Polymarket MCP?

Run `npx -y graph-polymarket-mcp`. The README documents 2 environment variables (GRAPH_API_KEY, MCP_HTTP_PORT) to set first. Set GRAPH_API_KEY, MCP_HTTP_PORT before connecting. You can also paste the ready-made client config above.

Does Graph Polymarket MCP run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Graph Polymarket MCP

Alternatives to Graph Polymarket MCP

Maintained API integration servers if Graph Polymarket MCP isn't the fit.

More API integration MCP servers · Specrun · Ris · Krs Poland MCP Server · Opendock · Postman MCP Server

More JavaScript MCP servers · Paypal MCP Server · DugganUSA CLI - Local STDIO MCP · Roast My Design System · Pendpost · Multi Scraper MCP · see all