Statcast MCP Server

A MCP (Model Context Protocol) server that lets you query MLB Statcast data using plain English. Ask your AI assistant about players, games, stats, leaderboards, and more — no coding required.

Built on pybaseball, this server gives AI assistants direct access to data from Baseball Savant, FanGraphs, and Baseball Reference.

What Can You Ask?

Once connected, just talk to your AI assistant naturally:

"How did Aaron Judge hit in July 2024?"
"Show me Gerrit Cole's pitch arsenal this season"
"Who had the highest exit velocity in 2024?"
"What were the NL standings at the end of 2023?"
"Find me the most undervalued hitters — compare xBA to actual BA"
"Who are the fastest players in baseball right now?"
"Show me every pitch from the Yankees-Red Sox game on July 4, 2024"

The AI translates your questions into the right data queries automatically.

Example: Prompt & Response

Here's what a typical exchange looks like when you use the Statcast MCP:

Prompt

"What were Gerrit Cole's arsenal statistics in 2023?"

Response

| Pitch Type | Usage | Pitches | PA | BA | SLG | Whiff% | K% | Run Val/100 | |-------------------|-------|---------|-----|------|-------|--------|------|-------------| | 4-Seam Fastball | 52.9% | 1,737 | 427 | .202 | .333 | 23.0% | 28.3% | +1.7 | | Slider | 20.8% | 683 | 175 | .186 | .251 | 32.7% | 29.1% | +1.4 | | Curveball | 12.1% | 396 | 97 | .215 | .269 | 24.4% | 27.8% | +1.4 | | Cutter | 7.0% | 231 | 65 | .262 | .377 | 31.1% | 23.1% | +1.6 | | Changeup | 7.1% | 233 | 54 | .235 | .510 | 28.6% | 13.0% | −1.3 |

His 4-seam fastball was his primary weapon (52.9% usage) with a .202 BA against and +1.7 run value per 100 pitches. The changeup was his only negative pitch (−1.3 run value).

Another prompt

"Who had the highest exit velocity in 2024?"

Response

The AI calls statcast_batter_exitvelo_barrels(year=2024) and returns the leaderboard — Aaron Judge led with a 97.0 mph average exit velocity and 21.8% barrel rate, followed by [other top hitters]...

Available Tools

| Tool | What It Does | |------|-------------| | player_lookup | Find any player's ID, years active, and database links | | statcast_search | Pitch-by-pitch data for a date range (optionally filtered by team) | | statcast_batter | Every pitch a specific batter saw in a date range | | statcast_batter_pitch_arsenal | Batting stats by pitch type (BA, SLG, wOBA vs fastballs, sliders, etc.) | | statcast_pitcher | Every pitch a specific pitcher threw in a date range | | season_batting_stats | Full-season batting stats from FanGraphs (AVG, OPS, WAR, wRC+, etc.) | | season_pitching_stats | Full-season pitching stats from FanGraphs (ERA, FIP, K/9, WAR, etc.) | | statcast_batter_expected_stats | xBA, xSLG, xwOBA leaderboard — who deserves better stats? | | statcast_pitcher_expected_stats | Expected stats allowed by pitchers | | statcast_batter_exitvelo_barrels | Exit velocity and barrel rate leaders | | statcast_pitcher_exitvelo_barrels | Exit velocity and barrel rate allowed by pitchers | | statcast_pitcher_pitch_arsenal | Pitch mix breakdown (% fastball, slider, curve, etc.) | | statcast_pitcher_arsenal_stats | Performance stats per pitch type (whiff rate, BA against, etc.) | | sprint_speed_leaderboard | Fastest players in baseball by sprint speed | | team_standings | Division standings for any season |

Quick Start

Prerequisites

Python 3.10+ — download here if you don't have it
An MCP-compatible client — such as Claude Desktop, Cursor, or VS Code with Copilot

Option 1: Install from PyPI (Recommended)

# Using uv (fastest)
uv pip install statcast-mcp

# Or using pip
pip install statcast-mcp

Option 2: Install from Source

git clone https://github.com/YOUR_USERNAME/statcast-mcp.git
cd statcast-mcp
uv pip install .

Setup

Claude Desktop

Add this to your Claude Desktop configuration file:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "statcast": {
      "command": "statcast-mcp"
    }
  }
}

If you installed from source and want to run it directly:

{
  "mcpServers": {
    "statcast": {
      "command": "uv",
      "args": ["run", "--directory", "/absolute/path/to/statcast-mcp", "statcast-mcp"]
    }
  }
}

Cursor

Open Cursor Settings → MCP and add a new server:

Name: statcast
Type: command
Command: statcast-mcp

Or add to your .cursor/mcp.json:

{
  "mcpServers": {
    "statcast": {
      "command": "statcast-mcp"
    }
  }
}

VS Code (Copilot)

Add to your VS Code settings.json:

{
  "mcp": {
    "servers": {
      "statcast": {
        "command": "statcast-mcp"
      }
    }
  }
}

Example Queries

Looking Up a Player

"Look up Shohei Ohtani"

Returns the player's MLBAM ID, FanGraphs ID, Baseball Reference ID, and years active.

Pitch-Level Data

"Show me all the pitches from the Dodgers game on October 15, 2024"

statcast_search(start_date="2024-10-15", team="LAD")

Batter Analysis

"What pitches did Juan Soto see from July 1 to July 31, 2024?"

statcast_batter(player_name="Juan Soto", start_date="2024-07-01", end_date="2024-07-31")

"How does Aaron Judge hit against different pitch types?" (e.g. 2023, 106 games)

statcast_batter_pitch_arsenal(year=2023, player_name="Aaron Judge")

Season Leaderboards

"Who were the top hitters in 2024 by wRC+?"

season_batting_stats(start_season=2024)

Expected Stats (Find Undervalued Players)

"Show me batters whose expected stats were way higher than their actual stats in 2024"

statcast_batter_expected_stats(year=2024)

Exit Velocity Leaders

"Who hit the ball hardest in 2024?"

statcast_batter_exitvelo_barrels(year=2024)

Pitcher Arsenal

"What pitches does Spencer Strider throw and how effective are they?"

statcast_pitcher_pitch_arsenal(year=2024)
statcast_pitcher_arsenal_stats(year=2024)

Sprint Speed

"Who are the fastest players in baseball?"

sprint_speed_leaderboard(year=2024)

Standings

"Show me the 2024 MLB standings"

team_standings(season=2024)

Data Sources

All data is sourced from:

Baseball Savant — Statcast pitch-level and leaderboard data (2008+)
FanGraphs — Season-level batting and pitching statistics
Baseball Reference — Player identification and cross-references

Reference Guide

For detailed tool-by-tool documentation, row limits, parameters, and usage patterns, see REFERENCE.md.

Notes

Date ranges: Statcast data is available from 2008 onward. Some metrics (exit velocity, launch angle) are only available from 2015+.
Query speed: Shorter date ranges return faster. For pitch-level data, keep ranges to 1-5 days when possible.
Rate limits: Baseball Savant limits individual requests to ~30,000 rows. The server handles splitting larger queries automatically.
Player names: Tools accept names like "Mike Trout", "Trout, Mike", or "Shohei Ohtani". The server resolves names to MLB IDs automatically.

Development

# Clone the repo
git clone https://github.com/YOUR_USERNAME/statcast-mcp.git
cd statcast-mcp

# Create a virtual environment and install in editable mode
uv venv
uv pip install -e ".[dev]"

# Run the server locally
statcast-mcp

# Test with the MCP Inspector
npx @modelcontextprotocol/inspector statcast-mcp

Contributing

Contributions are welcome! Some ideas:

Add more tools (game scores, team batting/pitching, historical data)
Improve player name resolution
Add data caching for faster repeated queries
Create prompt templates for common analyses

License

MIT

MCP Servers