用途
OrcaLayer MCP 是一个 Model Context Protocol (MCP) 服务器，用于将 OrcaLayer API 接入 AI 代理，从而在 Claude、Cursor、Copilot 及其他 MCP 客户端中提供 Polymarket 鲸鱼追踪与市场分析数据。它本质上是 orcalayer Python SDK 的轻量封装。
主要能力
服务器提供六个只读工具，其中公开工具可匿名使用。whale_alerts 工具需要 Premium API 密钥。每个工具均携带 readOnlyHint: true，意味着不会代表用户创建、更改或删除任何内容，数据仅从 OrcaLayer API 读取。 每个结果都附带一个简短的 notes 块，用于定义其字段，从而确保模型在比较两个工具时不会在同一名称下遇到两个不同的数字。例如：market_win_rate（已结算市场中获胜的比例）在 leaderboard 和 wallet_overview 中具有相同的基础；profit_factor 在 leaderboard 中被限制为 99.99（profit_factor_capped），而在 overview 中为不设上限的净值；indexed_volume_usd 是 OrcaLayer 索引中的成交额，而非 Polymarket 的数字；Smart Money 计数是钱包数量，无论其规模大小。 新增（2026-07-22）：Premium SSE 流（/api/public/v1/live/trades）现在在每个事件上携带 settlement_type（MINT / MERGE / COMPLEMENTARY / null）——实时推导的结算机制，经 shadow-verified 在 MINT/MERGE 上达到 100.000% 准确。它描述的是匹配如何结算，而非交易者意图（约 80% 的所有成交结算为 MINT；null = 诚实拒绝，而非“不是 mint”）。详情参见 orcalayer://api-reference 资源或 orcalayer.com/docs/api。 此外，还提供用于常见分析场景的即用型提示词：在 Claude Desktop 中，从提示词菜单（+ / 斜杠命令选择器）中选择一个提示词——每个提示词都会为您编排上述工具。模型可以直接拉取只读上下文，无需工具调用。
使用方式
有两种使用方式：
- 托管服务，无需安装：https://orcalayer.com/mcp（Streamable HTTP）。在 Claude 中将其添加为连接器（Settings → Connectors → Add custom connector，粘贴 URL），或在任何支持远程 MCP 服务器的客户端中添加。
- 本地（stdio）：uvx orcalayer-mcp，适用于 Claude Desktop 和其他本地客户端。
与 Claude Desktop 一起使用
将以下内容添加到您的 claude_desktop_config.json（Windows 上为 %APPDATA%\Claude\claude_desktop_config.json，macOS 上为 ~/Library/Application Support/Claude/claude_desktop_config.json）。公开工具可直接使用。对于 Premium whale_alerts 工具，请添加您的 API 密钥（获取一个）。编辑配置后重启 Claude Desktop。
使用托管服务器
同样的六个工具、提示词和资源通过 Streamable HTTP 在 https://orcalayer.com/mcp 上提供。公开工具无需账户。在 Claude 中：Settings → Connectors → Add custom connector → 粘贴 URL。对于 whale_alerts，在客户端支持连接器请求头的情况下，将您的 Premium 密钥作为 Authorization: Bearer <key> 请求头发送；密钥绝不会在 URL 中被接受。
通过 HTTP 自托管
该服务器是无状态的并返回纯 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。请在代理中设置自己的每客户端速率限制：服务器本身不限制调用者。
适用场景
适用于需要在 AI 代理中获取 Polymarket 鲸鱼追踪和聪明钱数据的用户，例如在 Claude、Cursor、Copilot 等 MCP 客户端中进行分析。
限制
该项目采用 MIT 许可证，详见 LICENSE。数据仅供参考，不构成财务建议。whale_alerts 工具需要 Premium API 密钥；没有密钥时，该工具会返回简短通知而非错误。
