flash-props-mcp 是 Flash Props API 的 MCP 服务器，由 Flash AI Solutions 开发，作为托管 Flash Props API 和 MCP 服务的公共连接器与元数据接口。该仓库没有需要安装的专有 Flash Props 后端服务器；用户需将客户端指向托管端点，并使用 Flash Props API 密钥进行认证以获取盘口数据。
主要用途 面向体育和电竞的球员数据（player props）查询，提供已发布盘口、Flash 预测、证据、上下文和盘口线变化，统一为美式赔率，覆盖赛前和实时。可在 Claude、Cursor 或任何 MCP 客户端中使用。
主要能力 MCP 端点提供以下工具：
- list_sports：列出所有运动项目，含实时状态、数据新鲜度、预测/上下文能力。
- get_market_metadata：市场标签、类别、范围以及该市场是否被建模。
- list_games：某运动项目中有 props 的比赛。
- get_game_props：一场比赛的全部球员 props。
- scan_props：跨全部赛程的市场级 prop 扫描。
- find_game：将球队名称解析为事件 id。
- find_player_props：某球员的全部活跃 prop。
- get_player_context：赛季基线、近期状态及更深入上下文。
- get_prop_evidence：博彩公司线、Flash 线、差距、状态、置信度、分歧、变动。
- get_prop_history：某 prop 按时间顺序的线与赔率历史。
- scan_movers：指定时间窗口内线变动最大的项目。
- get_leaders：按差距、状态和样本强度排名的榜单。 REST 与 MCP 共享相同的权益塑造，同一密钥在不同传输方式下看到相同产品层级。
使用方式
- 免费 API 密钥：https://api.flashodds.live/billing/free
- MCP 端点：https://api.flashodds.live/mcp，在 Authorization 头中发送 API 密钥。匿名访问可用于能力发现（list_sports、get_market_metadata），获取盘口数据至少需要免费密钥。
- 添加到 claude_desktop_config.json 中配置。
- REST API 快速试用（Node 20+）：将密钥放入本地 FLASH_PROPS_API_KEY 环境变量，运行 node examples/first-request.mjs 或 node examples/first-request.mjs nfl。脚本检查 401、403 和 429，不泄露密钥，不静默重试。
- 也可使用 Postman 工作区进行图形化探索，先从 Postman quickstart 开始，创建免费密钥，然后运行 Start here 文件夹中的请求。不要将密钥粘贴到 GitHub、URL、共享集合变量或截图中。
适用场景
- 在 Claude、Cursor 等 MCP 客户端中查询体育和电竞球员数据。
- 通过 REST API 集成体育数据。
- 需要盘口线、Flash 预测、赔率历史和线变动分析的场景。
限制与注意事项
- 覆盖范围由提供方驱动，不要硬编码带有 Flash 预测的运动项目列表。使用 list_sports 或 GET /api/v1/sports 检查 projectionCapability、effectiveProjection 和 contextCapability，再用 get_market_metadata 确定特定市场是否被建模。部分建模的运动项目可能对一个统计项提供 Flash 预测，而另一统计项仅有已发布盘口。
- 缺失的分析会明确报告，Flash Props 不会为不支持的市场捏造预测。
- 检查每个预测的 basis。current_season 基于本赛季；prior_season 是上赛季基线，不得作为当前状态呈现；basisNote 和 seasonId 说明来自哪个赛季。
- 使用 snapshotId 判断数字是否描述同一盘口。sports、games 和 props 响应中相等的 snapshotId 值意味着计数和行来自同一逻辑盘口。混合一致性值表示响应是部分的，不要将其计数与另一快照的行比较。
- 分层限制：Free：$0，300 请求/天，10 请求/分钟，15 行扫描，证据预览，基础上下文，无历史，无变动，前 3 名榜单；Builder（内部 id starter）：$19/月，25,000 请求/天，120 请求/分钟，100 行扫描，基础证据，基础上下文，有限历史，有限变动，前 10 名榜单；Pro：$49/月，150,000 请求/天，600 请求/分钟，3,000 行扫描，完整证据，完整上下文，完整历史，完整变动，前 100 名榜单；Enterprise：自定义限制。当前价格和 REST 参考见 https://api.flashodds.live/。
- 数据仅供信息参考。Flash Props 不是体育博彩公司，与任何联盟、球队、球员、博彩公司或 DFS 运营商无关联。
相关链接 网站：https://api.flashodds.live/ 文档：https://api.flashodds.live/docs OpenAPI：https://api.flashodds.live/openapi.json 公共契约：https://api.flashodds.live/contract.json MCP 端点：https://api.flashodds.live/mcp 免费 API 密钥：https://api.flashodds.live/billing/free 发布者：https://www.flashaisolutions.org
