Statcast MCP Server

Instructions

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)