Odds Api

@pipeworx/odds-api

The Odds API MCP——覆盖 70 多家博彩公司的赔率，支持 30 多个体育联赛（NFL、NBA、MLB、NHL、足球、MMA、高尔夫、网球、电竞、板球等）。

这是 Pipeworx 的一部分——一个将 AI Agent 连接到 1683 多个实时数据源的 MCP 网关。

工具

• list_sports(all?) — 列出可用的体育项目／联赛
• get_odds(sport_key, regions?, markets?, odds_format?, date_format?, bookmakers?, events?) — 当前赔率
• get_event_odds(sport_key, event_id, regions?, markets?) — 特定赛事的赔率（支持更多市场，例如球员投注）
• get_scores(sport_key, days_from?) — 实时和近期完赛比分
• get_events(sport_key, date_format?, event_ids?) — 列出即将开始和正在进行的赛事
• odds_api_quota() — 提供本次调用所用密钥本月剩余和已用的额度（免费；不消耗上游额度）

身份验证

• 平台密钥： 网关环境变量 PLATFORM_ODDS_API_KEY
• 自带密钥： 在 https://the-odds-api.com/ 注册后，添加 ?_apiKey=<key>

免费套餐：每月 500 次请求。每个赔率数据载荷中的市场计为 1 次请求。list_sports、 get_events 和 odds_api_quota 免费——截至 2026-09-01 的实测结果显示，它们不会扣减 额度。

当月额度用完后，计量工具（get_odds、get_event_odds、get_scores）会返回 upstream_throttled，并提示你自带密钥。上游会用 HTTP 401 表示额度耗尽，与密钥错误时的状态码相同，因此请查看消息而非状态码： odds_api_quota 可以区分这两种情况。额度会在套餐周年日重置，而非每月 1 日重置，且重置时不会发出通知。

额度归零后，odds_api_quota 还会添加 error: "account_limited" 和一条通俗易懂的 message。这样就能发现套餐额度是否用尽：平台密钥监控面板会通过 odds_api_quota 探测此工具包，正是因为它既免费调用，又能报告错误。此前，监控面板使用 get_events 进行探测，而该工具在额度归零时仍会返回 200——因此 2026 年 8 月，四个计量工具停摆了 11 天，却没有任何报告。该消息的措辞是与 workers/monitor 约定的契约；tests/odds-api-quota-visibility.test.ts 确保两者保持一致。

数据源

https://api.the-odds-api.com/v4/ — ?apiKey= 查询参数。

快速开始

添加到你的 MCP 客户端（Claude Desktop、Cursor、Windsurf 等）：

{
  "mcpServers": {
    "odds-api": {
      "url": "https://gateway.pipeworx.io/odds-api/mcp"
    }
  }
}

此端点实际提供的内容

https://gateway.pipeworx.io/odds-api/mcp 上的 tools/list 会返回上表中的工具， 以及 Pipeworx 的共享元工具——ask_pipeworx、 discover_tools、search_within、remember／recall 和网关范围内的其他工具。因此，你看到的工具数量会多于本表：目前，单工具包端点除了工具包自身的工具，还会列出约 30 个共享工具。连接的 initialize 响应会说明其确切范围，是判断特定日期范围的权威依据。

这是有意设计的，并非意外的多路复用。元工具可以让限定范围的连接回答此工具包无法解答的问题——通过 ask_pipeworx 路由到整个目录——而无需你添加第二个 MCP 服务。目前无法挂载不含这些元工具的工具包端点；如果额外的架构信息耗费的上下文超过路由功能带来的价值，可以只连接一次完整网关，而不是连接多个工具包端点。

或者，连接完整的 Pipeworx 网关，直接列出每个工具包中的所有工具，而不只是此工具包中的工具：

{
  "mcpServers": {
    "pipeworx": {
      "url": "https://gateway.pipeworx.io/mcp"
    }
  }
}

两个 URL 都连接到同一个网关和相同的 1683 多个数据源。唯一的区别是直接列出哪个工具包的工具；通过任意一个端点，ask_pipeworx 都可以访问所有工具。

没有 MCP 客户端？通过 HTTP 调用

我们的 odds-api 密钥仅供付费账户使用，因此匿名调用 POST https://gateway.pipeworx.io/v1/tools/odds_api_list_sports 时，需要将你自己的密钥作为 _apiKey 与参数一同传入。查看任意工具：GET https://gateway.pipeworx.io/v1/tools/odds_api_list_sports。查找工具：使用 {"query":"..."} 调用 POST https://gateway.pipeworx.io/v1/tools/search_packs。

独立运行（无需网关账户）

此软件包也可以作为本地 stdio MCP 服务运行，无需 Pipeworx 账户，也无需经过网关：

{
  "mcpServers": {
    "odds-api": {
      "command": "npx",
      "args": ["-y", "@pipeworx/mcp-odds-api"]
    }
  }
}

或者直接运行，确认服务已启动：

npx -y @pipeworx/mcp-odds-api

它通过 stdin/stdout 使用 MCP 通信，并仅响应此软件包工具的 initialize/tools/list/tools/call 请求——不包含上方网关连接所提供的任何共享元工具。相同的源代码，相同的工具，没有 ask_pipeworx 路由。

使用 ask_pipeworx

你可以用自然语言提问，而不是直接调用工具——在上方的软件包端点和完整网关上都可以使用：

ask_pipeworx({ question: "your question about Odds Api data" })

网关会选择合适的工具并自动填充参数。

更多信息

• 文档和指南
• pipeworx.io

许可证

MIT