OrcaLayer MCP — Polymarket Whale Analytics

orcalayer-mcp

面向 OrcaLayer API 的模型上下文协议（MCP）服务 — 在 Claude、Cursor 和其他 MCP 客户端中使用 Polymarket 巨鲸和市场分析。

有两种使用方式：

• 托管版，无需安装： https://orcalayer.com/mcp（Streamable HTTP）。 将其添加为 Claude 中的连接器（Settings → Connectors → Add custom connector， 粘贴 URL），或添加到任何支持远程 MCP 服务的客户端中。
• 本地版（stdio）： uvx orcalayer-mcp，适用于 Claude Desktop 和其他本地客户端。

无论采用哪种方式，它都是 orcalayer Python SDK 的轻量封装，并提供六种只读工具：

工具	功能	密钥
leaderboard	根据盈亏、胜率、交易量或交易次数为 Smart Money 集合中的钱包排名	否
wallet_overview	钱包盈利追踪：资料、盈亏、市场胜率、利润因子、排名	否
wallet_positions	查看钱包规模最大的未平仓头寸	否
markets	追踪 Smart Money 资金流：搜索市场，并查看持有各方头寸的 Smart Money 钱包数量	否
market_consensus	一个市场上的 Smart Money 共识与其价格的对比（按钱包数 + 按资金加权）	否
whale_alerts	盈利钱包的实时提醒：智能巨鲸交易实时动态	Premium

公共工具可匿名使用。whale_alerts 需要 Premium API 密钥 （获取密钥）：使用托管服务时，将密钥作为 Authorization: Bearer <key> 请求标头发送（适用于支持连接器请求 标头的客户端）；使用本地服务时，设置 ORCALAYER_API_KEY 环境变量。未提供密钥时，该工具会返回简短提示，而不会报错。

每个工具都带有 readOnlyHint: true：不会代表你创建、更改或 删除任何内容。数据仅从 OrcaLayer API 读取。

每个结果都包含一个简短的 notes 区块，用于定义字段，因此模型 比较两个工具时，不会遇到同名但含义不同的数值： market_win_rate（已结算市场的获胜比例）在 leaderboard 和 wallet_overview 中采用相同的计算依据；profit_factor 在排行榜中上限为 99.99（profit_factor_capped），在总览中则为未封顶净值； indexed_volume_usd 是 OrcaLayer 索引中的成交量，并非 Polymarket 的数据；Smart Money 计数按钱包数计算，无论钱包规模如何。

新增（2026-07-22）： Premium SSE 流（/api/public/v1/live/trades） 现在每个事件都携带 settlement_type（MINT / MERGE / COMPLEMENTARY / null） — 由实时数据推导的结算机制，经影子验证，MINT/MERGE 准确率达 100.000%。它描述的是匹配如何结算， 而非交易者的意图（约 80% 的所有成交以 MINT 结算；null = 坦诚拒绝判定，而非“不是 mint”）。详情请见 orcalayer://api-reference 资源或 orcalayer.com/docs/api。

提示词

适用于常见分析场景的即用型提示词：

提示词	功能
analyze_wallet	全面分析钱包——是聪明钱还是农户？
find_divergence	找出聪明钱与当前价格走势相悖的市场
hedge_check	判断钱包的利润是真正的 Alpha，还是对冲结构
territorial_markets_review	乌克兰领土市场，叠加 ISW 前线图层

在 Claude Desktop 中，从提示词菜单（+ / 斜杠命令选择器）中选择一个提示词——每个提示词都会为你编排上述工具。

资源

模型可直接读取的只读上下文——无需调用工具：

资源 URI	内容
orcalayer://methodology	如何从农户、对冲者和做市商中筛选出聪明钱
orcalayer://glossary	预测市场术语表
orcalayer://api-reference	OrcaLayer REST API 参考（端点、身份验证、速率限制）

与 Claude Desktop 搭配使用

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

{
  "mcpServers": {
    "orcalayer": {
      "command": "uvx",
      "args": ["orcalayer-mcp"]
    }
  }
}

公共工具开箱即用。对于 Premium whale_alerts 工具，请添加你的 API 密钥（获取密钥）：

{
  "mcpServers": {
    "orcalayer": {
      "command": "uvx",
      "args": ["orcalayer-mcp"],
      "env": { "ORCALAYER_API_KEY": "sk_orca_your_key_here" }
    }
  }
}

编辑配置后，重启 Claude Desktop。

使用托管服务

同样的六个工具、提示词和资源也通过 Streamable HTTP 在 https://orcalayer.com/mcp 上提供。公共工具无需账号即可使用。在 Claude 中：设置 → 连接器 → 添加自定义连接器 → 粘贴 URL。对于 whale_alerts，如果你的客户端支持连接器请求头，请将 Premium 密钥作为 Authorization: Bearer <key> 请求头发送；密钥绝不会通过 URL 接收。

通过 HTTP 自托管

pip install orcalayer-mcp
orcalayer-mcp --http --host 127.0.0.1 --port 8020 --path /mcp

该服务是无状态的，并返回纯 JSON，因此只要在前面配置支持 TLS 的反向代理即可（将 POST /mcp 转发到 127.0.0.1:8020/mcp）。环境变量 ORCALAYER_MCP_HTTP=1、ORCALAYER_MCP_HOST、ORCALAYER_MCP_PORT 和 ORCALAYER_MCP_PATH 与相应标志具有相同作用。ORCALAYER_MCP_ANON_BASE_URL 可将匿名调用路由到不同的 API 主机（托管服务会将其指向本地后端）；携带密钥的调用始终会发送到 https://orcalayer.com。请在代理中为每个客户端设置自己的速率限制：服务本身不会限制调用方。

许可证

MIT。请参阅 LICENSE。

所提供的数据仅供参考，不构成财务建议。

---

mcp-name: io.github.orcalayer/orcalayer-mcp