Skip to main content
Glama

FastballAPI

Server Details

MLB since 2015 plus college: pitches, plate appearances, box scores, odds by book. REST and MCP.

Ownership verified
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 tools
get_game
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to mlb. One of: mlb, ncaabase.
game_idYesESPN game id, from get_games or get_schedule.

Output Schema

ParametersJSON Schema
NameRequiredDescription
gameYes
oddsYes
battingYes
pitchingYes
win_probabilityYes
plate_appearancesYes
get_games
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
toNoTo date, YYYY-MM-DD.
dateNoOne date, YYYY-MM-DD (US Eastern).
fromNoFrom date, YYYY-MM-DD.
teamNoTeam id or abbreviation.
limitNoMax games (default 50).
leagueNoLeague. Defaults to mlb. One of: mlb, ncaabase.
offsetNo
seasonNoSeason (a year, e.g. 2025; default: the latest).
statusNo
season_typeNoregular or postseason (default both).

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
gamesYes
next_offsetNo
get_injuries
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
dateNoYYYY-MM-DD (default: the latest).
teamNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
dateYes
noteNo
countYes
injuriesYes
get_leaders
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
statYes
limitNo
leagueNoLeague. Defaults to mlb. One of: mlb, ncaabase.
min_ipNoOverride the innings minimum.
min_paNoOverride the plate-appearance minimum.
seasonNoSeason (a year, e.g. 2025; default: the latest).

Output Schema

ParametersJSON Schema
NameRequiredDescription
statYes
countYes
seasonYes
leadersYes
qualifierYes
get_line_movement
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to mlb. One of: mlb, ncaabase.
game_idYes
providerNoOne sportsbook, e.g. DraftKings.

Output Schema

ParametersJSON Schema
NameRequiredDescription
gameYes
noteNo
movementYes
snapshotsYes
get_odds
Read-only
Inspect

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).

ParametersJSON Schema
NameRequiredDescriptionDefault
dateNoA day's games, YYYY-MM-DD (US Eastern).
leagueNoLeague. Defaults to mlb. One of: mlb, ncaabase.
game_idNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
noteNo
toolNo
countNo
gamesNo
creditsNo
estimate_onlyNo
get_pitches
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoMax pitches (default 500).
offsetNo
seasonNoSeason (a year; default: the latest; ignored with game_id).
game_idNo
batter_idNo
pitch_typeNoESPN abbreviation, e.g. FF, SL, CH, CU, SI, FC.
pitcher_idNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
noteYes
countYes
pitchesYes
next_offsetNo
get_pitch_mix
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
seasonNoSeason (a year; default: the latest; ignored with game_id).
pitcher_idYesESPN athlete id.

Output Schema

ParametersJSON Schema
NameRequiredDescription
mixYes
noteNo
countYes
seasonYes
pitcherYes
pitchesYes
get_plate_appearances
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
rispNoRunners in scoring position only.
teamNoBatting team (id or abbreviation).
limitNoMax rows (default 200).
inningNo
leagueNoLeague. Defaults to mlb. One of: mlb, ncaabase.
offsetNo
resultNoe.g. home-run, strikeout, walk, single, double, ground-out.
seasonNoSeason (a year; default: the latest; ignored with game_id).
game_idNo
batter_idNo
pitcher_idNo
season_typeNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
next_offsetNo
plate_appearancesYes
get_player
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to mlb. One of: mlb, ncaabase.
player_idYesESPN athlete id, from search_players.

Output Schema

ParametersJSON Schema
NameRequiredDescription
noteYes
playerYes
battingYes
pitchingYes
get_player_games
Read-only
Inspect

Use for a player's game log: every game's batting line and pitching line, newest first, optionally one season. Costs 5 credits.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNo
leagueNoLeague. Defaults to mlb. One of: mlb, ncaabase.
offsetNo
seasonNoSeason (a year, e.g. 2025; default: the latest).
player_idYes
season_typeNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
battingYes
pitchingYes
player_idYes
next_offsetNo
get_player_props
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
marketNoOne 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_idNoGame id: every player's props for that game.
to_dateNoWith player_id: last date (default: no end), YYYY-MM-DD (the game's date).
bookmakerNoBookmaker key, e.g. draftkings, fanduel, pinnacle.
from_dateNoWith player_id: first date, YYYY-MM-DD (the game's date).
player_idNoPlayer id (e.g. 33192) from search_players. With from_date: that player's props across games.
estimate_onlyNoReturn what this call would cost, without charging or running it.
snapshot_typeNoclosing (default): the last line before the game starts. opening: the first one captured.

Output Schema

ParametersJSON Schema
NameRequiredDescription
noteNo
toolNo
countNo
gamesNo
propsNo
creditsNo
estimate_onlyNo
snapshot_typeNo
next_from_dateNo
credits_per_gameNo
get_prop_history
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
limitNoGames to return, oldest first (default 50, max 200). next_from_date says where to continue.
marketYesThe 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_dateNoLast date, YYYY-MM-DD (the game's date).
bookmakerNoOne book's closing line instead of the median across books, e.g. draftkings.
from_dateNoFirst date, YYYY-MM-DD (the game's date).
player_idYesPlayer id (e.g. 33192) from search_players.

Output Schema

ParametersJSON Schema
NameRequiredDescription
noteNo
statYes
toolNo
countYes
gamesYes
marketYes
creditsNo
summaryYes
bookmakerYes
player_idYes
truncatedNo
player_nameYes
estimate_onlyNo
next_from_dateNo
get_ratings
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to mlb. One of: mlb, ncaabase.
seasonNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
methodYes
seasonYes
ratingsYes
get_schedule
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
daysNo
teamNoTeam id or abbreviation.
leagueNoLeague. Defaults to mlb. One of: mlb, ncaabase.

Output Schema

ParametersJSON Schema
NameRequiredDescription
daysYes
countYes
gamesYes
get_spray_chart
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
teamNo
seasonNoSeason (a year; default: the latest; ignored with game_id).
batter_idNo
include_ballsNoAdd each ball in play's x/y (up to 3,000).

Output Schema

ParametersJSON Schema
NameRequiredDescription
ballsNo
seasonYes
by_fieldYes
balls_noteNo
balls_in_playYes
by_trajectoryYes
get_standings
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to mlb. One of: mlb, ncaabase.
seasonNoSeason (a year, e.g. 2025; default: the latest).

Output Schema

ParametersJSON Schema
NameRequiredDescription
noteYes
countYes
seasonYes
standingsYes
get_team_stats
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
teamNo
leagueNoLeague. Defaults to mlb. One of: mlb, ncaabase.
seasonNoSeason (a year, e.g. 2025; default: the latest).

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
teamsYes
methodYes
seasonYes
list_teams
Read-only
Inspect

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.

ParametersJSON Schema
NameRequiredDescriptionDefault
leagueNoLeague. Defaults to mlb. One of: mlb, ncaabase.
seasonNoSeason (a year, e.g. 2025; default: the latest).

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
teamsYes
seasonYes
search_players
Read-only
Inspect

Use to find a player's id by name (partial names work). Costs 1 credit.

ParametersJSON Schema
NameRequiredDescriptionDefault
nameYesFull or partial name.
limitNo
leagueNoLeague. Defaults to mlb. One of: mlb, ncaabase.

Output Schema

ParametersJSON Schema
NameRequiredDescription
countYes
playersYes

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 20 tool updates
    • First observedget_game
    • First observedget_games
    • First observedget_injuries
    • First observedget_leaders
    • First observedget_line_movement
    • First observedget_odds
    • First observedget_pitch_mix
    • First observedget_pitches
    • First observedget_plate_appearances
    • First observedget_player
    • First observedget_player_games
    • First observedget_player_props
    • First observedget_prop_history
    • First observedget_ratings
    • First observedget_schedule
    • First observedget_spray_chart
    • First observedget_standings
    • First observedget_team_stats
    • First observedlist_teams
    • First observedsearch_players

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    C
    maintenance
    Public 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
  • A
    license
    A
    quality
    A
    maintenance
    Live 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.
    5
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Props-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
  • A
    license
    Not graded
    quality
    A
    maintenance
    Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, soccer, and more via MCP.
    139 npm
    2
    Apache 2.0
Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.