graph-polymarket-mcp

finance MCP Server

MCP server for Polymarket prediction markets — 31 tools combining The Graph subgraphs + Polymarket REST APIs (Gamma + CLOB) for market search, live prices, order books, trader P&L, open interest, and resolution data

Install Ready
financefinance
5 views3 stars2 forksv2.0.0MIT

Why This Matters

Discovered via unknown and last synced 2mo ago.

Install Ready
Source
unknown
Stars
3
Last synced
2mo ago
Install
Instructions detected

Install

1. Install the package

npx -y graph-polymarket-mcp

2. Add to claude_desktop_config.json

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

Config file location: ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) / %APPDATA%\Claude\claude_desktop_config.json (Windows)

43
Tools
0
Resources
0
Prompts
Standard I/O
Transport

Available Tools (43)

get_market_data

Get market/condition data with outcomes and resolution status

Resolution

`QmZnnrHWCB1Mb8dxxXDxfComjNdaGyRC66W8derjn3XDPg`

get_clob_market

CLOB market details: token IDs, live prices, min order/tick sizes

QmZAYiMeZiWC7ZjdWepek7hy1jbcW3ngimBF9ibTiTtwQU

Minimal position data

Main

`QmdyCguLEisTtQFveEkvMhTH7UzjyhnrF9kpvhYeG4QX8a`

get_market_resolution

UMA oracle resolution status with filtering by status

get_disputed_markets

Markets disputed during oracle resolution (high-signal events)

get_top_traders

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.

get_polymarket_event

Get a single event with all its associated markets

Activity

`Qmf3qPUsfQ8et6E3QNBmuXXKqUJi91mo5zbsaTkQrSnMAP`

get_live_prices

Real-time CLOB prices for outcome tokens (buy/sell, single or batch)

get_user_positions

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.

QmbHwcGkumWdyTK2jYWXV3vX4WyinftEGbuwi7hDkhPWqG

Comprehensive P&L tracking

get_daily_stats

Daily volume, fees, trader counts, and market activity (1–90 days)

get_subgraph_schema

Get the full GraphQL schema for a specific subgraph

get_live_orderbook

Full order book (all resting bids and asks) for a token

stdio

Claude Desktop, Cursor, Claude Code

Invocation

Transports

get_account_pnl

Get a trader's P&L and performance metrics (winRate, profitFactor, maxDrawdown)

get_global_open_interest

Total platform-wide open interest and market count

list_polymarket_events

Browse events (groups of related markets) with tag/status filters

Name

IPFS Hash

list_subgraphs

List all available Polymarket subgraphs with descriptions and key entities

get_market_positions

Top holders for a specific outcome token with their P&L

get_market_revisions

Moderator interventions and updates on market resolution

get_live_spread

Bid-ask spread + midpoint for assessing market liquidity

query_subgraph

Execute a custom GraphQL query against any subgraph

get_recent_activity

Unified chronological feed interleaving splits, merges, and redemptions with orderbook fills. Supports optional address filter.

get_trader_usdc_flows

USDC deposit/withdrawal history with direction filtering

get_price_history

Historical price time-series (1m to max interval, configurable fidelity)

Orderbook

`QmVGA9vvNZtEquVzDpw8wnTFDxVjB6mavTRMTrKuUBhi4t`

Tool

Description

get_orderbook_trades

Get recent order fills with maker/taker filtering

get_last_trade

Last trade price for an outcome token

QmbT2MmS2VGbGihiTUmWk6GMc2QYqoT9ZhiupUicYMWt6H

Per-market and global OI with hourly snapshots

get_global_stats

Get platform stats: market counts + real volume/fees/trades

get_oi_history

Hourly OI snapshots for a specific market (for charting trends)

get_market_info

Get detailed market metadata by slug or condition ID

search_markets_enriched

**Power tool**: search + auto-enrich with live CLOB prices AND on-chain resolution status in one call

Traders

`QmfT4YQwFfAi77hrC2JH3JiPF7C4nEn27UQRGNpSpUupqn`

get_market_open_interest

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).

get_trader_profile

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.

search_markets

Search markets by text query with filters (active, closed, sort by volume/liquidity)