statcast_batter_pitch_arsenal
Analyze batter performance against specific pitch types by retrieving batting statistics like BA, SLG, wOBA, whiff rate, K rate, run value, and hard-hit rate for each pitch type faced.
Instructions
Get batting stats broken down by pitch type for batters.
Returns BA, SLG, wOBA, whiff rate, K rate, run value, and hard-hit rate for each pitch type a batter faced (4-seam, slider, curve, changeup, etc.).
Args: year: Season year (e.g. 2024). player_name: Optional. Filter to a specific batter (e.g. 'Aaron Judge'). If omitted, returns the full leaderboard. min_plate_appearances: Minimum PA per pitch type to qualify (default 10).
Great for analyzing how a hitter performs against fastballs vs. breaking balls.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | ||
| player_name | No | ||
| min_plate_appearances | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/statcast_mcp/server.py:892-933 (handler)The tool handler 'statcast_batter_pitch_arsenal' fetches batter pitch arsenal data using 'pybaseball.statcast_batter_pitch_arsenal' and formats the output. It includes logic to filter for a specific player if provided.
@mcp.tool() def statcast_batter_pitch_arsenal( year: int, player_name: str | None = None, min_plate_appearances: int = 10, ) -> str: """Get batting stats broken down by pitch type for batters. Returns BA, SLG, wOBA, whiff rate, K rate, run value, and hard-hit rate for each pitch type a batter faced (4-seam, slider, curve, changeup, etc.). Args: year: Season year (e.g. 2024). player_name: Optional. Filter to a specific batter (e.g. 'Aaron Judge'). If omitted, returns the full leaderboard. min_plate_appearances: Minimum PA per pitch type to qualify (default 10). Great for analyzing how a hitter performs against fastballs vs. breaking balls. """ from pybaseball import statcast_batter_pitch_arsenal as _fn try: data = _fn(year, minPA=min_plate_appearances) except Exception as e: return f"Error fetching batter pitch arsenal data: {e}" if player_name: try: _, display = _resolve_player(player_name) data = _filter_player_rows(data, player_name) except ValueError as e: return str(e) if data.empty: return ( f"No pitch-type batting data for {player_name} in {year} at " f"{min_plate_appearances}+ PA per pitch type." ) header = f"Batting stats by pitch type for {display} ({year}):\n\n" return header + _fmt(data, max_rows=50) return _fmt(data, max_rows=50)