MCP 服务器

一个原生的 Model Context Protocol 服务器，让编码代理无需编写客户端代码，就能读取匹配数据流和实时机会。所有套餐均免费提供。

这个 API 同时也是一个原生的 Model Context Protocol 服务器。像 Claude 或 Cursor 这样的编码代理可以把匹配数据流、机会以及目录的其余部分当作工具来调用，无需编写任何客户端代码。该服务器在所有套餐下都免费：工具列表对任意密钥开放，而每个工具返回的数据则按你密钥的套餐层级受限。

服务器通过 Streamable HTTP 运行在 https://api.dino.markets/v2/mcp/(注意末尾的斜杠——严格的 MCP 客户端/扫描器在访问无斜杠的 /v2/mcp 并被重定向到 /v2/mcp/ 时可能会返回 502)。

连接

使用你的 API 密钥以 Bearer 令牌的形式进行身份验证，与 REST API 使用的是同一个密钥。大多数 MCP 客户端通过 mcp-remote 连接，它会把你本地的客户端桥接到该 HTTP 端点：

{
  "mcpServers": {
    "dino-markets": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://api.dino.markets/v2/mcp/",
        "--header",
        "Authorization:Bearer ${DINO_API_KEY}"
      ],
      "env": { "DINO_API_KEY": "sk_live_..." }
    }
  }
}

能够直接使用 Streamable HTTP 的客户端，可以直接指向该 URL，自行发送 Authorization: Bearer sk_live_...，无需借助 mcp-remote。

工具

每个工具都对应一个 REST 端点。其中五个用于读取目录，任意有效密钥都可以免费使用；watch_markets 用于生成流票据，需要付费套餐。v2 中不存在单独的配对列表工具；配对详情已整合进 get_market 中。

工具	作用	套餐
`list_markets`	以规范市场对象的形式返回跨平台匹配目录，可按运动、联赛、状态和 signal 筛选。对应 `GET /v2/markets`。	任意有效密钥
`find_arbitrage`	返回已确认的跨平台套利机会，可按运动筛选。返回 `signal` 为 `"arb"` 的规范市场对象：一致性已确认、无阻断性结算风险、`potential_arb_pct` 已填充。对应 `GET /v2/markets?signal=arb`。	任意有效密钥
`get_market`	按 `id`(来自 `list_markets` 或 `find_arbitrage` 的 `dino_<uuid>` 或裸 UUID)返回单个市场的规范对象，附带结算披露、平台 id 和深度信息。交易前请先读取此工具。对应 `GET /v2/pairs/{market_id}`。	任意有效密钥
`list_leagues`	返回当前处于赛季中的运动与联赛，附带每个运动的 open/live/settled 计数。对应 `GET /v2/leagues`。	任意有效密钥
`get_coverage`	返回平台覆盖普查：Kalshi 上架的每一个对战类联赛（无论是否已接入），附带其聚合状态，以及运动级别的 Polymarket 侧盈余。对应 `GET /v2/coverage`。	任意有效密钥
`report_bad_arb`	举报一个看起来有问题的机会。`opp_id` 接收该市场的 `id` 值。对应 `POST /v2/report-bad-arb`。	任意有效密钥
`watch_markets`	为实时 WebSocket 流生成一张票据，返回 `ws_url` 以及你的套餐层级允许访问的频道。请把结果中的 `allowed.channels` 视为唯一可信来源；Basic 和 Pro 的令牌会获得 v2 的 `markets:*` 匹配数据流频道。对应 `POST /v1/stream/token`（在 v2 中未变化）。	Basic、Pro

某个工具返回的数据与其对应的 REST 端点一致，因此 find_arbitrage 和 list_markets 都会返回市场对象(signal、potential_arb_pct、outcomes)。结算细节是各平台各自独有的。如果你的代理需要在执行前核查分歧之处，请调用 get_market(或 REST 的 /v2/pairs/{market_id} 端点)，以获取已披露风险的完整详情。

套餐层级如何体现

MCP 工具返回的是数据，而不是 HTTP 状态码，因此当你的密钥没有相应权限时，工具依然会给出响应，只是状态信息包含在响应体中。Free 密钥调用 watch_markets 时，得到的会是 402 和升级链接，而不是代理无法读取的错误。这样代理就可以根据结果进行分支判断，并提示你升级。

如需获取整个产品面向代理可读的概览，请让你的代理访问 /llms.txt。