Polymarket Mcp Server

Polymarket MCP 服务

一个 Model Context Protocol (MCP) 服务，让 Claude 及任何 MCP 客户端都能以只读方式访问规模最大的预测市场 Polymarket。搜索市场、获取实时订单簿和价格历史、查看任意钱包的持仓，并按实际每美元报价收益对流动性奖励市场进行排名。

无需 API 密钥，无需钱包，也无需注册。 每个工具都通过 Polymarket 的公共 API 运行，因此添加到 Claude 后即可使用。

"Claude, find me Polymarket markets paying the most liquidity rewards with the least competition."

---

为什么要开发这个工具

大多数预测市场工具止步于“列出市场”。这个服务还提供了做市商真正关心的功能：list_reward_markets 根据 每日奖励池 ÷ 订单簿竞争 对 Polymarket 的做市奖励计划进行排名，找出挂单流动性收益率最高的市场，而不只是列出有哪些市场。

本服务基于官方 @modelcontextprotocol/sdk 构建，使用 Zod 验证，并提供优雅的错误响应和简短的进程内缓存，让 Claude 在同一轮对话中重复查询时依然快速响应。

60 秒快速上手

Claude Code

claude mcp add polymarket -- npx -y polymarket-mcp-server

Claude Desktop

将以下内容添加到你的 claude_desktop_config.json （macOS 上的 ~/Library/Application Support/Claude/，Windows 上的 %APPDATA%\Claude\）：

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

重启 Claude Desktop，工具就会显示在 🔌 菜单下。就是这么简单，无需配置任何凭据。

Cursor / 其他 MCP 客户端

让任意 MCP 客户端使用 stdio 命令 npx -y polymarket-mcp-server。

工具

工具	功能
search_markets	在事件和市场中进行全文搜索 → 返回问题、价格、流动性、交易量和代币 ID。
get_market	获取单个市场的完整详情（按 ID 或 slug 查询），并补充各结果的实时中间价和价差。
get_orderbook	获取结果代币的实时买单和卖单，并计算最佳买价/卖价、中间价和价差。
get_price_history	获取历史概率时间序列及汇总统计；较长时间范围的数据会自动降采样。
list_reward_markets	差异化功能。 按奖励池 ÷ 竞争程度对提供做市商奖励的市场进行排名。
get_trader_activity	查看任意钱包的公开持仓、近期活动或投资组合总价值（用于追踪巨鲸）。

示例：奖励市场排名

You:    Which Polymarket reward markets have the best pool-to-competition right now?
Claude: (calls list_reward_markets)
        1. "Will Roberto Sánchez Palomino win the 2026 Peruvian presidential election?"
           daily pool $2,000 · max spread 3.5¢ · min size 20 · competition $40.7k · score 0.049
        ...

score = dailyRewardPool / (competitionNotional + 1)，其中 competitionNotional 是订单簿中已挂出、且位于评分价差范围内的名义流动性（Σ 价格·数量），可用于估算奖励竞争有多激烈。

工作原理

Claude / MCP client  ──stdio──▶  polymarket-mcp-server
                                       │
                 ┌─────────────────────┼─────────────────────┐
                 ▼                     ▼                     ▼
          Gamma API            CLOB API              Data API
   (markets, search)   (books, prices, rewards)  (wallet positions)

• 只读且无需凭据 — 只调用公共端点。
• 每个工具的输入都经过 Zod 验证；格式错误的输入会被妥善拒绝。
• 优雅处理错误 — 上游故障会以易读的消息返回，不会暴露原始堆栈跟踪。
• 热门查询使用较短的 TTL 缓存（60s），以遵守公共 API 的速率限制。

本地开发

git clone https://github.com/Birantx/polymarket-mcp-server.git
cd polymarket-mcp-server
npm install
npm run build
npm test          # end-to-end smoke test against the live public APIs

直接通过 stdio 运行：

node dist/index.js

路线图

• v0.1（当前版本）：只读工具，无需凭据。
• v0.2（按需推出）：通过 CLOB 客户端可选地进行身份验证后下单，并要求显式配置密钥。

免责声明

这是一个非官方的社区开发工具，与 Polymarket 无关。本工具为只读工具，仅供参考。此处内容均不构成财务建议。预测市场可能在你所在的司法管辖区受到限制。

许可证

MIT © 2026 — 详见 LICENSE。

---

关键词：Polymarket MCP 服务、Model Context Protocol、Claude、Anthropic、预测市场、做市、流动性奖励、MCP 工具、AI 交易研究。