prediction-market-signal-mcp

prediction-market-signal-mcp

在 Claude、Cursor 或任何 MCP 客户端中查看实时 Polymarket + Kalshi 预测市场赔率、异动、价格历史、跨平台差异、监控和 X/Twitter 情绪——**无需 API 密钥、无需订阅、无需月度最低消费。**你的 Agent 使用 x402 通过 Base 以 USDC 按次付费，每次调用只需不到一美分。

pm_search          $0.01/call    markets matching a question, Polymarket + Kalshi, ranked
pm_odds            $0.02/call    headline per platform, cross-platform gap, 7-day history, summary
pm_movers          $0.02/call    biggest probability swings (Polymarket, liquid markets)
pm_history         $0.02/call    one market's probability series, with first/last/high/low
pm_ticker_events   $0.01/call    open markets mentioning a US stock ticker or company
pm_sentiment       $0.05/call    markets AND X/Twitter chatter on the same question, one call
pm_watch           $0.02/call    only what moved since your last check (stateless cursor)
pm_gaps            $0.02/call    biggest Polymarket-vs-Kalshi disagreements, same question
pm_closing         $0.01/call    markets settling soon, both platforms
pm_resolved        $0.01/call    markets that just settled, with the outcome
pm_example         free          a real capped pm_odds result, no wallet needed

**仅提供事实，不构成投资建议。**每个回答都基于市场本身的隐含概率、交易量和价格历史（此外，pm_sentiment 还会如实概述 X/Twitter 上的讨论）。这里的内容都不是买入／卖出／持有信号、交易建议或财务建议。

为什么要开发这个项目

预测市场（Polymarket、Kalshi）已经将现实问题——选举、美联储决策、宏观事件——定价为群体预测的赔率。要同时查看两个平台上的信息，通常需要用到两套不同的 SDK、两个速率限制，而且无法跨平台比较。此服务通过一次调用即可查询两个平台，按请求收费而非订阅，也无需取消任何服务。

工具

pm_search — $0.01

搜索 Polymarket + Kalshi 上与问题或主题匹配的市场，按相关性排序。每项包含概率、24 小时变化、交易量、截止日期、URL 和 id（将 id 用于 pm_history 或 pm_watch）。输入：q（必填）、limit（可选，1-50，默认 20）。

pm_odds — $0.02

查询“市场怎么看”某个问题——每个平台的头部市场、跨平台概率差异、7 天历史记录和一句话摘要：

{
  "headline": { "polymarket": {...}, "kalshi": {...}, "gap_pts": 4 },
  "history_7d": { "points": [...] },
  "summary": "..."
}

输入：q（必填）。需要完整的排序列表时，请改用 pm_search。

pm_movers — $0.02

查看流动性较高的 Polymarket 市场中，24 小时／7 天内概率变化最大的市场——了解哪些市场刚刚变热。输入：window（可选，默认 24h，或 7d）、limit（可选，1-50，默认 20）。

pm_history — $0.02

查看单个市场随时间变化的概率序列，以及起始值／最新值／最高值／最低值。输入：id（必填——来自 pm_search 的 Polymarket condition id／slug／数字 id，或 Kalshi ticker）、interval（可选，1d／1w／1m／max，默认 1w）。

pm_ticker_events — $0.01

查找提及美国股票 ticker 或公司的 Polymarket + Kalshi 开放市场（裸 ticker 如 TSLA 也会匹配公司名称 Tesla）。仅提供事实——隐含概率、24 小时变化、交易量——绝不提供交易信号。输入：q（必填——ticker 或公司／主题）、limit（可选，1-50，默认 20）。

pm_sentiment — $0.05

一次调用即可查看市场对某个问题的看法，以及 X/Twitter 上的相关讨论：头部市场的概率、AI 对 X 讨论倾向于“是”或“否”的解读、关键主题、带动讨论的账号、值得关注的帖子 URL，以及比较两者后给出的 aligned／diverges／no_clear_read 结论：

{
  "summary": "Markets price \"...\" at 62%. X chatter (14 recent posts) leans YES — aligned with the market.",
  "agreement": "aligned",
  "market": { "polymarket": {...}, "kalshi": {...}, "gap_pts": 3 },
  "x": { "lean": "yes", "lean_note": "...", "summary": "...", "key_themes": [...] }
}

输入：q（必填）。两个平台都没有匹配的市场时，不收费。

pm_watch — $0.02

监控 1-20 个市场 id 或某个主题，只返回自上次检查以来的变化：当前概率、change_since_cursor（概率点）、moved 标记，以及（主题监控时）新上市的市场。下次调用时传入响应中的 cursor——此工具无状态，因此可并行运行任意数量的监控。输入：ids（以逗号分隔的 1-20 个 id）或 q（主题）——二选一，不可同时提供；cursor（可选，首次调用时省略）；min_move（可选，概率点，默认 3）。没有变化，也没有新市场 = 不收费——仍会返回最新的 cursor，以便监控继续跟踪。

pm_gaps — $0.02

查看 Polymarket 与 Kalshi 对同一问题意见分歧最大的市场——依据主题、截止日期和共有数字进行匹配，附带 match_confidence 分数和极性检查，确保相反方向的匹配绝不会显示为误导性的差异。数据来自每 30 分钟重建一次的快照。输入：limit（可选，1-50，默认 20）、min_gap（可选，概率点，默认 5）、q（可选，主题筛选）。指定差异幅度下没有匹配项时不收费；冷启动后快照尚未生成时也不收费，请稍后重试。

pm_closing — $0.01

两个平台上将在 24h 或 7d 内结束的市场，按交易量排序。输入：window（可选，默认为 24h 或 7d）、limit（可选，1-50，默认为 20）、q（可选的主题筛选条件）。

pm_resolved — $0.01

两个平台上在 24h 或 7d 内结算的市场，包含最终结果和最后价格——可用于根据实际结果评估预测。输入与 pm_closing 相同。

pm_example — 免费

针对固定问题（“fed rate cut”）返回真实的 pm_odds 结果，最多包含 5 个市场和 12 个历史数据点，每 6 小时刷新一次。无需钱包、无需付款、无需 x402——先用它查看返回内容的格式，再使用付费工具。无需输入。

设置

你需要一个 Coinbase CDP 钱包，并在 Base 上存入少量 USDC——该钱包会按次付款。在 portal.cdp.coinbase.com 创建钱包（API 密钥 + 钱包密钥）。 pm_example 无需上述任何设置即可使用——它是免费的。

Claude Desktop / Claude Code——添加到 claude_desktop_config.json（Claude Code 使用 .mcp.json）：

{
  "mcpServers": {
    "prediction-market-signal": {
      "command": "npx",
      "args": ["-y", "prediction-market-signal-mcp"],
      "env": {
        "CDP_API_KEY_ID": "your-key-id",
        "CDP_API_KEY_SECRET": "your-key-secret",
        "CDP_WALLET_SECRET": "your-wallet-secret",
        "X402_MAX_PRICE": "0.05"
      }
    }
  }
}

Cursor——Settings → MCP → Add new MCP server，使用上文相同的命令/参数/环境变量。

X402_MAX_PRICE 是以 USD 计的单次调用硬性上限。如果端点报价超过此金额，请求会在签名之前被拒绝——不会扣费。默认值 0.05 已足以覆盖上述所有付费工具（最贵的是 pm_sentiment，价格为 $0.05）——无需调高。

付款

x402，自备钱包。 每个付费工具都从你配置的钱包付款——即你自己的 Coinbase CDP 账户，并在 Base 上存有 USDC。服务端没有钱包，也没有共享账户：每次调用都会签署自己的 USDC 授权，端点的结算方会在 Base 上完成结算。结算方会承担 Gas 费用；你只需花费 USDC。

费用与安全

• 仅在成功返回结果时才会收费。无效输入会在付款之前被拒绝（HTTP 400，不会结算）。
• 未找到结果 = 不收费。 如果 pm_search / pm_ticker_events / pm_gaps / pm_closing / pm_resolved / pm_sentiment 返回空结果，会以 no_results 返回，并标记 charged: false——不会结算付款。
• pm_watch 仅在发生变化或出现新内容时收费。 检查后没有发现新内容则免费——可放心按计划轮询。
• 在 30 分钟后台快照完成首次构建之前调用 pm_gaps，会免费返回结果（503），而不会为不完整的结果收费。
• 如果付款后上游市场数据获取失败，API 会明确返回 error，并记录此次调用以便退款，而不会假装调用成功。
• 仅提供事实，不构成投资建议。 所有数字都是市场价格，或对公开讨论内容的客观解读——绝不是交易建议、目标价格，也不是买入/卖出/持有意见。

工作原理

MCP client → prediction-market-signal-mcp → 402 challenge → sign USDC authorization
           → facilitator settles on Base → data returned

协议：x402 v2（CAIP-2 网络、PAYMENT-REQUIRED 挑战标头）。

许可证

MIT