ClawHub

Graph Polymarket MCP

Query Polymarket prediction market data via The Graph subgraphs + Polymarket REST APIs (Gamma + CLOB) — 31 tools for market search, live prices, on-chain analytics, trader P&L, open interest, resolution status, and more.

Audits

Pending
ClawScanPass

Agentic behavior and permission review.

Static analysisReview

Pattern checks against bundled files.

VirusTotalPending

Multi-engine malware detections and file reputation.

Install

openclaw skills install graph-polymarket-mcp

Graph Polymarket MCP

Query Polymarket prediction market data via The Graph subgraphs and Polymarket REST APIs (Gamma + CLOB) — market search, live prices, order books, trader P&L, positions, open interest, resolution status, and trader profiles.

Tools

Polymarket REST API (no API key needed)

  • search_markets — Search markets by text query with filters (active, closed, sort by volume/liquidity)
  • get_market_info — Get detailed market metadata by slug or condition ID
  • list_polymarket_events — Browse events (groups of related markets) with tag/status filters
  • get_polymarket_event — Get a single event with all its associated markets
  • get_live_prices — Real-time CLOB prices for outcome tokens (buy/sell, single or batch)
  • get_live_spread — Bid-ask spread + midpoint for assessing market liquidity
  • get_live_orderbook — Full order book (all resting bids and asks) for a token
  • get_price_history — Historical price time-series (1m to max interval, configurable fidelity)
  • get_last_trade — Last trade price for an outcome token
  • get_clob_market — CLOB market details: token IDs, live prices, min order/tick sizes
  • search_markets_enriched — Power tool: search + auto-enrich with live CLOB prices AND on-chain resolution status

The Graph Subgraphs (requires GRAPH_API_KEY)

  • list_subgraphs — List all available Polymarket subgraphs with descriptions and key entities
  • get_subgraph_schema — Get the full GraphQL schema for a specific subgraph
  • query_subgraph — Execute a custom GraphQL query against any subgraph
  • get_market_data — Get market/condition data with outcomes and resolution status
  • get_global_stats — Platform stats: market counts, volume, fees, trades
  • get_account_pnl — Trader P&L and performance metrics (winRate, profitFactor, maxDrawdown)
  • get_top_traders — Leaderboard ranked by PnL, winRate, volume, or profitFactor
  • get_daily_stats — Daily volume, fees, trader counts, and market activity
  • get_market_positions — Top holders for a specific outcome token with their P&L
  • get_user_positions — A user's current token positions
  • get_recent_activity — Recent splits, merges, and redemptions
  • get_orderbook_trades — Recent order fills with maker/taker filtering
  • get_market_open_interest — Top markets ranked by USDC locked in positions
  • get_oi_history — Hourly OI snapshots for a specific market
  • get_global_open_interest — Total platform-wide open interest and market count
  • get_market_resolution — UMA oracle resolution status with filtering
  • get_disputed_markets — Markets disputed during oracle resolution
  • get_market_revisions — Moderator interventions and updates on market resolution
  • get_trader_profile — Full trader profile: first seen, CTF events, USDC flows
  • get_trader_usdc_flows — USDC deposit/withdrawal history with direction filtering

Requirements

  • Runtime: Node.js >= 18 (runs via npx)
  • Environment variables:
    • GRAPH_API_KEY (required for subgraph tools) — Free API key from The Graph Studio. Free tier: 100K queries/month.
    • REST API tools (search, prices, order books) work without any API key.

Install

GRAPH_API_KEY=your-key npx graph-polymarket-mcp

Network & Data Behavior

  • Subgraph tools make GraphQL requests to The Graph Gateway (gateway.thegraph.com) using your API key.
  • REST API tools query Polymarket's public endpoints (gamma-api.polymarket.com and clob.polymarket.com) directly — no authentication needed.
  • Eight subgraphs are queried: Main, Beefy P&L, Slimmed P&L, Activity, Orderbook, Open Interest, Resolution, and Traders.
  • No local database or persistent storage is used.
  • The SSE transport (--http / --http-only) starts a local HTTP server on port 3851 (configurable via MCP_HTTP_PORT env var).

Use Cases

  • Search and discover prediction markets by topic, category, or keyword
  • Get real-time prices, order books, and spreads for any market
  • Analyze price history and market trends
  • Get platform-wide stats, volume, and market rankings
  • Analyze trader P&L, performance metrics, and leaderboards
  • Track open interest trends and market positions
  • Monitor market resolution lifecycle and disputed markets
  • Run custom GraphQL queries against 8 specialized Polymarket subgraphs