parlay-api-mcp 是 ParlayAPI 生态中的 Python MCP 服务器，目标是把 ParlayAPI 的体育赔率与球员道具等数据能力，直接接入各类 MCP 兼容的 AI 客户端。它的核心价值在于省去传统的人工接入流程：没有 MCP 时，智能体只能让用户去浏览器注册、等待用户复制粘贴密钥、再手工构造 HTTP 请求；有了该服务器后，智能体可以先用免密钥的发现类工具确认服务可用，再按需引导注册并直接调用数据工具。
主要能力与可用工具：服务器暴露体育赔率、预测市场数据、实时仪表板预览、数据源质量证明以及智能体注册等原生工具。公共发现类工具无需密钥，例如 parlayapi_live_command_center() 和 parlayapi_book_coverage() 可用于验证 ParlayAPI 是否在线；付费数据类工具包括 parlayapi_get_odds()、parlayapi_get_props() 等。工具集还包含账户创建、结账链接创建、登录链接邮件以及保存的投注偏好等动作类工具。列出工具本身不会创建账户、发送邮件或启动结账，这些动作需要在 MCP 客户端中显式批准。
使用方式：在 Claude Desktop 中，打开最新桌面版发布页，下载以 -directory.mcpb 结尾的资产，双击或拖入 Claude Desktop 即可。Claude Desktop 会解包该 bundle，并用其托管的 uv 运行时启动服务器，无需终端或 Python 环境配置。安装对话框中的 API 密钥字段为可选，留空即可以无密钥方式启动；此时注册、定价、实时预览、数据源质量和覆盖度工具立即可用，parlayapi_signup 工具还能在不离开聊天的情况下创建一个免费密钥（每月 1,000 额度，无需信用卡）。之后可随时在 Settings、Extensions、ParlayAPI 下添加密钥。bundle 源码位于 mcpb/ 目录，可用 npx @anthropic-ai/mcpb pack mcpb/ 重新构建。对于手动配置的任意 MCP 客户端，需编辑配置文件（macOS 为 ~/Library/Application Support/Claude/claude_desktop_config.json，Windows 为 %APPDATA%\Claude\claude_desktop_config.json）；若暂无密钥，可完全省略 env，注册工具及公共预览、定价、数据源质量、覆盖度工具仍可用，付费数据工具会返回提示设置密钥的错误，注册后把新密钥粘贴进 env 并重启客户端即可；也接受下划线风格的 PARLAY_API_KEY。Cursor 插件配置需添加到 .cursor/mcp.json。OpenClaw 可用 openclaw mcp set 保存 stdio MCP 服务器定义，用户在注册后再添加密钥以启用付费数据工具。
本地 Docker 运行：从本仓库构建 stdio 容器，该进程只在 stdin 上等待 MCP 消息，仅启动并不会打开 Web 服务器或发起 API 调用，必须通过 MCP 客户端连接，且不要使用 -t，否则会分配终端而非 MCP stdio 传输。容器未内置任何密钥，账户类工具需要用户在自己的 MCP 客户端密钥配置中设置 PARLAYAPI_KEY 并传入容器；每位用户应配置自己的密钥并将账户响应保留在自己的客户端内，该容器不是共享社区数据源。
适用场景与限制：适用于希望在 AI 对话中直接查询体育赔率、球员道具、预测市场数据，或需要由智能体完成注册、结账链接、登录邮件和偏好设置等流程的用户与开发者。使用时需注意：版本方面，0.3.8 Python 包源代码会转发可用的账户密钥用于结账归属验证，并区分结账 URL 与邮件流程确认（确认不代表邮件已送达）；单独固定版本的 0.3.6 桌面 bundle 不包含该结账修复，建议查看发布页获取更新的桌面 bundle。许可方面，MIT 软件许可不授予数据分发权，API 数据的使用受适用条款及任何书面协议约束，容器默认配置不修改既有协议；公共发现工具无需密钥，账户工具会消耗用户自己的额度，需查阅当前套餐与限制。私有安全问题可发送邮件至 support@parlay-api.com，不要在公开 issue 中放置 API 密钥或账户响应。
