mlb-mcp

Overview

The MLB Stats MCP Server is a comprehensive Python implementation that provides structured access to Major League Baseball statistics through multiple data sources. It integrates with the MLB Stats API, pybaseball library, and other baseball data providers to deliver detailed analytics. The server features well-organized code structure with separate modules for tools (MLB StatsAPI, Statcast, pybaseball plotting) and utilities, making it modular and maintainable.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• mlb_statsapi_tools

  MLB StatsAPI tool definitions for accessing MLB statistics

  Try:Get the current standings for the AL EastTry:Retrieve player statistics for Mike Trout
• statcast_tools

  Statcast data tool definitions for advanced baseball analytics

  Try:Get statcast data for last night's Yankees gameTry:Find exit velocity for home runs hit in May
• pybaseball_plotting_tools

  Generate matplotlib plots and return base64 encoded images

  Try:Create a heatmap of hit locations for a specific playerTry:Generate a pitch type distribution chart
• pybaseball_supp_tools

  Supplemental pybaseball functions for Fangraphs, Baseball Reference, and other data sources

  Try:Get WAR leaders from FangraphsTry:Retrieve historical standings from Baseball Reference

Note: Tool names were inferred from the project structure and directory organization, as the README doesn't provide explicit documentation of individual tools or their signatures.

Comparable tools

Installation

curl -LsSf https://astral.sh/uv/install.sh | sh

uv venv
source .venv/bin/activate  # On Unix/macOS
# or
.venv\Scripts\activate  # On Windows

uv pip install -e .

"mcp-baseball-stats": {
  "command": "{PATH_TO_UV}",
  "args": [
    "--directory",
    "{PROJECT_DIRECTORY}",
    "run",
    "python",
    "-m",
    "mlb_stats_mcp.server"
  ],
  "env": {
    "MLB_STATS_LOG_FILE": "{LOG_FILE_PATH}",
    "MLB_STATS_LOG_LEVEL": "DEBUG"
  }
}

FAQ

What data sources does this MCP server integrate with?

The server integrates with MLB Stats API, pybaseball library for statcast data, Fangraphs, and Baseball Reference.

Does the server support generating visualizations?

Yes, it includes matplotlib plotting tools that can generate and return base64 encoded images.

Compare mlb-mcp with