功能描述

Query Polymarket prediction market data via The Graph subgraphs + Polymarket REST APIs (Gamma + CLOB) — 31 tools for market search, live prices, on-chain ana...

使用说明 (SKILL.md)

Graph Polymarket MCP

Name: Graph Polymarket MCP
Author: paulieb14

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

安全使用建议

This skill appears to do what it claims: query The Graph subgraphs (using the provided IPFS hashes) and call Polymarket's public REST APIs. Things to consider before installing: - GRAPH_API_KEY: The Graph API key is used only for subgraph requests to gateway.thegraph.com. If you don't need subgraph tools (only the REST/Gamma/CLOB tools), you may not want to provide an API key. Note: some metadata (server.json) marks the key required while smithery.yaml treats it as optional — confirm how your MCP client/registry will enforce this. - Exposure & quotas: the key will be sent to gateway.thegraph.com in request URLs; use a dedicated/low-privilege key (free tier) with limited quota if possible. - Network & local server: running with --http or --http-only starts an SSE HTTP server (default port 3851) to accept remote agent connections. Only enable this if you intend to expose the local endpoint and are comfortable with a listening process. - Privacy: several tools accept Ethereum addresses and return detailed per-trader P&L and on-chain activity. Consider privacy implications of providing or querying addresses in environments where results may be logged or sent to other systems. - Supply-chain check: the package depends on @modelcontextprotocol/sdk and common Node packages. If you want extra assurance, inspect the published npm package (version 2.0.0/2.0.1) and its upstream repository (github.com/PaulieB14/graph-polymarket-mcp) before running npx/npm install. If you only need REST-based market discovery and live prices, you can avoid providing a Graph API key and still use many features — but check how your MCP client enforces the environment variable requirement (registry metadata inconsistency noted).

功能分析

Type: OpenClaw Skill Name: graph-polymarket-mcp Version: 2.0.1 The graph-polymarket-mcp skill bundle is a legitimate Model Context Protocol (MCP) server designed to provide AI agents with access to Polymarket prediction market data. It implements 31 tools for searching markets, retrieving real-time prices via CLOB/Gamma APIs, and performing on-chain analytics using The Graph subgraphs. The code follows standard security practices, uses well-known dependencies, and communicates only with official endpoints (gateway.thegraph.com, gamma-api.polymarket.com, and clob.polymarket.com). No evidence of data exfiltration, malicious execution, or harmful prompt injection was found.

能力评估

✓ Purpose & Capability

Name/description (Polymarket + The Graph) match the actual behavior: the code calls gateway.thegraph.com with an API key and calls Polymarket's public Gamma/CLOB REST endpoints. Required binary (node) and the single env var (GRAPH_API_KEY) align with the subgraph querying capability.

✓ Instruction Scope

SKILL.md and the code limit activity to querying The Graph subgraphs (via provided IPFS hashes) and public Polymarket REST endpoints. Tools let callers supply GraphQL queries and wallet addresses (for on-chain analytics) but there are no instructions to read arbitrary local files, other environment variables, or to exfiltrate data to unexpected endpoints.

ℹ Install Mechanism

The skill bundle contains source and an npm/package.json and is intended to be run via npx/npm. There is no separate download-from-arbitrary-URL install step. Running npx/npm will pull the package from the npm registry (normal) — review the package version on npm/github before running if you want stronger assurance.

⚠ Credentials

Only one credential is requested (GRAPH_API_KEY), which is appropriate for The Graph gateway usage. However metadata is inconsistent: SKILL.md/README and src.graphClient.ts treat the key as required for subgraph queries, server.json marks GRAPH_API_KEY as required, but smithery.yaml's config treats it as optional. This could lead to the registry/installer requiring an API key even if the user only wants the REST-only tools (which do not need a key). Requiring a key unnecessarily increases exposure of that secret.

✓ Persistence & Privilege

The skill does not request always:true and does not modify other skills. It can run an SSE HTTP server (default port 3851) when invoked with --http/--http-only; that is normal for MCP servers but means the process may listen on a local port if you enable HTTP transport.

版本历史

v2.0.1

Fix display name. 31 tools: market search, live CLOB prices, order books, spreads, price history, events + 20 on-chain subgraph analytics tools.

v2.0.0

Add 11 Polymarket REST API tools (Gamma + CLOB): market search, live prices, order books, spreads, price history, events. No API key needed for REST tools. GRAPH_API_KEY required only for subgraph tools. 31 total tools.

v1.3.0

- Major UX and documentation update: plain-language tool descriptions, new use cases, and improved onboarding. - No authentication is required to start; setup instructions made clearer. - SKILL.md and README.md overhauled for clarity—includes table of all 20 tools with concise summaries. - Security, privacy, and trust details now highlighted, including explicit endpoint disclosure. - Metadata and formatting improved for easier agent integration and discovery.

v1.5.2

Add OpenClaw YAML frontmatter with GRAPH_API_KEY gating for agent discovery

v1.5.1

- Added detailed requirements section, specifying Node.js version and the need for a `GRAPH_API_KEY` for The Graph Studio. - Installation command updated to include setting the `GRAPH_API_KEY` environment variable. - New "Network & Data Behavior" section describes API usage, queried subgraphs, and local server options. - No changes to tools, endpoints, or use cases. Documentation updates only.

v1.5.0

Version 1.5.0 - Expanded skill capabilities to cover comprehensive Polymarket data via The Graph subgraphs. - Added support for trader-level analytics: P&L, win rate, leaderboards, and detailed profiles. - Introduced tools for tracking open interest, market disputes, moderator revisions, and orderbook trades. - Enables real-time and historical market/platform stats, including volume, fees, and activity. - Now supports custom GraphQL queries across multiple specialized Polymarket subgraphs.

元数据

Slug graph-polymarket-mcp

版本 2.0.1

许可证 MIT-0

累计安装 0

当前安装数 0

历史版本数 6

常见问题