sprint_speed_leaderboard
Retrieve MLB player sprint speed rankings from Statcast data to analyze baserunning performance and identify top speed athletes by season.
Instructions
Get the Statcast sprint speed leaderboard.
Returns each player's sprint speed in feet per second, measured on competitive running plays. Sprint speed is one of the best measures of raw speed and baserunning ability.
Args: year: Season year (e.g. 2024). min_opportunities: Minimum competitive run opportunities (default 10). player_name: Optional. Filter to one player (e.g. 'Ronald Acuna Jr.').
Great for finding the fastest players in baseball.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| year | Yes | ||
| min_opportunities | No | ||
| player_name | No |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |
Implementation Reference
- src/statcast_mcp/server.py:1103-1140 (handler)The handler function 'sprint_speed_leaderboard' which fetches sprint speed data using the pybaseball library and handles filtering and formatting.
def sprint_speed_leaderboard( year: int, min_opportunities: int = 10, player_name: str | None = None, ) -> str: """Get the Statcast sprint speed leaderboard. Returns each player's sprint speed in feet per second, measured on competitive running plays. Sprint speed is one of the best measures of raw speed and baserunning ability. Args: year: Season year (e.g. 2024). min_opportunities: Minimum competitive run opportunities (default 10). player_name: Optional. Filter to one player (e.g. 'Ronald Acuna Jr.'). Great for finding the fastest players in baseball. """ from pybaseball import statcast_sprint_speed as _fn try: data = _fn(year, min_opp=min_opportunities) except Exception as e: return f"Error fetching sprint speed data: {e}" if player_name: try: data = _filter_player_rows(data, player_name) except ValueError as e: return str(e) if data.empty: return ( f"No sprint speed row for {player_name} in {year} at " f"{min_opportunities}+ opportunities." ) return _fmt(data, max_rows=50)