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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
Tools
Public tool metadata for what this MCP can expose to an agent.
46 tools
get_stats2 params
Parameters* required
paramsobjectendpointstringget_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
datevalueseasonvaluegame_idvalueteam_idvalueend_datevaluesport_idintegerdefault: 1
start_datevalueopponent_idvalueinclude_series_statusbooleandefault: true
get_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
statsstringdefault: season
seasonvalueplayer_idintegerget_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
seasonvalueleague_idvaluedivision_idvaluestandings_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
limitvalueseasonvalueteam_idintegerleader_categorystringdefault: homeRuns
leader_game_typestringdefault: R
lookup_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
datevalueseasonintegerdefault: 2025
team_idintegerroster_typestringdefault: active
get_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
limitvalueseasonvalueleague_idvaluegame_typesvaluestat_groupvalueleader_categoriesstringget_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
teamvalueend_dtvalueend_rowvalueverbosebooleandefault: true
parallelbooleandefault: true
start_dtvaluestart_rowvalueget_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_rowvaluestart_dtvalueplayer_idintegerstart_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_rowvaluestart_dtvalueplayer_idintegerstart_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
yearintegerminBBEvalueend_rowvaluestart_rowvalueget_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
yearintegerminBBEvalueend_rowvaluestart_rowvalueget_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
yearintegerminPAvalueend_rowvaluestart_rowvalueget_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
yearintegerminPAvalueend_rowvaluestart_rowvalueget_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
yearintegerend_rowvaluestart_rowvalueget_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
yearintegerend_rowvaluestart_rowvalueget_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
yearintegerminPAintegerdefault: 25
end_rowvaluestart_rowvalueget_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
minPvalueyearintegerend_rowvaluestart_rowvaluearsenal_typestringdefault: average_speed
get_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
dataobjecttitlestringdefault:
colorbystringdefault: pitch_type
annotationstringdefault: pitch_type
legend_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
dataobjectsizeintegerdefault: 100
titlestringdefault:
widthintegerdefault: 500
heightintegerdefault: 500
colorbystringdefault: events
legend_titlestringdefault:
team_stadiumstringdefault: generic
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
indintegerdefault: 1
qualvalueleaguestringdefault: all
end_seasonvaluestart_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
laststringfirstvaluefuzzybooleandefault: false
reverse_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
teamstringseasonintegerget_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
yearvalueplayeridstringplayer_infobooleandefault: false
pitching_splitsbooleandefault: false
get_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
indintegerdefault: 1
leaguestringdefault: all
end_seasonvaluestart_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
indintegerdefault: 1
leaguestringdefault: all
end_seasonvaluestart_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
indintegerdefault: 1
leaguestringdefault: all
end_seasonvaluestart_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
teamvalueplayer_typevaluemcp-mlb-stats
MLB Stats API MCP — official MLB statistics (keyless).
Part of Pipeworx — an MCP gateway connecting AI agents to 785+ live data sources.
Tools
| Tool | Description |
|---|
Quick Start
Add to your MCP client (Claude Desktop, Cursor, Windsurf, etc.):
{
"mcpServers": {
"mlb-stats": {
"url": "https://gateway.pipeworx.io/mlb-stats/mcp"
}
}
}
Or connect to the full Pipeworx gateway for access to all 785+ data sources:
{
"mcpServers": {
"pipeworx": {
"url": "https://gateway.pipeworx.io/mcp"
}
}
}
Using with ask_pipeworx
Instead of calling tools directly, you can ask questions in plain English:
ask_pipeworx({ question: "your question about Mlb Stats data" })
The gateway picks the right tool and fills the arguments automatically.
More
License
MIT
Featured
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →