Summary
Connects Claude to official MLB statistics through eight core operations: pull game schedules and live feeds, check standings, grab team rosters and profiles, look up player stats and bios, and fetch full box scores for any game. Useful when you're building baseball analytics, need real-time game data for a chatbot, or want to answer stats questions without scraping. Part of the Pipeworx gateway, so you can either use it standalone or get it bundled with 673+ other data sources. Supports a natural language query mode that picks the right API call based on your question instead of making you specify tools manually.
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →
Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Tools
Public tool metadata for what this MCP can expose to an agent.
46 tools
get_stats2 params
Parameters* required
endpointstringparamsobjectget_scheduleGet list of games for a given date/range and/or team/opponent.9 params
Get list of games for a given date/range and/or team/opponent.
Parameters* required
datevalueend_datevaluegame_idvalueinclude_series_statusbooleandefault: true
opponent_idvalueseasonvaluesport_idintegerdefault: 1
start_datevalueteam_idvalueget_player_statsReturns a list of current season or career stat data for a given player.4 params
Returns a list of current season or career stat data for a given player.
Parameters* required
groupstringdefault: hitting
player_idintegerseasonvaluestatsstringdefault: season
get_standingsReturns a dict of standings data for a given league/division and season.4 params
Returns a dict of standings data for a given league/division and season.
Parameters* required
division_idvalueleague_idvalueseasonvaluestandings_typesstringdefault: regularSeason
get_team_leadersReturns a python list of stat leader data for a given team5 params
Returns a python list of stat leader data for a given team
Parameters* required
leader_categorystringdefault: homeRuns
leader_game_typestringdefault: R
limitvalueseasonvalueteam_idintegerlookup_playerGet data about players based on first, last, or full name.1 params
Get data about players based on first, last, or full name.
Parameters* required
namestringget_boxscoreGet a formatted boxscore for a given game.2 params
Get a formatted boxscore for a given game.
Parameters* required
game_idintegertimecodevalueget_team_rosterGet the roster for a given team.4 params
Get the roster for a given team.
Parameters* required
datevalueroster_typestringdefault: active
seasonintegerdefault: 2025
team_idintegerget_game_paceReturns data about pace of game for a given season (back to 1999).1 params
Returns data about pace of game for a given season (back to 1999).
Parameters* required
seasonvalueget_metaGet available values from StatsAPI for use in other queries, or look up descriptions for values found in API results. For example, to get a list of leader categories to use when calling team_leaders(): statsapi.meta('leagueLeaderTypes')2 params
Get available values from StatsAPI for use in other queries, or look up descriptions for values found in API results. For example, to get a list of leader categories to use when calling team_leaders(): statsapi.meta('leagueLeaderTypes')
Parameters* required
fieldsvaluetype_namestringget_available_endpointsGet MLB StatsAPI endpoints directly
Get MLB StatsAPI endpoints directly
No parameter schema in public metadata yet.
get_notesGet additional notes on an endpoint1 params
Get additional notes on an endpoint
Parameters* required
endpointstringget_game_scoring_play_dataReturns a dictionary of scoring plays for a given game containing 3 keys: * home - home team data * away - away team data * plays - sorted list of scoring play data1 params
Returns a dictionary of scoring plays for a given game containing 3 keys: * home - home team data * away - away team data * plays - sorted list of scoring play data
Parameters* required
game_idintegerget_last_gameGet the gamePk (game_id) for the given team's most recent completed game.1 params
Get the gamePk (game_id) for the given team's most recent completed game.
Parameters* required
team_idintegerget_league_leader_dataReturns a list of stat leaders overall or for a given league (103=AL, 104=NL).6 params
Returns a list of stat leaders overall or for a given league (103=AL, 104=NL).
Parameters* required
game_typesvalueleader_categoriesstringleague_idvaluelimitvalueseasonvaluestat_groupvalueget_linescoreGet formatted linescore data for a specific MLB game.1 params
Get formatted linescore data for a specific MLB game.
Parameters* required
game_idintegerget_next_gameGet the game ID for a team's next scheduled game.1 params
Get the game ID for a team's next scheduled game.
Parameters* required
team_idintegerget_game_highlight_dataReturns a list of highlight data for a given game.1 params
Returns a list of highlight data for a given game.
Parameters* required
game_idintegerget_statcast_dataPulls statcast play-level data from Baseball Savant for a given date range. INPUTS: start_dt: YYYY-MM-DD : the first date for which you want statcast data end_dt: YYYY-MM-DD : the last date for which you want statcast data team: optional (defaults to None) : city abbreviation...7 params
Pulls statcast play-level data from Baseball Savant for a given date range. INPUTS: start_dt: YYYY-MM-DD : the first date for which you want statcast data end_dt: YYYY-MM-DD : the last date for which you want statcast data team: optional (defaults to None) : city abbreviation...
Parameters* required
end_dtvalueend_rowvalueparallelbooleandefault: true
start_dtvaluestart_rowvalueteamvalueverbosebooleandefault: true
get_statcast_batter_dataPulls statcast pitch-level data from Baseball Savant for a given batter. ARGUMENTS start_dt : YYYY-MM-DD : the first date for which you want a player's statcast data end_dt : YYYY-MM-DD : the final date for which you want data player_id : INT : the player's MLBAM ID. Find this...5 params
Pulls statcast pitch-level data from Baseball Savant for a given batter. ARGUMENTS start_dt : YYYY-MM-DD : the first date for which you want a player's statcast data end_dt : YYYY-MM-DD : the final date for which you want data player_id : INT : the player's MLBAM ID. Find this...
Parameters* required
end_dtvalueend_rowvalueplayer_idintegerstart_dtvaluestart_rowvalueget_statcast_pitcher_dataPulls statcast pitch-level data from Baseball Savant for a given pitcher. ARGUMENTS start_dt : YYYY-MM-DD : the first date for which you want a player's statcast data end_dt : YYYY-MM-DD : the final date for which you want data player_id : INT : the player's MLBAM ID. Find thi...5 params
Pulls statcast pitch-level data from Baseball Savant for a given pitcher. ARGUMENTS start_dt : YYYY-MM-DD : the first date for which you want a player's statcast data end_dt : YYYY-MM-DD : the final date for which you want data player_id : INT : the player's MLBAM ID. Find thi...
Parameters* required
end_dtvalueend_rowvalueplayer_idintegerstart_dtvaluestart_rowvalueget_statcast_batter_exitvelo_barrelsRetrieves batted ball data for all batters in a given year. ARGUMENTS year: The year for which you wish to retrieve batted ball data. Format: YYYY. minBBE: The minimum number of batted ball events for each player. If a player falls below this threshold, they will be excluded f...4 params
Retrieves batted ball data for all batters in a given year. ARGUMENTS year: The year for which you wish to retrieve batted ball data. Format: YYYY. minBBE: The minimum number of batted ball events for each player. If a player falls below this threshold, they will be excluded f...
Parameters* required
end_rowvalueminBBEvaluestart_rowvalueyearintegerget_statcast_pitcher_exitvelo_barrelsRetrieves batted ball against data for all qualified pitchers in a given year. ARGUMENTS year: The year for which you wish to retrieve batted ball against data. Format: YYYY. minBBE: The minimum number of batted ball against events for each pitcher. If a player falls below thi...4 params
Retrieves batted ball against data for all qualified pitchers in a given year. ARGUMENTS year: The year for which you wish to retrieve batted ball against data. Format: YYYY. minBBE: The minimum number of batted ball against events for each pitcher. If a player falls below thi...
Parameters* required
end_rowvalueminBBEvaluestart_rowvalueyearintegerget_statcast_batter_expected_statsRetrieves expected stats based on quality of batted ball contact in a given year. ARGUMENTS year: The year for which you wish to retrieve expected stats data. Format: YYYY. minPA: The minimum number of plate appearances for each player. If a player falls below this threshold,...4 params
Retrieves expected stats based on quality of batted ball contact in a given year. ARGUMENTS year: The year for which you wish to retrieve expected stats data. Format: YYYY. minPA: The minimum number of plate appearances for each player. If a player falls below this threshold,...
Parameters* required
end_rowvalueminPAvaluestart_rowvalueyearintegerget_statcast_pitcher_expected_statsRetrieves expected stats based on quality of batted ball contact against in a given year. ARGUMENTS year: The year for which you wish to retrieve expected stats data. Format: YYYY. minPA: The minimum number of plate appearances against for each pitcher. If a player falls below...4 params
Retrieves expected stats based on quality of batted ball contact against in a given year. ARGUMENTS year: The year for which you wish to retrieve expected stats data. Format: YYYY. minPA: The minimum number of plate appearances against for each pitcher. If a player falls below...
Parameters* required
end_rowvalueminPAvaluestart_rowvalueyearintegerget_statcast_batter_percentile_ranksRetrieves percentile ranks for batters in a given year. ARGUMENTS year: The year for which you wish to retrieve percentile data. Format: YYYY. start_row: optional (defaults to None) : starting row index for truncating large results (0-based, inclusive) end_row: optional (defau...3 params
Retrieves percentile ranks for batters in a given year. ARGUMENTS year: The year for which you wish to retrieve percentile data. Format: YYYY. start_row: optional (defaults to None) : starting row index for truncating large results (0-based, inclusive) end_row: optional (defau...
Parameters* required
end_rowvaluestart_rowvalueyearintegerget_statcast_pitcher_percentile_ranksRetrieves percentile ranks for each player in a given year, including batters with 2.1 PA per team game and 1.25 for pitchers. It includes percentiles on expected stats, batted ball data, and spin rates, among others. ARGUMENTS year: The year for which you wish to retrieve per...3 params
Retrieves percentile ranks for each player in a given year, including batters with 2.1 PA per team game and 1.25 for pitchers. It includes percentiles on expected stats, batted ball data, and spin rates, among others. ARGUMENTS year: The year for which you wish to retrieve per...
Parameters* required
end_rowvaluestart_rowvalueyearintegerget_statcast_batter_pitch_arsenalRetrieves outcome data for batters split by the pitch type in a given year. ARGUMENTS year: The year for which you wish to retrieve pitch arsenal data. Format: YYYY. minPA: The minimum number of plate appearances for each player. If a player falls below this threshold, they wi...4 params
Retrieves outcome data for batters split by the pitch type in a given year. ARGUMENTS year: The year for which you wish to retrieve pitch arsenal data. Format: YYYY. minPA: The minimum number of plate appearances for each player. If a player falls below this threshold, they wi...
Parameters* required
end_rowvalueminPAintegerdefault: 25
start_rowvalueyearintegerget_statcast_pitcher_pitch_arsenalRetrieves high level stats on each pitcher's arsenal in a given year. ARGUMENTS year: The year for which you wish to retrieve expected stats data. Format: YYYY. minP: The minimum number of pitches thrown. If a player falls below this threshold, they will be excluded from the r...5 params
Retrieves high level stats on each pitcher's arsenal in a given year. ARGUMENTS year: The year for which you wish to retrieve expected stats data. Format: YYYY. minP: The minimum number of pitches thrown. If a player falls below this threshold, they will be excluded from the r...
Parameters* required
arsenal_typestringdefault: average_speed
end_rowvalueminPvaluestart_rowvalueyearintegerget_statcast_single_gamePulls statcast play-level data from Baseball Savant for a single game, identified by its MLB game ID (game_pk in statcast data) INPUTS: game_pk : 6-digit integer MLB game ID to retrieve start_row: optional (defaults to None) : starting row index for truncating large results (0...3 params
Pulls statcast play-level data from Baseball Savant for a single game, identified by its MLB game ID (game_pk in statcast data) INPUTS: game_pk : 6-digit integer MLB game ID to retrieve start_row: optional (defaults to None) : starting row index for truncating large results (0...
Parameters* required
end_rowvaluegame_pkintegerstart_rowvaluecreate_strike_zone_plotProduces a pitches overlaid on a strike zone using StatCast data Args: data: (pandas.DataFrame) StatCast pandas.DataFrame of StatCast pitcher data title: (str), default = '' Optional: Title of plot colorby: (str), default = 'pitch_type' Optional: Which category to color the ma...5 params
Produces a pitches overlaid on a strike zone using StatCast data Args: data: (pandas.DataFrame) StatCast pandas.DataFrame of StatCast pitcher data title: (str), default = '' Optional: Title of plot colorby: (str), default = 'pitch_type' Optional: Which category to color the ma...
Parameters* required
annotationstringdefault: pitch_type
colorbystringdefault: pitch_type
dataobjectlegend_titlestringdefault:
titlestringdefault:
create_spraychart_plotProduces a spraychart using statcast data overlayed on specified stadium Args: data: (pandas.DataFrame) StatCast pandas.DataFrame of StatCast batter data team_stadium: (str) Team whose stadium the hits will be overlaid on title: (str), default = '' Optional: Title of plot size...8 params
Produces a spraychart using statcast data overlayed on specified stadium Args: data: (pandas.DataFrame) StatCast pandas.DataFrame of StatCast batter data team_stadium: (str) Team whose stadium the hits will be overlaid on title: (str), default = '' Optional: Title of plot size...
Parameters* required
colorbystringdefault: events
dataobjectheightintegerdefault: 500
legend_titlestringdefault:
sizeintegerdefault: 100
team_stadiumstringdefault: generic
titlestringdefault:
widthintegerdefault: 500
create_bb_profile_plotPlots a given StatCast parameter split by bb_type Args: df: (pandas.DataFrame) pandas.DataFrame of StatCast batter data (retrieved through statcast, statcast_batter, etc) parameter: (str), default = 'launch_angle' Optional: Parameter to plot2 params
Plots a given StatCast parameter split by bb_type Args: df: (pandas.DataFrame) pandas.DataFrame of StatCast batter data (retrieved through statcast, statcast_batter, etc) parameter: (str), default = 'launch_angle' Optional: Parameter to plot
Parameters* required
dataobjectparameterstringdefault: launch_angle
create_teams_plotPlots a scatter plot with each MLB team Args: data: (pandas.DataFrame) pandas.DataFrame of Fangraphs team data (retrieved through team_batting or team_pitching) x_axis: (str) Stat name to be plotted as the x_axis of the chart y_axis: (str) Stat name to be plotted as the y_axis...4 params
Plots a scatter plot with each MLB team Args: data: (pandas.DataFrame) pandas.DataFrame of Fangraphs team data (retrieved through team_batting or team_pitching) x_axis: (str) Stat name to be plotted as the x_axis of the chart y_axis: (str) Stat name to be plotted as the y_axis...
Parameters* required
dataobjecttitlevaluex_axisstringy_axisstringget_pitching_stats_brefGet all pitching stats for a set season. If no argument is supplied, gives stats for current season to date.1 params
Get all pitching stats for a set season. If no argument is supplied, gives stats for current season to date.
Parameters* required
seasonvalueget_pitching_stats_rangeGet all pitching stats for a set time range. This can be the past week, the month of August, anything. Just supply the start and end date in YYYY-MM-DD format.2 params
Get all pitching stats for a set time range. This can be the past week, the month of August, anything. Just supply the start and end date in YYYY-MM-DD format.
Parameters* required
end_dtvaluestart_dtstringget_pitching_statsGet season-level pitching data from FanGraphs. Args: start_season: First season to retrieve data from end_season: Final season to retrieve data from. If None, returns only start_season. league: Either "all", "nl", "al", or "mnl" qual: Minimum number of plate appearances to be...5 params
Get season-level pitching data from FanGraphs. Args: start_season: First season to retrieve data from end_season: Final season to retrieve data from. If None, returns only start_season. league: Either "all", "nl", "al", or "mnl" qual: Minimum number of plate appearances to be...
Parameters* required
end_seasonvalueindintegerdefault: 1
leaguestringdefault: all
qualvaluestart_seasonintegerget_playerid_lookupLookup playerIDs (MLB AM, bbref, retrosheet, FG) for a given player Args: last (str, required): Player's last name. first (str, optional): Player's first name. Defaults to None. fuzzy (bool, optional): In case of typos, returns players with names close to input. Defaults to Fa...3 params
Lookup playerIDs (MLB AM, bbref, retrosheet, FG) for a given player Args: last (str, required): Player's last name. first (str, optional): Player's first name. Defaults to None. fuzzy (bool, optional): In case of typos, returns players with names close to input. Defaults to Fa...
Parameters* required
firstvaluefuzzybooleandefault: false
laststringreverse_lookup_playerRetrieve a table of player information given a list of player ids :param player_ids: list of player ids :type player_ids: list :param key_type: name of the key type being looked up (one of "mlbam", "retro", "bbref", or "fangraphs") :type key_type: str :rtype: :class:`pandas.co...2 params
Retrieve a table of player information given a list of player ids :param player_ids: list of player ids :type player_ids: list :param key_type: name of the key type being looked up (one of "mlbam", "retro", "bbref", or "fangraphs") :type key_type: str :rtype: :class:`pandas.co...
Parameters* required
key_typestringdefault: mlbam
player_idsarrayget_schedule_and_recordRetrieve a team's game-level results for a given season, including win/loss/tie result, score, attendance, and winning/losing/saving pitcher. If the season is incomplete, it will provide scheduling information for future games. ARGUMENTS season: Integer. The season for which y...2 params
Retrieve a team's game-level results for a given season, including win/loss/tie result, score, attendance, and winning/losing/saving pitcher. If the season is incomplete, it will provide scheduling information for future games. ARGUMENTS season: Integer. The season for which y...
Parameters* required
seasonintegerteamstringget_player_splitsReturns a dataframe of all split stats for a given player. If player_info is True, this will also return a dictionary that includes player position, handedness, height, weight, position, and team4 params
Returns a dataframe of all split stats for a given player. If player_info is True, this will also return a dictionary that includes player position, handedness, height, weight, position, and team
Parameters* required
pitching_splitsbooleandefault: false
player_infobooleandefault: false
playeridstringyearvalueget_pybaseball_standingsReturns a pandas DataFrame of the standings for a given MLB season, or the most recent standings if the date is not specified. ARGUMENTS season (int): the year of the season1 params
Returns a pandas DataFrame of the standings for a given MLB season, or the most recent standings if the date is not specified. ARGUMENTS season (int): the year of the season
Parameters* required
seasonvalueget_team_battingGet season-level Batting Statistics for Specific Team (from Baseball-Reference) ARGUMENTS: team : str : The Team Abbreviation (i.e. 'NYY' for Yankees) of the Team you want data for start_season : int : first season you want data for (or the only season if you do not specify an...4 params
Get season-level Batting Statistics for Specific Team (from Baseball-Reference) ARGUMENTS: team : str : The Team Abbreviation (i.e. 'NYY' for Yankees) of the Team you want data for start_season : int : first season you want data for (or the only season if you do not specify an...
Parameters* required
end_seasonvalueindintegerdefault: 1
leaguestringdefault: all
start_seasonintegerget_team_fieldingGet season-level Fielding Statistics for Specific Team (from Baseball-Reference) ARGUMENTS: team : str : The Team Abbreviation (i.e., 'NYY' for Yankees) of the Team you want data for start_season : int : first season you want data for (or the only season if you do not specify...4 params
Get season-level Fielding Statistics for Specific Team (from Baseball-Reference) ARGUMENTS: team : str : The Team Abbreviation (i.e., 'NYY' for Yankees) of the Team you want data for start_season : int : first season you want data for (or the only season if you do not specify...
Parameters* required
end_seasonvalueindintegerdefault: 1
leaguestringdefault: all
start_seasonintegerget_team_pitchingGet season-level Pitching Statistics for Specific Team (from Baseball-Reference) ARGUMENTS: team : str : The Team Abbreviation (i.e. 'NYY' for Yankees) of the Team you want data for start_season : int : first season you want data for (or the only season if you do not specify a...4 params
Get season-level Pitching Statistics for Specific Team (from Baseball-Reference) ARGUMENTS: team : str : The Team Abbreviation (i.e. 'NYY' for Yankees) of the Team you want data for start_season : int : first season you want data for (or the only season if you do not specify a...
Parameters* required
end_seasonvalueindintegerdefault: 1
leaguestringdefault: all
start_seasonintegerget_top_prospectsRetrieves the top prospects by team or leaguewide. It can return top prospect pitchers, batters, or both. ARGUMENTS team: The team name for which you wish to retrieve top prospects. If not specified, the function will return leaguewide top prospects. playerType: Either "pitche...2 params
Retrieves the top prospects by team or leaguewide. It can return top prospect pitchers, batters, or both. ARGUMENTS team: The team name for which you wish to retrieve top prospects. If not specified, the function will return leaguewide top prospects. playerType: Either "pitche...
Parameters* required
player_typevalueteamvalue@pipeworx/mlb-stats
MLB Stats API MCP — official MLB statistics: schedules, scores, rosters, player stats, standings, box scores. No auth.
Part of Pipeworx — an MCP gateway connecting AI agents to 1476+ live data sources.
Tools
schedule(date?, season?, team_id?, sport_id?)— game schedule by date / seasonstandings(league_id?, season?, date?)— current/historic standingsget_team(team_id)— team profileteam_roster(team_id, roster_type?, season?)— players on a teamget_player(player_id)— player profileplayer_stats(player_id, group?, season?, stats?)— career or season statsget_boxscore(game_pk)— full game box scoreget_game_feed(game_pk)— live game feed (play-by-play)
Data source
https://statsapi.mlb.com/api/v1/ — public, used by MLB.com itself.
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"mlb-stats": {
"url": "https://gateway.pipeworx.io/mlb-stats/mcp"
}
}
}
What this endpoint actually serves
tools/list at https://gateway.pipeworx.io/mlb-stats/mcp returns the tools in the table
above plus the shared Pipeworx meta-tools — ask_pipeworx,
discover_tools, search_within, remember/recall and the rest of the
gateway-wide set. So the tool count you see is larger than this table: a
single-pack endpoint currently lists roughly 30 shared tools alongside the
pack's own. The connection's initialize response states its exact scope, and
is the authoritative answer for a given day.
This is deliberate, not multiplexing by accident. The meta-tools are what let a
scoped connection answer a question this pack does not cover — via
ask_pipeworx, which routes across the whole catalog — without you adding a
second MCP server. There is currently no way to mount a pack endpoint without
them; if the extra schemas cost you more context than the routing is worth,
connect to the full gateway once rather than to several pack endpoints.
Or connect to the full Pipeworx gateway to get every pack's tools listed directly, instead of just this one's:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Both URLs reach the same gateway and the same 1476+ data sources. The
only difference is which pack's tools are listed directly; ask_pipeworx
reaches all of them from either one.
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English — this works on the pack endpoint above as well as on the full gateway:
ask_pipeworx({ question: "your question about Mlb Stats data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Plug Mailtrap into your AI workflow and let it handle the email.
Connect Mailtrap MCP →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →Make coding agent sessions - Searchable, Shareable, Vendor-neutral & Scored.
Try For Free →Your agent targets a perfect 10 Code Health score. Deterministic. Every commit.
Try For Free →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →