官方 MCP 服务器Odds API MCP 服务器
为您的 AI 助手而生
将 Claude、Codex、Cursor 或 VS Code 连接到 450+博彩公司的实时与历史赔率。用日常语言询问价格、盘口走势、价值投注或投注结果，也可以让助手直接编写代码。
不到一分钟即可连接
获取 API 密钥
选择套餐和博彩公司。付款完成后，密钥会立即显示在控制台中。
将服务器添加到您的 AI 工具
粘贴一条命令或一段 JSON 即可。服务器通过 npx 或 Docker 在您自己的电脑上运行，并从环境变量读取密钥。
用日常语言提问
助手会选择合适的工具、调用 API，并用实时价格回答。它还可以基于同样的数据编写和测试代码。
claude mcp add odds-api \
--env ODDS_API_KEY="your-api-key" \
-- npx -y odds-api-mcp-servercodex mcp add odds-api \
--env ODDS_API_KEY="your-api-key" \
-- npx -y odds-api-mcp-server{
"mcpServers": {
"odds-api": {
"command": "npx",
"args": [
"-y",
"odds-api-mcp-server"
],
"env": {
"ODDS_API_KEY": "your-api-key"
}
}
}
}{
"mcpServers": {
"odds-api": {
"command": "npx",
"args": [
"-y",
"odds-api-mcp-server"
],
"env": {
"ODDS_API_KEY": "your-api-key"
}
}
}
}{
"servers": {
"odds-api": {
"command": "npx",
"args": [
"-y",
"odds-api-mcp-server"
],
"env": {
"ODDS_API_KEY": "your-api-key"
}
}
}
}{
"mcpServers": {
"odds-api": {
"command": "docker",
"args": [
"run",
"-i",
"--rm",
"-e",
"ODDS_API_KEY",
"oddsapi/odds-api-mcp-server"
],
"env": {
"ODDS_API_KEY": "your-api-key"
}
}
}
}使用 Claude Desktop？从最新版本下载 .mcpb 文件 并打开。Claude 会询问您的密钥，其余步骤自动完成。
您可以这样问
真实的问题，用实时数据回答。每个问题下方列出了助手回答时调用的工具。
本周末哪些 Premier League 比赛在胜平负赔率上 Bet365 和 Unibet 的差距最大？
get_eventsget_multi_oddsArsenal 对 Chelsea 的大于 2.5 球赔率从昨天到现在在 Bet365 是怎么变化的？
search_eventsget_odds_movements今晚哪些 NBA 赔率下跌得最快？
get_dropping_odds列出 Betano 当前的价值投注，按期望值排序。
get_value_bets昨天 Liverpool 的 Premier League 比赛，我投了亚洲让球 -1 和大于 2.5 球。这两注赢了吗？
get_historical_eventsgrade_bets写一个 Python 脚本，当我的博彩公司之间出现超过 2% 的套利机会时发送 Telegram 消息。
get_documentationget_arbitrage_bets
33 个工具，覆盖整个 API
这些工具覆盖整个 v3 API，因此助手在对话中找到的结果，在您的代码里同样适用。
赔率
get_odds- 单场赛事全部盘口，最多来自 30 家博彩公司
get_multi_odds- 一次调用获取最多 10 场赛事的赔率
get_updated_odds- 仅返回某个时间戳之后变化的赔率
get_odds_summary- 跨博彩公司比较每条盘口的最高价、均价、最低价和公平价
get_odds_movements- 某家博彩公司某条盘口的价格历史
get_dropping_odds- 自开盘以来跌幅最大的盘口，按体育项目和联赛筛选
赛事
get_events- 按体育项目、联赛、球队、日期或状态查询赛程
get_event- 按 ID 获取单场赛事
get_live_events- 当前正在进行的所有赛事
search_events- 按球队名称查找赛事
投注工具
get_value_bets- 某家博彩公司正期望值的价格
get_arbitrage_bets- 您所选博彩公司之间的套利机会
历史与结算
get_historical_events- 按体育项目、联赛和日期查询已结束赛事
search_historical_events- 按球队名称查找已结束赛事
get_historical_odds- 已结束赛事的收盘赔率和最终比分
get_closing_lines- 一次获取最多 10 个联赛的收盘赔率
get_settlements- 最多 50 场赛事的状态和各节最终比分
grade_bets- 将最多 50 笔投注结算为赢、输、作废或半赢半输
高尔夫冠军盘
list_outrights- 按巡回赛列出赛事，以及为每项赛事报价的博彩公司数量
get_outright_odds- 赛事的冠军、前 5/10/20 名和晋级赔率
get_outright_results- 最终排名和各盘口的胜出结果
参考数据
get_sports- 所有体育项目及其 slug
get_leagues- 某个体育项目的联赛及赛事数量
get_markets- 各体育项目准确的盘口名称，含赛前和滚球
get_bookmakers- 所有博彩公司及其是否在线
get_participants- 某个体育项目的球队和球员
get_participant- 按 ID 获取单个球队或球员
get_mappings- 博彩公司对应我们赛事和选项的自有 ID
账户与文档
get_selected_bookmakers- 您套餐中的博彩公司
select_bookmakers- 将博彩公司加入您的选择
clear_selected_bookmakers- 重置您的选择，每 12 小时一次
get_usage- 每小时限额、剩余请求数和重置时间
get_documentation- 完整的 API 文档，让代码第一次运行就能用
在您的电脑上运行，读取实时 API
密钥留在您的电脑上
服务器通过 stdio 在本地运行，直接与 api.odds-api.io 通信。中间没有任何中转，密钥保存在您的 MCP 配置中。
与 API 相同的数据
450+博彩公司、34 个体育项目，赛前和滚球，统一为一种 JSON 结构。助手看到的，就是您的代码将得到的。
助手可读取的文档
服务器将完整文档和 OpenAPI 规范作为 MCP 资源提供。当您要求编写代码时，助手会先核对真实的字段名称。
所有套餐均包含
MCP 服务器免费且开源。工具调用就是普通的 API 请求，计入您每小时 5,000 次请求的额度。
关于 MCP 服务器的问题
什么是 Odds API MCP 服务器？
它是 Odds-API.io 官方的 Model Context Protocol 服务器。它为 Claude、Codex 和 Cursor 等 AI 助手提供 33 个工具，用于读取 450+博彩公司的实时与历史赔率、赛事、价值投注、套利和投注结果。
它支持哪些 AI 工具？
任何支持 stdio 方式 MCP 的客户端都可以，包括 Claude Code、Claude Desktop、Codex、Cursor、搭配 GitHub Copilot 的 VS Code、Windsurf 和 Zed。Claude Desktop 还提供一键安装文件。
需要付费套餐吗？
需要。服务器需要 API 密钥，所有付费套餐都包含密钥，最低为 Solo 套餐，每月£49，含 2 家博彩公司。MCP 服务器本身不额外收费。
我的助手能看到哪些博彩公司？
您在套餐中选择的博彩公司。让助手运行 get_selected_bookmakers 即可查看。体育项目、联赛和赛事等参考数据对所有博彩公司都可用。
支持滚球赔率吗？
支持。get_live_events 列出正在进行的比赛，get_odds 返回它们的当前价格。如需在您自己的应用中接收流式数据，请使用 WebSocket API。助手可以为您编写这部分代码。
我的 API 密钥安全吗？
服务器在您的电脑上运行，只会把密钥发送到 api.odds-api.io。没有托管的代理。代码以 MIT 许可证在 GitHub 上开源。
助手能下注吗？
不能。服务器只读取数据，无法登录博彩公司，也无法下注。
它和 llms.txt 文档有什么区别？
llms.txt 为助手提供文档，让它能够编写代码。MCP 服务器则让助手在对话中调用 API、处理实时数据。大多数人两者都用。