FastballAPI

FastballAPI MCP サーバー

野球データ API。 球種、球速、投球位置を含む1球ごとのデータ、塁・アウト状況と打球を含むすべての打席、ボックススコア、順位表、独自のレーティングと得点価値、ブック別のスポーツブックのオッズ、MLB 選手のプロップラインを提供します。2015年以降の MLB と、対象としている NCAA Division I の試合に対応しています。REST API と MCP サーバーを提供しています。毎月500クレジットを無料で利用でき、カード登録は不要です。

ウェブサイト：https://fastballapi.com · ドキュメント：https://fastballapi.com/docs · API キーの取得：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" } } } }

API キーを使ってホストサーバーに転送するため、すべてのツールとクレジット料金は同じです。

スキル

このリポジトリには、Claude を野球アナリストに変える16個の無料 Claude スキルも skills/ に収録されています。投球配分や空振り率、得点価値、スプレーチャート、ピタゴラス勝率、試合プレビュー、オッズ分析、プロップ予測（投手の奪三振、安打、塁打数）、優位性の検出、バックテストに対応しています。各スキルでは、呼び出す 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。

Claude から skills/ フォルダーを参照できるようにし、以下の MCP サーバーに接続して、質問してください。dispatch スキルがリクエストに応じて適切な2つまたは3つのスキルを振り分けます。全スキルの一覧：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"

各ツールは JSON ボディを指定した POST /v1/{tool} です。

使用例

実行可能な Python（標準ライブラリのみ）および Node 18+（依存関係なし）の例は examples/ にあります：

• 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	1 試合の全打撃・投球記録、各ブックのライン、勝利確率
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）または 1 日（10）について、各スポーツブックのマネーライン、ランライン、合計得点
get_plate_appearances	塁・アウト状況、打球、勝利確率、RE24 を含む打席ごとのプレー経過
get_pitches	1 球ごとの投球情報：カウント、球種、球速、位置、結果
get_spray_chart	打球の軌道とフィールド別に示す、打者またはチームの打球方向
get_line_movement	第 1 球前の各スポーツブックのラインのスナップショット
get_player_props	スポーツブック別の選手プロップライン、オープニングとクロージング
get_prop_history	試合ごとの選手プロップラインと結果の履歴

リーグ：mlb（デフォルト）、ncaabase（対象とする NCAA ディビジョン I の試合。大学野球では投球ツール、スプレーチャート、故障者情報は提供されません）。

データ

• 2015 年以降の MLB 試合の投球ごとのデータ（2018 年以降は全投球を収録。2015～2017 年は各シーズンの投球の約 98～99％を収録）
• 塁・アウト状況、打球、勝利確率、RE24 を含む全打席
• スポーツブック別のマネーライン、ランライン、合計得点：2015～2023 年は 1 試合あたり 4～13 ブック（2015 年は約 4、2016 年と 2017 年は 10、2018～2020 年は 7～8、2021～2023 年は 12）。2024 年以降は通常 1 ブックです。2020 年 7 月以降はオープニングラインとクロージングラインも提供します（2021～2023 年は中央値で 7 ブック、2024 年以降は 8 ブック）。サービス開始以降の試合前ラインのスナップショット：1 日 1 回、今後 2 日以内の試合については 1 時間ごと
• スポーツブック別の MLB 選手プロップライン（安打、本塁打、塁打、打点、投手の奪三振、投手のアウト数）を 2023 年 5 月以降提供。各ラインに対する結果も含みます（get_player_props、get_prop_history）。大学野球のデータはありません
• 対象とする NCAA ディビジョン I の大学野球（ディビジョン 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 はキーをベアラートークンとして送信します。

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` ヘッダーでキーを送信します。無料キー（月500クレジット）は https://fastballapi.com/signup から取得できます。