ParlayAPI

parlayapi-mcp

mcp-name: io.github.JacobiusMakes/parlayapi

适用于 ParlayAPI 的 MCP 服务。它将体育赔率、预测市场数据、实时仪表板预览、数据源质量证明和便捷的 Agent 注册作为原生工具，提供给任何兼容 MCP 的客户端（Claude Desktop、Cursor、OpenClaw、自定义助手）。

为什么使用它

没有 MCP 时，想要使用 ParlayAPI 的 Agent 必须：

• 告诉用户通过浏览器注册
• 等待用户复制并粘贴密钥
• 手动构造 HTTP 请求

使用此 MCP 服务，Agent 可以先调用无需密钥的发现工具，例如 parlayapi_live_command_center() 和 parlayapi_book_coverage()，以证明 ParlayAPI 正常运行。如果用户想要完整数据流，Agent 会调用 parlayapi_signup(email)，并获取可用的 API 密钥、用于仪表板的认领 URL，以及用户可点击的 Stripe 升级 URL。然后，它可以直接调用 parlayapi_get_odds()、parlayapi_get_props() 等工具。

在 Claude Desktop 中安装

打开最新桌面版发布页面，下载以 -directory.mcpb 结尾的资源文件。发布说明会标明捆绑包版本和已完成的验证。打开下载的文件（双击，或将其拖到 Claude Desktop 上）。Claude Desktop 会解包捆绑包，并使用其托管的 uv 运行时启动服务，因此无需配置终端或 Python。

0.3.8 Python 包源码会转发可用的账户密钥，以验证结账归属，并区分结账 URL 与电子邮件流程确认信息。确认信息不代表邮件已送达。单独固定的 0.3.6 桌面捆绑包不包含此结账修复。请查看上方的发布页面，获取更新的桌面捆绑包。

安装对话框中的 API 密钥字段是可选的。留空即可无密钥启动：注册、定价、实时预览、数据源质量和覆盖范围工具都可以立即使用，而且 parlayapi_signup 工具可以创建免费密钥（每月 1,000 个额度，无需银行卡），无需离开聊天。之后可随时在“设置”>“扩展”>“ParlayAPI”中添加密钥。

捆绑包源码位于 mcpb/。使用 npx @anthropic-ai/mcpb pack mcpb/ 重新构建。

安装（手动，适用于任何 MCP 客户端）

# Start the stdio server (normally launched by your MCP client):
uvx --from parlayapi-mcp==0.3.8 parlayapi-mcp

# Or install globally with pip:
pip install parlayapi-mcp==0.3.8

配置 MCP 客户端

Claude Desktop

在 macOS 上编辑 ~/Library/Application Support/Claude/claude_desktop_config.json（Windows 上编辑 %APPDATA%\Claude\claude_desktop_config.json）：

{
  "mcpServers": {
    "parlayapi": {
      "command": "uvx",
      "args": ["parlayapi-mcp"],
      "env": {
        "PARLAYAPI_KEY": "your_key_here"
      }
    }
  }
}

如果还没有密钥，请完全省略 env。注册工具无需密钥即可使用，公共实时预览、定价、数据源质量和覆盖范围工具也一样。付费数据工具会返回错误，提示你设置密钥。注册后，将新密钥粘贴到 env 中并重启 Claude Desktop。对于使用下划线格式的客户端，也接受 PARLAY_API_KEY。

Cursor

有关打包集成，请参阅 Cursor 插件设置。

添加到 .cursor/mcp.json：

{
  "mcpServers": {
    "parlayapi": {
      "command": "uvx",
      "args": ["parlayapi-mcp"],
      "env": { "PARLAYAPI_KEY": "your_key_here" }
    }
  }
}

OpenClaw

OpenClaw 可以使用 openclaw mcp set 保存 stdio MCP 服务定义。此无密钥配置可让助手立即使用注册、定价、实时预览、数据源质量和覆盖范围证明工具：

openclaw mcp set parlayapi '{"command":"uvx","args":["parlayapi-mcp"]}'

用户注册后，为付费数据工具添加 API 密钥：

openclaw mcp set parlayapi '{"command":"uvx","args":["parlayapi-mcp"],"env":{"PARLAYAPI_KEY":"your_key_here"}}'

使用 Docker 在本地运行

从此仓库构建 stdio 容器：

docker build -t parlayapi-mcp:local .
docker run --rm -i --read-only --cap-drop=ALL --security-opt=no-new-privileges parlayapi-mcp:local

该进程会等待从 stdin 接收 MCP 消息。启动时不会打开 Web 服务器，也不会调用 API。请通过 MCP 客户端连接；不要使用 -t，否则会分配终端，而不是使用 MCP stdio 传输。

对于账户工具，请在 MCP 客户端的密钥配置中设置自己的 PARLAYAPI_KEY，并将该环境变量传入容器：

docker run --rm -i --read-only --cap-drop=ALL --security-opt=no-new-privileges -e PARLAYAPI_KEY parlayapi-mcp:local

镜像中不会内置任何密钥。每位用户都应配置自己的密钥，并将账户响应保留在自己的客户端中。此容器并非共享的社区信息流。MIT 软件许可证不授予任何数据分发权；API 数据的使用受适用条款及任何书面协议约束。这些容器默认设置不会修改现有协议。

公开发现工具无需密钥。账户工具会使用你的额度；请查看当前套餐和限制。现有工具集还包括创建账户、创建结账链接、发送登录链接邮件和保存投注书偏好设置。请在 MCP 客户端中明确批准这些操作。仅列出工具本身不会创建账户、发送邮件或启动结账流程。

如需私下报告安全问题，请发送邮件至 [email protected]。请勿在公开议题中放入 API 密钥或账户响应。

暴露的工具

工具	身份验证	用途
parlayapi_signup	无	创建免费套餐账户，返回 API 密钥 + 认领 URL + 升级 URL
parlayapi_checkout_link	无	创建适用于任意套餐的 Stripe 升级 URL
parlayapi_magic_link	无	发送无密码登录链接邮件
parlayapi_get_pricing	无	当前公开定价和额度套餐
parlayapi_live_sports	无	正在进行的体育赛事、赛事数量和投注书数量
parlayapi_live_search	无	搜索正在进行的球队、球员和体育项目密钥
parlayapi_live_command_center	无	来自 /live 的公开最佳赔率预览
parlayapi_source_quality	无	公开数据源的时效性和质量元数据
parlayapi_book_coverage	无	各投注书公开的五道门槛覆盖证明
parlayapi_list_sports	密钥	所有可用的体育项目密钥
parlayapi_get_odds	密钥	某项体育赛事的比赛级赔率（胜负、让分、大小分）
parlayapi_get_props	密钥	某项体育赛事的球员特殊投注赔率
parlayapi_best_line	密钥	各结果在不同博彩公司中的最佳赔率
parlayapi_verdict	密钥	一次调用即可回答“我该下注吗？”：公平赔率与市场赔率对比、可下注的最佳投注书，以及通俗易懂的下注/放弃判断
parlayapi_set_bettable_books	密钥	记住用户所在地区和投注书，以便判断结果跳过用户无法使用的投注书
parlayapi_parlay_verdict	密钥	评估多项串关：综合公平赔率、最佳下注投注书、EV、最弱一项、相关性警告和派彩
parlayapi_best_bets	密钥	某项体育赛事的排名 +EV 玩法，限定为用户可下注的投注书，并附上优势提醒
parlayapi_account_info	密钥	套餐、剩余额度、计费周期
parlayapi_find_arbitrage	密钥	跨投注书套利机会，包括三项（主胜/平局/客胜）市场
parlayapi_find_ev	密钥	相对于专业投注书去除水位后的公平赔率，寻找正 EV 下注
parlayapi_consensus	密钥	各市场所有博彩公司赔率的共识（平均值）
parlayapi_find_middles	密钥	跨投注书的中间盘机会

资源

parlayapi://docs/quickstart - Python 和 JS 代码示例。

本地开发

git clone https://github.com/JacobiusMakes/parlay-api-mcp
cd parlay-api-mcp
pip install -e .

# Run against the local API instead of production:
PARLAYAPI_BASE_URL=http://127.0.0.1:8080 \
PARLAYAPI_KEY=your_local_test_key \
parlayapi-mcp

隐私政策

此扩展会连接到 ParlayAPI。请参阅 ParlayAPI 隐私政策。

许可证

MIT

---

此项目属于 ParlayAPI 生态系统：这是一个实时体育赔率 API，每月提供 1,000 点免费额度，无需信用卡。请前往 github.com/JacobiusMakes 探索所有工具。