FastballAPI

FastballAPI MCP 服务

棒球数据 API。 逐球数据包含球种、球速和位置，每次打席数据包含垒上及出局状态和击出的球，还有比分板、排名、我们自己的评分和得分价值、各体育博彩平台的赔率，以及 MLB 球员道具投注赔率。涵盖 2015 年以来的 MLB 赛事，以及我们收录的 NCAA Division I 赛事。提供 REST API 和 MCP 服务。每月免费赠送 500 点额度，无需银行卡。

网站：https://fastballapi.com · 文档：https://fastballapi.com/docs · 获取密钥：https://fastballapi.com/signup

You:    "What is Gerrit Cole's whiff rate by pitch type this season?"
Claude: [calls get_pitch_mix]

You:    "How often did Aaron Judge homer on a 3-2 count in 2025?"
Claude: [calls get_plate_appearances]

You:    "How often has Shohei Ohtani gone over his total bases line since 2023?"
Claude: [calls get_prop_history]

在本地运行（stdio）

大多数客户端会直接连接到 https://mcp.fastballapi.com/mcp。如果使用的是启动本地进程的客户端：

git clone https://github.com/noahowsh/fastballapi-mcp.git && cd fastballapi-mcp && npm install
FASTBALLAPI_API_KEY=your_key node index.js

{ "mcpServers": { "fastballapi": { "command": "node", "args": ["/path/to/fastballapi-mcp/index.js"], "env": { "FASTBALLAPI_API_KEY": "your_key" } } } }

它会携带你的密钥转发请求到托管服务，因此所有工具和额度费用都相同。

Skills

此代码库还附带 skills/ 中的 16 个免费 Claude skills，可将 Claude 变成棒球分析师：球种组合和挥空率、得分价值、击球落点图、毕达哥拉斯战绩、赛前分析、赔率分析、道具投注建模（投手三振、安打、垒打数）、优势检测和回测。每个 skill 都列出了调用的 FastballAPI 工具及其费用。

git clone https://github.com/noahowsh/fastballapi-mcp.git

也可以将它们安装为 Claude Code 插件：

/plugin marketplace add noahowsh/fastballapi-mcp
/plugin install fastballapi-skills@fastballapi

或者使用 skills CLI：npx skills add noahowsh/fastballapi-mcp。

将 skills/ 文件夹提供给 Claude，连接下方的 MCP 服务，然后开始提问。dispatch skill 会将请求分派给合适的两到三个 skills。完整列表：skills/README.md。

Python

官方 Python 客户端已发布到 PyPI：fastballapi。

pip install fastballapi
export FASTBALLAPI_API_KEY=sk_live_...

from fastballapi import Client, to_dataframe

client = Client()

props = client.get_player_props(
    game_id="401815991",
    market="batter_home_runs",
)
df = to_dataframe(props, key="props")
print(df[["player_name", "bookmaker", "line", "over_odds", "under_odds"]].head(10))

针对密钥无效、额度用尽、资源不存在和速率限制提供类型化错误，支持自动重试，并提供用于 pandas 的 to_dataframe。

快速开始

这是一个基于 Streamable HTTP 的托管（远程）MCP 服务，无需安装任何内容。

Claude Code

claude mcp add --transport http fastballapi "https://mcp.fastballapi.com/mcp?key=YOUR_API_KEY"

Claude Desktop、Cursor 和其他客户端

{
  "mcpServers": {
    "fastballapi": {
      "url": "https://mcp.fastballapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}

也可以通过 x-api-key 请求头或 Authorization: Bearer 发送密钥。连接和列出工具无需密钥；调用工具则需要密钥。

REST

curl -X POST https://mcp.fastballapi.com/v1/list_teams -H "x-api-key: YOUR_API_KEY"

每个工具都通过 POST /v1/{tool} 搭配 JSON 请求体进行调用。

示例

examples/ 中提供了可运行的 Python（仅使用标准库）和 Node 18+（无依赖项）示例：

• examples/python/quickstart.py 和 examples/node/quickstart.mjs：赛程加一项头条数据调用。
• examples/python/mlb_pitch_mix_and_props.py：投手的武器库（各球种的使用率、球速、挥空率和坏球率），以及逐场对照其实际投球情况的三振道具投注赔率。

export FASTBALLAPI_API_KEY=your_key
python3 examples/python/quickstart.py
node examples/node/quickstart.mjs

详情请参阅 examples/README.md。前往 https://fastballapi.com/signup 获取免费密钥（每月 500 点额度，无需银行卡）。

工具（20）

工具	返回内容
list_teams	某个赛季的球队 ID、缩写和颜色
search_players	按姓名查找球员
get_games	按赛季、日期、日期范围或球队查询比赛及其得分、安打和失误
get_schedule	即将举行的比赛，以及各体育博彩平台的中间盘口
get_standings	每场完赛比赛对应的排名，以及得失分差和毕达哥拉斯战绩
get_injuries	最新伤病报告
get_ratings	我们的球队 Elo 评分排名
get_game	一场比赛的所有击球和投球数据、各博彩平台的盘口及获胜概率
get_player	赛季击球数据（AVG、OBP、SLG、OPS、RE24）和投球数据（ERA、WHIP、K/9）
get_player_games	球员完整的逐场击球和投球记录
get_leaders	符合资格的击球手和投手赛季领先者
get_team_stats	球队得分和失分、球队击球数据及对手击球数据
get_pitch_mix	投手的球种组合：各球种的使用率、球速和挥空率
get_odds	某场比赛（5 家）或某一天（10 家）的所有体育博彩平台的独赢盘、让分盘和大小分盘口
get_plate_appearances	每次打席的逐球实况，包括垒位出局状态、击球结果、获胜概率和 RE24
get_pitches	逐球数据：球数、球种、球速、位置和结果
get_spray_chart	击球手或球队按飞行轨迹和场地区域划分的击球落点
get_line_movement	首球投出前各体育博彩平台盘口的快照
get_player_props	各体育博彩平台的球员特殊投注盘口，包括初盘和终盘
get_prop_history	某球员的特殊投注盘口及其赛果，按比赛逐场列出

联赛：mlb（默认）、ncaabase（我们覆盖的 NCAA Division I 比赛；大学比赛不提供投球工具、击球落点图和伤病数据）。

数据

• 自 2015 年起的 MLB 比赛及逐球数据（2018 年起包含每一球；2015 至 2017 年涵盖每个赛季约 98% 至 99% 的投球数据）
• 每次打席的数据，包括垒位出局状态、击球结果、获胜概率和 RE24
• 各体育博彩平台的独赢盘、让分盘和大小分盘口：2015 至 2023 年每场比赛有 4 至 13 家平台的数据（2015 年约 4 家，2016 和 2017 年为 10 家，2018 至 2020 年为 7 至 8 家，2021 至 2023 年为 12 家）；自 2024 年起通常为 1 家平台；另有自 2020 年 7 月起的初盘和终盘（2021 至 2023 年中位数为 7 家平台，2024 年起为 8 家）；服务上线以来提供赛前盘口快照：每天一次，未来两天内的比赛每小时一次
• 自 2023 年 5 月起提供 MLB 球员特殊投注盘口（安打、全垒打、垒打数、打点、投手三振数、投手出局数），并列出每条盘口对应的赛果（get_player_props、get_prop_history）；大学比赛不提供此类数据
• 我们覆盖的 NCAA Division I 大学棒球比赛（并非所有 Division I 比赛）

按赛季查看覆盖范围，数据实时读取自数据库：https://fastballapi.com/docs

实用页面

• 文档：所有端点的参数和实时示例响应
• 数据图谱：有哪些数据、由哪个工具提供，以及各赛季的覆盖情况
• MLB 赔率：各体育博彩网站提供的即将开赛比赛的独赢盘、让分盘和总分盘赔率
• 今日 MLB 球员道具投注：安打、本垒打、垒打数、打点和投手三振数，列出各博彩网站中每位球员的最佳赔率
• 指南：用于模型的投球数据、球种组合和挥空率、毕达哥拉斯胜率、得点圈有跑者时的得分价值、击球落点图
• 数据：逐球数据、击球落点图、赔率历史、球员道具投注
• 大学棒球：我们覆盖的 NCAA Division I 比赛
• 定价：免费套餐和付费计划
• 对比：与 pybaseball 对比、与 BallDontLie 对比、与 Sportradar 对比、与 MLB Stats API 对比
• 术语表

定价

每月 500 个免费额度，无需银行卡。计划：Starter 19 美元/月（10,000 个额度）、Pro 49 美元/月（30,000 个额度）、Scale 149 美元/月（125,000 个额度）。钱包充值最低 5 美元，额度永不过期。https://fastballapi.com/pricing

归属说明

评分和得分价值由我们提供。与 MLB、NCAA 或任何球队均无关联。

许可证

本仓库内容采用 MIT 许可证。数据条款如上所述。

在 Codex 中使用

将此仓库添加为 Codex 插件市场，然后安装插件：

codex plugin marketplace add noahowsh/fastballapi-mcp

接着在 Codex 中打开插件目录，并从 fastballapi 市场安装 fastballapi-skills。此插件包含 skills/ 中的技能以及 FastballAPI MCP 服务（https://mcp.fastballapi.com/mcp）。请先设置密钥（可在 https://fastballapi.com/signup 免费获取）：

export FASTBALLAPI_API_KEY=your_key

Codex 会将其作为 bearer token 发送。

在 Gemini CLI 中使用

export FASTBALLAPI_API_KEY=your_key
gemini extensions install https://github.com/noahowsh/fastballapi-mcp

此扩展会添加 FastballAPI MCP 服务（https://mcp.fastballapi.com/mcp），并在 x-api-key 标头中发送密钥。请前往 https://fastballapi.com/signup 免费获取密钥（每月 500 个额度）。