FastballAPI
Server Details
MLB since 2015 plus college: pitches, plate appearances, box scores, odds by book. REST and MCP.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- Repository
- noahowsh/fastballapi-mcp
- GitHub Stars
- 0
TDQS
Score is being calculated.
Available Tools
20 toolsget_gameRead-onlyInspect
Use for one game in full: line score, every batter's and pitcher's line, each sportsbook's opening and closing line, and the win-probability range. For every plate appearance use get_plate_appearances. Costs 5 credits.
| Name | Required | Description | Default |
|---|---|---|---|
| league | No | League. Defaults to mlb. One of: mlb, ncaabase. | |
| game_id | Yes | ESPN game id, from get_games or get_schedule. |
Output Schema
| Name | Required | Description |
|---|---|---|
| game | Yes | |
| odds | Yes | |
| batting | Yes | |
| pitching | Yes | |
| win_probability | Yes | |
| plate_appearances | Yes |
get_gamesRead-onlyInspect
Use to list games with runs, hits and errors by season, date, date range or team, newest first. For upcoming games with lines use get_schedule; for one game's box score use get_game. Costs 2 credits.
| Name | Required | Description | Default |
|---|---|---|---|
| to | No | To date, YYYY-MM-DD. | |
| date | No | One date, YYYY-MM-DD (US Eastern). | |
| from | No | From date, YYYY-MM-DD. | |
| team | No | Team id or abbreviation. | |
| limit | No | Max games (default 50). | |
| league | No | League. Defaults to mlb. One of: mlb, ncaabase. | |
| offset | No | ||
| season | No | Season (a year, e.g. 2025; default: the latest). | |
| status | No | ||
| season_type | No | regular or postseason (default both). |
Output Schema
| Name | Required | Description |
|---|---|---|
| count | Yes | |
| games | Yes | |
| next_offset | No |
get_injuriesRead-onlyInspect
Use for the injury report: every listed player's status, injury and expected return, as captured on the latest day (or the latest on or before date). Costs 2 credits.
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | YYYY-MM-DD (default: the latest). | |
| team | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| date | Yes | |
| note | No | |
| count | Yes | |
| injuries | Yes |
get_leadersRead-onlyInspect
Use for a season's leaders among qualified players: batting avg, obp, slg, ops, hr, re24, bb_pct, k_pct (3.1 plate appearances per team game) or pitching era, whip, so, k_per_9, bb_per_9 (1 inning per team game). Costs 5 credits.
| Name | Required | Description | Default |
|---|---|---|---|
| stat | Yes | ||
| limit | No | ||
| league | No | League. Defaults to mlb. One of: mlb, ncaabase. | |
| min_ip | No | Override the innings minimum. | |
| min_pa | No | Override the plate-appearance minimum. | |
| season | No | Season (a year, e.g. 2025; default: the latest). |
Output Schema
| Name | Required | Description |
|---|---|---|
| stat | Yes | |
| count | Yes | |
| season | Yes | |
| leaders | Yes | |
| qualifier | Yes |
get_line_movementRead-onlyInspect
Use to see how a game's line moved before first pitch: our pre-game snapshots of each sportsbook's moneyline, run line and total (ESPN's once a day, The Odds API's every hour for games in the next two days). Costs 10 credits.
| Name | Required | Description | Default |
|---|---|---|---|
| league | No | League. Defaults to mlb. One of: mlb, ncaabase. | |
| game_id | Yes | ||
| provider | No | One sportsbook, e.g. DraftKings. |
Output Schema
| Name | Required | Description |
|---|---|---|
| game | Yes | |
| note | No | |
| movement | Yes | |
| snapshots | Yes |
get_oddsRead-onlyInspect
Use for betting lines: each sportsbook's moneyline, run line and total for a game (opening and closing per book from July 2020 from The Odds API, and from 2024 from ESPN; ESPN's final line only before that), with implied probabilities and, for finished games, whether the favourite won and the total went over against the median close. Pass game_id for one game (5 credits) or date for a day's games (10 credits).
| Name | Required | Description | Default |
|---|---|---|---|
| date | No | A day's games, YYYY-MM-DD (US Eastern). | |
| league | No | League. Defaults to mlb. One of: mlb, ncaabase. | |
| game_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| note | No | |
| tool | No | |
| count | No | |
| games | No | |
| credits | No | |
| estimate_only | No |
get_pitchesRead-onlyInspect
Use for pitch-by-pitch data: every pitch of a game, or a pitcher's or batter's season, with the count, pitch type, velocity, location and result. Costs 10 credits.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Max pitches (default 500). | |
| offset | No | ||
| season | No | Season (a year; default: the latest; ignored with game_id). | |
| game_id | No | ||
| batter_id | No | ||
| pitch_type | No | ESPN abbreviation, e.g. FF, SL, CH, CU, SI, FC. | |
| pitcher_id | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| note | Yes | |
| count | Yes | |
| pitches | Yes | |
| next_offset | No |
get_pitch_mixRead-onlyInspect
Use for a pitcher's arsenal in a season: each pitch type's usage, average and top velocity, whiff rate per swing and ball rate. Costs 5 credits.
| Name | Required | Description | Default |
|---|---|---|---|
| season | No | Season (a year; default: the latest; ignored with game_id). | |
| pitcher_id | Yes | ESPN athlete id. |
Output Schema
| Name | Required | Description |
|---|---|---|
| mix | Yes | |
| note | No | |
| count | Yes | |
| season | Yes | |
| pitcher | Yes | |
| pitches | Yes |
get_plate_appearancesRead-onlyInspect
Use for plate-appearance play-by-play: a whole game in order, or a batter's, pitcher's or team's season, with the base-out state before, the result, the batted ball (trajectory and location), runs, the win probability after (2019 on) and our run value (RE24). Filter by result, inning or runners in scoring position. Costs 10 credits.
| Name | Required | Description | Default |
|---|---|---|---|
| risp | No | Runners in scoring position only. | |
| team | No | Batting team (id or abbreviation). | |
| limit | No | Max rows (default 200). | |
| inning | No | ||
| league | No | League. Defaults to mlb. One of: mlb, ncaabase. | |
| offset | No | ||
| result | No | e.g. home-run, strikeout, walk, single, double, ground-out. | |
| season | No | Season (a year; default: the latest; ignored with game_id). | |
| game_id | No | ||
| batter_id | No | ||
| pitcher_id | No | ||
| season_type | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| count | Yes | |
| next_offset | No | |
| plate_appearances | Yes |
get_playerRead-onlyInspect
Use for a player's season-by-season batting (AVG, OBP, SLG, OPS, HR, K%, BB%, RE24, from every plate appearance) and pitching (ERA, WHIP, K/9, BB/9). Costs 5 credits.
| Name | Required | Description | Default |
|---|---|---|---|
| league | No | League. Defaults to mlb. One of: mlb, ncaabase. | |
| player_id | Yes | ESPN athlete id, from search_players. |
Output Schema
| Name | Required | Description |
|---|---|---|
| note | Yes | |
| player | Yes | |
| batting | Yes | |
| pitching | Yes |
get_player_gamesRead-onlyInspect
Use for a player's game log: every game's batting line and pitching line, newest first, optionally one season. Costs 5 credits.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| league | No | League. Defaults to mlb. One of: mlb, ncaabase. | |
| offset | No | ||
| season | No | Season (a year, e.g. 2025; default: the latest). | |
| player_id | Yes | ||
| season_type | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| count | Yes | |
| batting | Yes | |
| pitching | Yes | |
| player_id | Yes | |
| next_offset | No |
get_player_propsRead-onlyInspect
Use for player prop lines by sportsbook: over/under on hits, home runs, total bases, RBI, pitcher strikeouts and pitcher outs, from May 2023 (DraftKings, FanDuel, BetMGM, ESPN BET, Pinnacle and others). Pass game_id for every player's props in one game (10 credits), or player_id with from_date (and to_date) for one player across games (10 credits per game returned, up to 100). Returns the closing line by default (the last before the game starts) or the opening line, with each book's over and under prices. Set estimate_only to get the price without being charged.
| Name | Required | Description | Default |
|---|---|---|---|
| market | No | One market: batter_hits (hits), batter_home_runs (home runs), batter_total_bases (total bases), batter_rbis (runs batted in), pitcher_strikeouts (pitcher strikeouts), pitcher_outs (pitcher outs recorded) | |
| game_id | No | Game id: every player's props for that game. | |
| to_date | No | With player_id: last date (default: no end), YYYY-MM-DD (the game's date). | |
| bookmaker | No | Bookmaker key, e.g. draftkings, fanduel, pinnacle. | |
| from_date | No | With player_id: first date, YYYY-MM-DD (the game's date). | |
| player_id | No | Player id (e.g. 33192) from search_players. With from_date: that player's props across games. | |
| estimate_only | No | Return what this call would cost, without charging or running it. | |
| snapshot_type | No | closing (default): the last line before the game starts. opening: the first one captured. |
Output Schema
| Name | Required | Description |
|---|---|---|
| note | No | |
| tool | No | |
| count | No | |
| games | No | |
| props | No | |
| credits | No | |
| estimate_only | No | |
| snapshot_type | No | |
| next_from_date | No | |
| credits_per_game | No |
get_prop_historyRead-onlyInspect
Use to see how a player did against his prop line over time: for one market (hits, home runs, total bases, RBI, pitcher strikeouts or pitcher outs), one row per game with the closing line (the median across books, or one book's), the opening line, the prices, what the player actually recorded from our box scores and the result against the line, plus the over rate. Costs 10 credits for up to 200 games.
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Games to return, oldest first (default 50, max 200). next_from_date says where to continue. | |
| market | Yes | The market: batter_hits (hits), batter_home_runs (home runs), batter_total_bases (total bases), batter_rbis (runs batted in), pitcher_strikeouts (pitcher strikeouts), pitcher_outs (pitcher outs recorded) | |
| to_date | No | Last date, YYYY-MM-DD (the game's date). | |
| bookmaker | No | One book's closing line instead of the median across books, e.g. draftkings. | |
| from_date | No | First date, YYYY-MM-DD (the game's date). | |
| player_id | Yes | Player id (e.g. 33192) from search_players. |
Output Schema
| Name | Required | Description |
|---|---|---|
| note | No | |
| stat | Yes | |
| tool | No | |
| count | Yes | |
| games | Yes | |
| market | Yes | |
| credits | No | |
| summary | Yes | |
| bookmaker | Yes | |
| player_id | Yes | |
| truncated | No | |
| player_name | Yes | |
| estimate_only | No | |
| next_from_date | No |
get_ratingsRead-onlyInspect
Use for our team power ratings (Elo from every final game in our data), ranked, as of the end of a season or today. Costs 2 credits.
| Name | Required | Description | Default |
|---|---|---|---|
| league | No | League. Defaults to mlb. One of: mlb, ncaabase. | |
| season | No |
Output Schema
| Name | Required | Description |
|---|---|---|
| count | Yes | |
| method | Yes | |
| season | Yes | |
| ratings | Yes |
get_scheduleRead-onlyInspect
Use for upcoming games (next 1-30 days, default 7) with the median line across posted sportsbooks: moneylines, run line and total. For every book's line use get_odds. Costs 2 credits.
| Name | Required | Description | Default |
|---|---|---|---|
| days | No | ||
| team | No | Team id or abbreviation. | |
| league | No | League. Defaults to mlb. One of: mlb, ncaabase. |
Output Schema
| Name | Required | Description |
|---|---|---|
| days | Yes | |
| count | Yes | |
| games | Yes |
get_spray_chartRead-onlyInspect
Use for where a batter or team hits the ball: balls in play by trajectory (ground ball, line drive, fly ball, pop-up) and by field (left, center, right), with hit rates; include_balls adds each ball's location for drawing. Costs 10 credits.
| Name | Required | Description | Default |
|---|---|---|---|
| team | No | ||
| season | No | Season (a year; default: the latest; ignored with game_id). | |
| batter_id | No | ||
| include_balls | No | Add each ball in play's x/y (up to 3,000). |
Output Schema
| Name | Required | Description |
|---|---|---|
| balls | No | |
| season | Yes | |
| by_field | Yes | |
| balls_note | No | |
| balls_in_play | Yes | |
| by_trajectory | Yes |
get_standingsRead-onlyInspect
Use for a season's regular-season standings computed from every final game: record, home and away, last 10, runs scored and allowed, run differential and Pythagorean win percentage. Costs 2 credits.
| Name | Required | Description | Default |
|---|---|---|---|
| league | No | League. Defaults to mlb. One of: mlb, ncaabase. | |
| season | No | Season (a year, e.g. 2025; default: the latest). |
Output Schema
| Name | Required | Description |
|---|---|---|
| note | Yes | |
| count | Yes | |
| season | Yes | |
| standings | Yes |
get_team_statsRead-onlyInspect
Use for team offence and run prevention for a season: runs per game for and against, run differential, and batting and opponents' batting (AVG, OBP, SLG, OPS, K%, BB%, HR) from every plate appearance. Costs 5 credits.
| Name | Required | Description | Default |
|---|---|---|---|
| team | No | ||
| league | No | League. Defaults to mlb. One of: mlb, ncaabase. | |
| season | No | Season (a year, e.g. 2025; default: the latest). |
Output Schema
| Name | Required | Description |
|---|---|---|
| count | Yes | |
| teams | Yes | |
| method | Yes | |
| season | Yes |
list_teamsRead-onlyInspect
Use to find team ids and abbreviations for a season (default: the latest). Every other tool takes a team as an id or abbreviation. Costs 1 credit.
| Name | Required | Description | Default |
|---|---|---|---|
| league | No | League. Defaults to mlb. One of: mlb, ncaabase. | |
| season | No | Season (a year, e.g. 2025; default: the latest). |
Output Schema
| Name | Required | Description |
|---|---|---|
| count | Yes | |
| teams | Yes | |
| season | Yes |
search_playersRead-onlyInspect
Use to find a player's id by name (partial names work). Costs 1 credit.
| Name | Required | Description | Default |
|---|---|---|---|
| name | Yes | Full or partial name. | |
| limit | No | ||
| league | No | League. Defaults to mlb. One of: mlb, ncaabase. |
Output Schema
| Name | Required | Description |
|---|---|---|
| count | Yes | |
| players | Yes |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
20 tool updates
- First observed
get_game - First observed
get_games - First observed
get_injuries - First observed
get_leaders - First observed
get_line_movement - First observed
get_odds - First observed
get_pitch_mix - First observed
get_pitches - First observed
get_plate_appearances - First observed
get_player - First observed
get_player_games - First observed
get_player_props - First observed
get_prop_history - First observed
get_ratings - First observed
get_schedule - First observed
get_spray_chart - First observed
get_standings - First observed
get_team_stats - First observed
list_teams - First observed
search_players
Related MCP Connectors
NBA, WNBA and college basketball data: play-by-play, shot locations, box scores, odds. REST and MCP.
181MLB Stats API MCP — official MLB statistics (keyless).
Live odds, cross-book +EV and graded player-prop results across 37 books. Hosted endpoint included.
Sportsbook-derived no-vig fair value with confidence, provenance, and history over REST/MCP.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenancePublic read-only MCP server exposing today's free sports-betting projections, track record, methodology, engine versions, and per-game model reads from the Olympus Bets Analytics platform.MIT
- AlicenseAqualityAmaintenanceLive sports betting player props MCP server covering NBA, MLB, NFL, NHL, NCAA, and soccer. Unified from real sportsbooks into one REST API and a real MCP server (Streamable HTTP). Free tier, no card required.5MIT
- AlicenseNot gradedqualityBmaintenanceProps-first sports odds API with a hosted MCP server. Live odds and player props (moneyline, spreads, totals) across US sportsbooks, normalized to JSON. Tools: get_odds, get_props, get_events, get_books. API-key auth, free tier.MIT No Attribution
- AlicenseNot gradedqualityAmaintenanceGet live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, soccer, and more via MCP.139 npm2Apache 2.0
Glama MCP Gateway
Add one secure layer between your agents and this server.