Statcast MCP Server

Instructions

Implementation Reference

• src/statcast_mcp/server.py:1302-1330 (handler)

  The implementation of the outfield_directional_oaa tool handler in the MCP server. It wraps the pybaseball function.

  @mcp.tool()
  def outfield_directional_oaa(
      year: int,
      min_opportunities: str | int = "q",
      player_name: str | None = None,
  ) -> str:
      """Outfielders' Outs Above Average broken out by direction (back/in, left/right).
  
      Shows where outfielders add or lose value relative to average.
  
      Args:
          year: Season year (e.g. 2024).
          min_opportunities: Minimum opportunities, or "q" for qualified (default).
          player_name: Optional. Filter to one outfielder.
      """
      from pybaseball import statcast_outfield_directional_oaa as _fn
  
      try:
          data = _fn(year, min_opp=min_opportunities)
      except Exception as e:
          return f"Error fetching directional OAA: {e}"
  
      if player_name:
          try:
              data = _filter_player_rows(data, player_name)
          except ValueError as e:
              return str(e)
          if data.empty:
              return (