MCP.Market

Graph Polymarket MCP server

by PaulieB14·io.github.PaulieB14/graph-polymarket-mcp·v1.4.0·4 stars
No reviews yet

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

B78/100grade B
Write a reviewInstall
What users say
No reviews yet
Be the first
Safety scan
B78/100

full report

Adoption
New

4 stars

Reviews

Write one

Nobody has reviewed Graph Polymarket yet.

If you have run it, two minutes of your experience saves the next person an afternoon.

Graph Polymarket tools (20, 1 write)

write = sends, deletes, buys or posts

Read from the package source without running it. The installed server may list more.

  • get_account_pnl

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

  • 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_market_data

    Get Polymarket market/condition data including outcomes and volumes from the Main subgraph

  • 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_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.

  • list_subgraphs

    List all available Polymarket subgraphs with descriptions and key entities

  • query_subgraphwrite action

    Execute a custom GraphQL query against a Polymarket subgraph

Public scan report

scanner v0.1.10 · 2026-09-28 · same rubric, same numbers if you re-run it

no findings
  • Code scan7 source files scanned25/25
  • –Live reliabilityno gateway calls yet and no remote to proben/a
  • –Tool poisoningtools not inspected (local package is not executed); not countedn/a
  • Auth qualitystatic API keys via environment variables6/15
  • Maintenancelast push 50 days ago12/15
  • Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
Overall 78/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

How Graph Polymarket compares

Against every graded MCP server, from our own scans and uptime checks. Updated after each scan run.

Safety score
78/100
higher than 57% of 48,255 servers
Tools
20
the typical server has 7
Tools that change things
5%
typical: 0%. Fewer write tools means less an agent can break
GitHub stars
4
more than 82% of 28,688 servers

What its tools let an agent do: 19 read · 1 change

Install Graph Polymarket in Claude Code, Cursor or VS Code

Runs npx -y graph-polymarket-mcp on your machine. Read the scan report first; the gateway never runs local packages.

claude mcp add graph-polymarket-mcp -- npx -y graph-polymarket-mcp
Add to Cursor

What the publisher says

From the Graph Polymarket repository's README, as published. We do not edit it. Read it on GitHub

graph-polymarket-mcp

MCP server for querying Polymarket prediction market data via The Graph subgraphs and Polymarket REST APIs.

Exposes 31 tools that AI agents (Claude, Cursor, etc.) can use to search markets, get real-time CLOB prices and order books, query on-chain data, trader P&L, positions, activity, open interest, market resolution status, and trader profiles.

v2.0.0 — adds 10 new tools powered by Polymarket's Gamma and CLOB APIs (inspired by polymarket-cli): market search, event browsing, live prices, spreads, order books, price history, and more. No API key needed for these tools — they hit Polymarket's public REST endpoints directly.

Published to the MCP Registry as io.github.PaulieB14/graph-polymarket-mcp

Prerequisites

You need a free Graph API key (takes ~2 minutes):

  1. Go to The Graph Studio
  2. Connect your wallet (MetaMask, WalletConnect, etc.)
  3. Click "API Keys" in the sidebar and create one
  4. Free tier includes 100,000 queries/month

Installation

npm install -g graph-polymarket-mcp

Or use directly with npx:

npx graph-polymarket-mcp

Configuration

Claude Desktop

Add to your claudedesktopconfig.json:

{
  "mcpServers": {
    "graph-polymarket": {
      "command": "npx",
      "args": ["-y", "graph-polymarket-mcp"],
      "env": {
        "GRAPH_API_KEY": "your-api-key-here"
      }
    }
  }
}

Claude Code

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

Set the environment variable GRAPHAPIKEY before running.

Cursor / Other MCP Clients

Use the stdio transport with npx graph-polymarket-mcp as the command, passing GRAPHAPIKEY as an environment variable.

OpenClaw / Remote Agents (SSE)

The SSE transport has no authentication. Anyone who can reach the port can call every tool,

and those calls spend your GRAPHAPIKEY quota. --http binds 0.0.0.0 inside a container,

so publish it to 127.0.0.1 on the host and put a reverse proxy with TLS and auth in front of

anything reachable off-box. For local agents, prefer the default stdio transport — it has no

network surface at all.

Start the server with the HTTP transport:

# Dual transport — stdio + SSE on port 3851
GRAPH_API_KEY=your-key npx graph-polymarket-mcp --http

# SSE only (for remote/server deployments)
GRAPH_API_KEY=your-key npx graph-polymarket-mcp --http-only

# Custom port
MCP_HTTP_PORT=4000 GRAPH_API_KEY=your-key npx graph-polymarket-mcp --http

Then point your agent at the SSE endpoint:

{
  "mcpServers": {
    "graph-polymarket": {
      "url": "http://localhost:3851/sse"
    }
  }
}

Transport Modes

Shortened. The full README is on GitHub.

Nothing above is checked by us. What we check is on the safety report.

Graph Polymarket: common questions

Is Graph Polymarket MCP server safe?
Mostly: it is graded B (78/100). Read the Graph Polymarket safety report
How do I install Graph Polymarket?
It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
Does Graph Polymarket need an API key?
Yes. The registry entry asks for GRAPH_API_KEY.
Is Graph Polymarket maintained?
The last commit was 87 days ago (2026-08-09). The latest release is v1.4.0.
What can I use instead of Graph Polymarket?
Servers from other publishers that do the same job: CCXT MCP server.
How does Graph Polymarket compare with other MCP servers?
safety score 78/100 (higher than 57% of 48,255 servers); tools 20 (the typical server has 7); tools that change things 5% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.

Alternatives to Graph Polymarket

Same job from other publishers: the closest match first, then the best rated.

  • CCXT
    Official CCXT MCP server - Market data and trading across 100+ exchanges and prediction markets
    A

More from PaulieB14 →