graph-polymarket-mcp

graph-polymarket-mcp 是一个用于查询 Polymarket 预测市场数据的 MCP 服务器，通过 The Graph 子图与 Polymarket REST API（Gamma 与 CLOB）向 AI 智能体（如 Claude、Cursor 等）暴露 31 个工具。

主要能力

市场发现（Gamma API）：搜索预测市场、浏览活跃事件、按交易量排序、按分类筛选等。
实时交易数据（CLOB API）：获取当前价格、完整订单簿、买卖价差、价格历史等。无需 Graph API Key，直接访问 Polymarket 公开 REST 端点。
链上分析（The Graph 子图）：查询全局统计、最新订单簿成交、指定地址的持仓、交易者盈亏、未平仓合约、争议市场、顶级交易者、钱包完整交易历史等。此部分需要 GRAPH_API_KEY。

版本与迁移说明

v2.0.0 新增 10 个由 Polymarket Gamma 和 CLOB API 驱动的工具（灵感来自 polymarket-cli）。
Polymarket 于 2026-04-28 迁移到 V2 交易所合约。相关工具读取的 V2 子图从区块 84902353 开始索引，不包含迁移前的历史数据；V1 与 V2 是不同时代，而非新旧版本。
V2 新增了构建者归因（builder attribution）能力：每笔 V2 成交都携带路由该交易的前端、机器人或集成商的 builder code。截至 2026-08-08，共有 3,325 个 builder。
工具处理了两个常见陷阱：V2 交易所合约会以 Account 行出现（因为交易所是订单撮合时的 taker），简单按账户排名会把 0xe111…996b（1.76 亿笔成交）和 0xe222…0f59（4,100 万笔成交）排在所有人类用户之上，get_v2_top_traders 会排除这些地址；此外 v2_main 仍在同步，会返回过期数据而非报错，check_subgraph_freshness 可在信任数据前检查其陈旧程度。
选择查询时代：全时段或 2026-04-28 之前的数据使用 V1；迁移后的活动或任何与 builder 相关的问题使用 V2。beefy_pnl 保留了 V2 P&L 所没有的对冲基金指标（winRate、profitFactor、maxDrawdown、每日序列），因此交易者质量评分仍在 V1 上进行。

使用方式

使用前需获取免费的 Graph API Key：前往 The Graph Studio，连接钱包（MetaMask、WalletConnect 等），在侧边栏点击 "API Keys" 并创建一个；免费额度为每月 100,000 次查询。
可直接通过 npx 使用：在运行前设置环境变量 GRAPH_API_KEY。
Claude Desktop：添加到 claude_desktop_config.json，并设置环境变量 GRAPH_API_KEY。
Cursor / 其他 MCP 客户端：使用 stdio 传输，命令为 npx graph-polymarket-mcp，并将 GRAPH_API_KEY 作为环境变量传入。
OpenClaw / 远程智能体（SSE）：SSE 传输没有身份验证，任何能访问该端口的人都能调用所有工具，并消耗你的 GRAPH_API_KEY 配额。--http 在容器内绑定 0.0.0.0，因此应将主机端口发布到 127.0.0.1，并在任何可从外部访问的端点前放置带 TLS 和认证的反向代理。对于本地智能体，建议优先使用默认的 stdio 传输，它完全没有网络暴露面。
使用 HTTP 传输启动服务器后，将智能体指向 SSE 端点。当 HTTP 传输激活时，可通过 http://localhost:3851/health 访问 /health 端点。

示例查询（连接后 AI 智能体可执行）

市场发现（Gamma API）：搜索关于 AI 的预测市场、查看当前最活跃的 Polymarket 事件、查找按交易量排序的 2024 年选举市场、查看 'crypto' 分类下的市场。
实时交易数据（CLOB API）：查询 Trump YES 代币当前价格、查看完整订单簿、查看买卖价差、查看过去一周的价格历史。
链上分析（The Graph）：查看 Polymarket 全局统计、最新 20 笔订单簿成交、指定地址的持仓（会标记钱包是否仅通过 OB 买入进入）、指定交易者的盈亏、当前未平仓合约最多的市场（会标记已结算市场上的死钱 OI）、争议市场、顶级交易者（会标记任何 Beefy P&L 未捕捉到的 OB 交易量）、指定钱包的完整交易历史（包含 OB 成交和进入类型分类）。

限制

工具介绍