Polymarket Scan MCP

PolymarketScan MCP 服务器

来自 Polymarket.com 预测市场的只读数据，供 AI 助手使用。连接 ChatGPT、Claude、Grok、Cursor、Claude Code 或任何 MCP 客户端，获取市场隐含概率（赔率）、价格历史、最大波动、热门市场、大额交易、买卖流向、公开交易者统计及相关新闻。

• 无需账户、API 密钥或 OAuth。 每个工具都是公开且只读的。
• 只读。 这些工具无法下单、更改或取消订单、转移资金或访问任何账户。
• 版本： 2.0.0（2026 年 10 月）。协议：基于 Streamable HTTP 的 MCP（无状态，JSON 响应）。

端点

https://mcp.polymarketscan.org/mcp

原始地址仍然有效并提供相同的服务器：

https://gzydspfquuaudqeztorw.supabase.co/functions/v1/mcp-server/mcp

工具（11 个）

您的 MCP 客户端会从服务器读取每个工具的完整输入和输出模式（tools/list）。除标记为必填的输入外，所有输入均为可选。

search_markets（搜索预测市场）

搜索开放的 Polymarket.com 市场并返回最接近的匹配项，每个匹配项最多包含六个结果的市场隐含概率、24 小时变化和交易量。

• 输入： query（必填）：用通俗语言描述的事件、人物、团队、资产或问题，最多 200 个字符。limit：1 到 10，默认 5。
• 说明： 仅限开放市场。查询命中的结果排在前面，然后是领先结果（或价格阶梯中最接近 50% 的档位）。如需查看某个市场的完整结果列表、规则和状态，请使用 get_market_odds。
• 可尝试提问： “美联储下次利率决定的赔率是多少？”

get_market_odds（获取市场赔率）

完整查看一个市场或事件：每个结果的概率和 24 小时变化（最多 40 个结果，外加总数）、交易量、流动性、结束日期、状态、解决规则和来源，以及已解决时的结果。

• 输入： market（必填）：市场或事件 slug、polymarket.com 或 polymarketscan.org 链接、条件 ID（0x + 64 位十六进制），或用通俗语言描述的市场。
• 说明： 适用于开放、已关闭和已解决的市场。互斥结果按概率排序。如果没有匹配项，则返回最多 3 个最接近的开放市场作为替代。
• 可尝试提问： “显示 2028 年总统大选中每位候选人的胜算。”

get_price_history（获取价格历史）

某个结果的概率在时间范围内的变化：开始和结束、百分点变化、最高和最低，以及图表。

• 输入： market（必填）：同 get_market_odds。outcome：要绘制图表的结果，如“是”或候选人姓名；默认为多结果事件中领先的开放结果，或单一市场的第一个结果。range：1d、1w、1m、3m 或 all，默认 1w。
• 说明： 价格来自 Polymarket.com 的订单簿历史。冷清市场的缺口不予填补。对于已关闭或已解决的市场，时间范围在交易关闭时结束。
• 可尝试提问： “美国经济衰退的赔率这个月是如何变化的？”

get_market_movers（获取最大市场波动）

24 小时内概率变化最大（以百分点计）的开放市场，包括发生波动的结果、其当前概率和 24 小时交易量；每个事件最多两个。

• 输入： direction：up、down 或 both，默认 both。category：politics、elections、geopolitics、world、economy、finance、crypto、tech、culture、sports、esports、weather 或 science 之一；省略则涵盖所有类别。limit：1 到 20，默认 10。
• 说明： 涵盖 300 个交易最活跃的市场（指定类别时按类别计算），且 24 小时内交易额至少为 1 万美元。定价在 1% 或以下、99% 或以上的市场因实际上已见分晓而被排除。个人体育和电竞比赛（单场比赛及其分差和总分盘口，无论即将开始还是进行中）被排除，除非类别为 sports 或 esports；赛季或锦标赛冠军等期货类市场则保留。
• 可尝试提问： “今天哪些预测市场波动最大？”

get_trending_markets（获取热门市场）

过去 24 小时内交易量最大的开放事件，每个事件最多包含四个结果的概率（领先结果，或价格阶梯中最接近 50% 的档位）、24 小时变化和交易量。

• 输入： category：与 get_market_movers 相同的值；省略则涵盖所有类别。limit：1 到 20，默认 8。
• 说明： 看起来已见分晓的事件（某个结果达到 99% 或以上）以及比赛的次要道具盘口被排除。个人体育和电竞比赛（单场比赛，无论即将开始还是进行中）被排除，除非类别为 sports 或 esports；赛季或锦标赛冠军等期货类市场则保留。
• 可尝试提问： “Polymarket 上加密货币领域有什么热门？”

get_whale_trades（获取大额交易）

来自 Polymarket.com 公共交易流的最新大额交易，按金额从大到小排列，包含时间、方向、结果、美元金额、股数、价格、市场以及交易者的钱包地址和公开名称。

• 输入： min_usd：最小交易金额（美元），1,000 到 1,000,000，默认 10,000。market：限定为某个市场或事件（slug、polymarket.com 或 polymarketscan.org 链接、条件 ID，或几个关键词）；省略则涵盖所有市场。hours：回溯时间范围，1 到 168，默认 24。limit：1 到 50，默认 15。
• 说明： 涵盖所有市场，成交价在 99 美分或以上、1 美分或以下（实际上已见分晓的市场）的成交被排除。每笔成交只计一次；美元金额为股数乘以价格。如果交易流过于繁忙而无法扫描整个时间窗口，结果会说明实际覆盖的范围。
• 可尝试提问： “显示过去 24 小时内 Polymarket 上超过 5 万美元的交易。”

get_market_flow（获取市场流向）

谁在买入和卖出某个市场：每个结果的买入、卖出和净额美元金额、交易笔数、最多 8 笔最大交易以及每个结果最多 5 个最大持有者。

• 输入： market（必填）：同 get_market_odds。hours：回溯时间范围，1 到 168，默认 24。
• 说明： 对于多结果事件，使用领先的开放结果（对于价格阶梯，使用交易最活跃的开放档位）并会注明。美元总额每笔成交只计一次（按吃单方计算），因此约为 Polymarket.com 头条所显示的双边交易量的一半。在非常繁忙的市场中，小笔成交可能被省略以适配整个时间窗口；结果会注明这一点。
• 可尝试提问： “谁在买入比特币 15 万美元的市场？”

get_leaderboard（获取交易者排行榜）

Polymarket.com 按利润或交易量排名的交易者排行榜：排名、完整钱包地址、公开显示名称、利润和美元交易量，附个人主页链接。

• 输入： metric：profit 或 volume，默认 profit。period：day（自 00:00 UTC 起）、week（7 天）、month（30 天）或 all，默认 month。category：sports、politics、crypto、economics、finance、tech、culture、esports、weather 或 mentions 之一；省略则涵盖所有市场。limit：1 到 25，默认 10。
• 说明： 日、周、月利润包含按当前价格计算的未平仓头寸；历史总利润仅为已实现利润。Polymarket 不发布按类别的美元交易量，因此类别排行榜中该字段留空。
• 可尝试提问： “本月按利润排名的 Polymarket 顶级交易者是谁？”

get_trader_profile（获取交易者资料）

单个交易者的公开统计：显示名称、历史已实现利润和交易量、投资组合价值、未平仓头寸、交易过的市场，以及最多 5 个最大头寸和 8 笔最新交易。

• 输入： trader（必填）：完整的 0x 钱包地址（42 个字符）、polymarket.com 个人主页链接、@用户名或用户名。
• 说明： 用户名尽可能精确匹配；否则使用最接近的公开资料并在结果中注明。近期交易指金额为 1 美元或以上的交易。该工具不说明谁控制某个钱包。
• 可尝试提问： “查询这位 Polymarket 交易者：0x…”

get_trader_positions（获取交易者头寸）

交易者最多 50 个未平仓头寸，包含股数、平均价格和当前价格、价值以及未实现盈亏，外加总数和投资组合价值。

• 输入： trader（必填）：同 get_trader_profile。sort：value（当前价值最大者优先）或 pnl（未实现收益最大者优先），默认 value。limit：1 到 50，默认 20。
• 说明： 价值低于 1 美元的头寸以及等待赎回的已解决头寸不在列表中。
• 可尝试提问： “这位交易者最大的未平仓头寸是什么？”

get_market_news（获取市场新闻）

过去 14 天内关于某个市场或话题的最多 10 条头条新闻，包含媒体来源、发布时间和链接，来自 PolymarketScan 聚合主要媒体的新闻流。

• 输入： market：市场或事件 slug、polymarket.com 或 polymarketscan.org 链接，或条件 ID；通俗语言输入视为话题。query：话题关键词，如“比特币 ETF”；与市场一起使用时，仅保留该市场新闻中提及这些关键词的内容。limit：1 到 10，默认 5。提供市场、查询词或两者皆可。
• 说明： 不是完整的网络搜索：不返回文章正文，对于小众市场可能找不到任何内容。
• 可尝试提问： “美联储决议市场的波动背后有新闻吗？”

结果

• 单位 在所有工具中保持一致：概率为 0 到 1，价格变化以百分点计，价格以美分计，金额以美元计，股数以“股”标注。null 值表示该数据不可用，绝不表示零。钱包地址均为完整小写地址，因此结果可直接传入交易者工具。
• 页脚。 每个结果的文本以“来源：Polymarket.com via PolymarketScan。仅供参考，不构成财务建议。”结尾。涉及交易或头寸的结果（get_whale_trades、get_market_flow、get_leaderboard、get_trader_profile、get_trader_positions）会附加“交易有风险；可能损失 100% 本金。”get_market_news 则以“来源：新闻媒体 via PolymarketScan 的新闻流。仅供参考，不构成财务建议。”结尾。
• 链接。 市场和交易者链接打开 PolymarketScan 分析页面，并携带 ?ref=mcp，用于标记访问来自 AI 助手。任何结果都不会链接到 polymarket.com 上的交易页面。新闻头条链接到发布方的文章。
• 错误。 如果 Polymarket 的数据服务无响应，工具会返回一条简短的通俗英文消息，请用户重试。绝不会透传原始上游或数据库错误。

卡片

在支持 MCP Apps 的主机（如 ChatGPT）中，结果会以交互式 PolymarketScan 卡片呈现：赔率、价格图表、市场、交易和交易者的排名列表。卡片本身不从网络加载任何内容。在其他客户端中，相同的结果以结构化数据加简短通俗英文摘要的形式呈现。

添加到您的助手

ChatGPT

• 插件目录： 一旦 PolymarketScan 上架，请在 ChatGPT 中打开插件目录，搜索“PolymarketScan”并连接。
• 开发者模式（上架前或测试用）： 打开设置 → 安全与登录 → 开发者模式，前往 chatgpt.com/plugins，点击 +，输入 https://mcp.polymarketscan.org/mcp 并选择无认证。

Claude（claude.ai 和 Claude Desktop）

• 连接器目录： 一旦 PolymarketScan 上架，请通过设置 → 连接器 → 浏览连接器添加。
• 自定义连接器： 设置 → 连接器 → 添加自定义连接器。命名为 PolymarketScan，使用 URL https://mcp.polymarketscan.org/mcp，OAuth 字段留空。

Grok

添加一个自定义连接器（MCP 服务器），使用 URL https://mcp.polymarketscan.org/mcp 且无需身份验证。

Claude Code

claude mcp add --transport http polymarketscan https://mcp.polymarketscan.org/mcp

Cursor

添加到 ~/.cursor/mcp.json（所有项目）或 .cursor/mcp.json（单个项目）：

{
  "mcpServers": {
    "polymarketscan": {
      "url": "https://mcp.polymarketscan.org/mcp"
    }
  }
}

仅运行本地（stdio）服务器的客户端

通过 mcp-remote 桥接，例如在 claude_desktop_config.json 中：

{
  "mcpServers": {
    "polymarketscan": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://mcp.polymarketscan.org/mcp"]
    }
  }
}

任意 MCP 客户端或纯 HTTP

将 Streamable HTTP 客户端指向该端点。服务器是无状态的，通过 POST /mcp 以 JSON 格式响应 JSON-RPC：

curl -s https://mcp.polymarketscan.org/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'

数据来源

赔率、价格、交易、持仓者、排行榜和交易者统计数据在调用工具时从 Polymarket.com 的公共 API 获取。新闻标题来自 PolymarketScan 自己的主要媒体新闻源。Polymarket.com 的响应最多缓存一分钟；排行榜、已结算市场和公开个人资料名称缓存 2 分钟到 1 小时。

隐私

服务器仅接收助手发出的工具调用，绝不会接收你的对话内容。它记录两类请求：客户端连接（initialize）和工具使用（tools/call）。工具列表和其他协议消息不会被记录。每条记录包含操作（连接或工具名称）、根据用户代理推断的客户端类型、用户代理的前 300 个字符、连接 IP 地址的键控哈希（使用服务器密钥的 HMAC-SHA-256，已缩短）以及时间。工具输入和结果不会被存储。详情请参阅：隐私政策 第 3 节。

免责声明

来源：Polymarket.com 经由 PolymarketScan。仅供参考，不构成财务建议。市场隐含概率是群体预测，并非确定性。数据可能延迟或出错；请在链接页面上核对重要数据。交易有风险；可能损失 100% 本金。

PolymarketScan 是一个独立的分析平台，与 Polymarket 无关。服务条款 · 隐私政策 · 联系我们 · support@polymarketscan.org