PropLine

propline-mcp

已作为 io.github.proplineapi/propline-mcp 列入官方 MCP Registry，可通过 Claude Code、Claude Desktop 和任何支持 MCP 的客户端发现。

Model Context Protocol 服务，适用于 PropLine 球员特别投注赔率 API。将它接入 Claude Desktop、Claude Code 或任何兼容 MCP 的客户端，即可用自然语言询问实时赔率、特别投注结算、跨博彩平台的 +EV、比分和技术统计——模型会选择合适的工具、调用 API，并根据真实数据作答。

不必再听 AI 助手推脱“这需要一个 API”。PropLine MCP 将体育博彩研究变成一场对话。

你可以询问什么

安装后，你可以向模型提问，例如：

• “今晚 Yankees 对 Red Sox 的比赛，在所有博彩平台上 +EV 有多少？”
• “调出 Aaron Judge 最近 20 次特别投注的历史记录，包括命中／未命中结果。”
• “并排列出今天 DraftKings 和 Pinnacle 上的 MLB 投手三振特别投注。”
• “Nikola Jokic 昨晚的得分特别投注命中了吗？赔率线是多少？”
• “比较今晚 NBA 赛程中 PrizePicks 的 DFS 预测和 Bovada 的赔率线。”
• “Lakers 对 Celtics 的第一节总分是多少？哪家博彩平台的大分赔率最好？”

模型会透明地使用这些工具：

工具	功能
propline_list_sports	查看 PropLine 当前轮询的体育项目（今天为 54 项）
propline_list_events	查看某项运动的即将举行赛事及其 ID
propline_list_event_markets	查看某场赛事可用的市场类型
propline_get_odds	实时赔率——按体育项目批量获取，或获取某场赛事的全部球员道具投注。接受 period（q1/h1/p1/f5/…），用于筛选比赛时段市场；include_depth 会为每个结果添加订单簿深度。
propline_get_odds_history	Hobby+：每个结果的快照历史；支持 period（q1/h1/…）和时间窗口筛选（from/to、relative_from/relative_to、interval、changes_only）
propline_get_odds_closing	Hobby+：每个（博彩公司、市场、结果）的开盘线和收盘线——用于计算 CLV。接受 period，用于筛选特定比赛时段。
propline_grade_clv	Hobby+：根据收盘线评估已下注的投注。返回收盘赔率、去水后的收盘公平赔率（fair_source = 收盘时最锐利的博彩公司，而非你的博彩公司）、clv_pct（赔率对比赔率，不考虑水钱）以及 ev_vs_close_pct（真实数值），并在比赛结束后返回评估结果。采用匹配失败即关闭的策略；尚未开始的赛事会返回 closing_is_final: false，且不会计入平均值。devig：multiplicative 或 shin。
propline_price_sgp	Hobby+：按博彩公司自身的相关赔率计算同场串关价格（FanDuel、DraftKings、BetOnline、LowVig；或设为 bookmaker: "all"，并排比较所有博彩公司，同时返回 best_bookmaker）。返回 sgp_price、independent_price（实时单项赔率的乘积）和 correlation_factor（两者的比值）。投注项名称必须与 /odds 中结果的名称完全一致；采用匹配失败即关闭的策略。
propline_export_odds_history	Backfill-pass / Enterprise：批量获取某项运动的盘口变动逐笔历史（每家博彩公司提供每个快照）。需要 since/until 时间窗口；结果最多 200 行（如需完整文件，请直接使用 REST 端点）。
propline_get_futures	赛季长期期货投注——冠军/分区/联盟冠军、MVP 及奖项、赛季胜场总数——涵盖 Bovada/FanDuel/DraftKings/Pinnacle/Kalshi（免费）
propline_get_scores	比分及状态（免费）
propline_get_dfs_payouts	PrizePicks Power/Flex 派彩方案及每个投注项的盈亏平衡胜率（免费）
propline_get_mlb_grand_salami	合成 MLB 每日 Grand Salami——总得分及各家博彩公司隐含盘口（免费）
propline_get_nhl_daily_goals_total	合成 NHL 每日进球总数——冰球版 Grand Salami（免费）
propline_get_resolution_summary	已评估球员道具投注量及按体育项目/市场划分的明细（免费）
propline_get_event_ids	赛事 ID 对照表——ESPN、MLB gamePk 及各家博彩公司自己的赛事 ID（免费）
propline_get_book_accuracy	体育博彩公司准确度报告——各家博彩公司为球员道具投注定价的准确程度，与市场对比（免费）
propline_get_golf_rounds	按巡回赛（PGA、DP World、LIV、LPGA、Korn Ferry、Champions）查看高尔夫球手已完成的轮次，含 L5/L10/L20（免费）
propline_get_golf_tournaments	按巡回赛和赛季查看包含轮次数据的高尔夫锦标赛（免费）
propline_get_injuries	NFL、NCAAF、NBA、WNBA、NHL、MLB 的当前伤病报告（免费）
propline_get_injury_history	过去 1–90 天的伤病状态变更（免费）
propline_get_event_stats	原始记分统计（免费，不限博彩公司）
propline_get_event_context	球员道具投注结算时所依据的比赛条件——预计先发投手、阵容标记、主审、开球时天气（免费）
propline_get_event_movement	根据逐笔历史追踪盘口变动并检测急剧波动（所有博彩公司中的锐利资金信号）（Hobby+）。since（例如 -6h）表示从某个时刻起计算；include_book_ids 会添加博彩公司 ID。
propline_get_event_results	Pro：每项球员道具投注的赢/输/走水评估结果
propline_search_players	免费：按姓名片段查找球员 → 稳定的 player_id 及各家博彩公司使用的所有姓名拼写（known_names）
propline_get_player_history	球员道具投注历史及结算结果；接受 player_id；可选 main_line_only；条目包含 is_main_line 和 line_moved_in_play
propline_get_player_games	球员比赛记录——近期比赛及每场的全部原始记分统计；一次调用即可获取，无需按赛事逐次调用；opponent 可提供交锋记录（最近 N 次交手）。这是原始统计档案，因此也包含没有博彩公司为其定价的比赛。接受 player_id，可替代姓名
propline_get_player_trends	命中率趋势——最近 5/10/20/50 场已评估比赛中的大/小/走水拆分、连胜连败、实际平均值（可选 dfs_odds_type，用于限定 PrizePicks 类型）
propline_get_event_ev	Pro：跨博彩公司 +EV 及无水公平赔率（devig：multiplicative 或 shin；fair_source：选择锚定博彩公司，按顺序尝试）
propline_get_event_projections	Hobby+：按（市场、球员）计算市场隐含的共识预测值
propline_get_best_line	Hobby+：跨博彩公司比较盘口——在所有可比较的博彩公司中，按（市场、球员、盘口）筛选最佳赔率；all_prices 按赔率从优到劣排序；可选 bookmakers 筛选
propline_list_webhooks	Streaming Lite+：列出 webhook 订阅（只读，密钥已隐藏）
propline_get_webhook_deliveries	Streaming Lite+：查看某个 webhook 的近期投递尝试——状态、HTTP 代码、尝试次数、载荷；before_id 用于向前翻页。用于排查“为什么我的 webhook 没有触发”的工具
propline_create_free_api_key	在聊天中为用户注册免费的个人密钥。使用用户提供的电子邮件；密钥会发送给用户（不会返回），并附上可立即使用的连接器 URL 以便重新连接。这是唯一一个非只读工具

托管端点（无需安装）

同样的 36 个工具通过 Streamable HTTP 提供，地址为

https://mcp.prop-line.com/mcp

可通过任何支持远程连接的客户端使用——无需安装，也无需运行任何程序。

客户端	操作方法
Claude Code	claude mcp add --transport http propline https://mcp.prop-line.com/mcp
Claude.ai / Claude Desktop	Settings → Connectors → Add custom connector → 上方 URL
Cursor	Settings → MCP → Add server → 输入 http，并填写上方 URL (一键安装)
ChatGPT（开发者模式）	Settings → Connectors → Create → 上方 MCP 服务 URL
任何客户端	Streamable HTTP，端点 /mcp；GET / 返回 JSON 清单

每个请求单独进行身份验证。 将 PropLine 密钥作为 Authorization: Bearer <key> 发送（也可使用 X-API-Key: <key>，或对于无法设置请求头的客户端，使用 ?apiKey=<key>）。如果没有密钥，端点会改用共享免费演示密钥——所有工具均可使用，付费功能会被隐藏，使用限额由所有用户共享。密钥仅用于当前请求，不会被存储。

使用自己的密钥配置 Claude Code：

claude mcp add --transport http propline https://mcp.prop-line.com/mcp \
  --header "Authorization: Bearer YOUR_KEY"

下方的 stdio 版本（npx -y propline-mcp）使用相同的代码；可根据客户端偏好任选其一。

零配置快速开始

试用无需密钥。服务会改用共享公共演示密钥，因此可以直接使用：

npx -y propline-mcp

你的 Agent 可以立即获取实时赔率、比分和统计数据。演示密钥属于免费层级，且由多人共享——付费功能（结算、+EV、历史记录、导出）会返回经过隐藏处理的预览，使用限额由所有用户共享。如需完整访问权限和个人限额，请设置 PROPLINE_API_KEY（见下文）。可在 prop-line.com 免费获取个人密钥。

使用演示密钥期间，每个工具结果都会附带第二个内容块，说明限额共享和内容隐藏情况，以便助手准确解释字段为空或出现 429 错误的原因。设置自己的密钥后，该内容块便会消失。说明中还会告知助手可以提供 propline_create_free_api_key，让用户无需离开聊天即可获取自己的密钥。

安装（使用自己的密钥）

1. 获取 PropLine API 密钥

prop-line.com — 免费层级每天可发送 1,000 次请求，无需信用卡。Hobby 套餐每月 $9，可解锁结算、历史记录、收盘线和 +EV；Pro 套餐每月 $19，提供相同功能，每天可发送 25,000 次请求。

2. 添加到 MCP 客户端

Claude Desktop

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

{
  "mcpServers": {
    "propline": {
      "command": "npx",
      "args": ["-y", "propline-mcp"],
      "env": {
        "PROPLINE_API_KEY": "YOUR_KEY_HERE"
      }
    }
  }
}

重启 Claude Desktop。锤子图标应显示 30 个 PropLine 工具。（也可以跳过安装，将 https://mcp.prop-line.com/mcp 添加为自定义连接器——参见上方的托管端点。）

Claude Code

claude mcp add propline \
  --env PROPLINE_API_KEY=YOUR_KEY \
  -- npx -y propline-mcp

其他 MCP 客户端

以 stdio 服务的形式运行 propline-mcp。大多数客户端都接受命令和 env。客户端专属配置请参阅 MCP 规范。

配置

环境变量	必填	默认值	说明
PROPLINE_API_KEY	否	共享演示密钥	未设置 = 共享免费演示密钥（付费功能会被隐藏，使用限额由所有用户共享）。从 prop-line.com 获取自己的免费密钥即可完整使用。
PROPLINE_BASE_URL	否	https://api.prop-line.com	用于可自托管配置的覆盖值

与 the-odds-api 的比较

PropLine 在响应层面与 API 兼容（采用相同的 bookmakers[].markets[].outcomes[] 结构），并额外提供了 the-odds-api 在任何套餐中都不提供的三项功能：

1. 道具投注结算——赛后根据实际的技术统计数据为每项大/小投注判定结果
2. 跨博彩公司的 +EV——基于 Pinnacle 锚定值，按博彩公司计算无水公平赔率，并将 +EV 投注排在最前面
3. Webhook——Streaming 套餐提供推送交付，而非仅支持拉取

定价：免费套餐每天 1,000 次请求（他们每月 500 次），Hobby 套餐每月 $9，可每天请求 5,000 次；Pro 套餐每月 $19，可每天请求 25,000 次；Streaming Lite 套餐每月 $39，可请求 250,000 次（支持 Webhook + WebSocket）；Streaming 套餐每月 $79，可请求 1,000,000 次。无需计算额度。

链接

• 托管 MCP 端点：https://mcp.prop-line.com/mcp（Streamable HTTP）
• 隐私政策：prop-line.com/privacy
• 网站：prop-line.com
• 球员道具投注 API（涵盖的市场、博彩公司和体育项目）：prop-line.com/player-props-api
• API 文档：prop-line.com/docs
• 常用场景示例（常见任务的代码）：prop-line.com/recipes
• 按体育项目和市场划分的赔率 API（实时赔率线、博彩公司、判定结果后的命中率）：prop-line.com/odds-api
• 道具投注结算（根据技术统计数据判定每项道具投注的结果）：prop-line.com/prop-resolution-api
• 跨博彩公司的 +EV：prop-line.com/ev
• 定价：prop-line.com/pricing
• 仪表板：prop-line.com/dashboard
• OpenAPI 参考文档：api.prop-line.com/docs
• 面向 AI Agent（llms.txt、MCP 配置）：prop-line.com/for-ai-agents
• Python SDK：pip install propline
• Node SDK：npm install propline

许可证

MIT