How to Use Baseball Savant pitch search in Claude Code
Returns individual Statcast pitch records, including pitch type, velocity, and result. Use it to investigate a specific outing or date window when season averages hide the detail you need.
Prompts to try with Baseball Savant pitch search in Claude Code
Copy an example into Claude Code, or ask in your own words.
Use Baseball Savant pitch search for pitches thrown to Aaron Judge from June 1 through June 7, 2024, and build a table of pitch type, velocity, and result.
Use Baseball Savant pitch search to look this up and give me the result as a table. Save the result in ./assets.
Pull the latest numbers from Baseball Savant pitch search and tell me what changed since last week.
Check Baseball Savant pitch search and summarize what you find in three bullet points.
Pull the newest data from Baseball Savant pitch search and give me the result as a table.
How to set up Baseball Savant pitch search in Claude Code
Pick the way that suits you. Each takes about two minutes.
Use Spiral's MCP server
- Add the hosted server
This adds Spiral to the current project. Add --scope user to use it in every project.
claude mcp add --transport http spiral https://api.spiral.ai/mcp
- Sign in
Start claude, type /mcp, choose spiral and Authenticate. Sign in to Spiral in the browser and click Authorize. No API key.
Use the Spiral skill
- Send Claude Code this message
Your agent reads Spiral's skill and sets itself up.
set up https://spiral.ai/SKILL.md
- Sign in or paste a key
Approve Spiral in the browser, or give the agent a key from the console.
Use the Spiral CLI
- Install and sign in
Installs the Spiral CLI, signs you in and adds its skill to your coding agents.
npx -y spiral-cli@latest init
Call the Spiral API
- Create an API key
In the console, under API keys.
- Run Baseball Savant pitch search
One request; the result comes back by polling or a webhook.
curl https://api.spiral.ai/v1/runs \ -H "Authorization: Bearer $SPIRAL_API_KEY" \ -H "Content-Type: application/json" \ -H "Idempotency-Key: $(uuidgen)" \ -d '{ "provider": "alexandria", "model": "baseballsavant-mlb-com/baseball-statcast/search_statcast", "input": { "end_date": "<end_date>", "start_date": "<start_date>" } }'
Then paste one of the prompts above: Claude Code finds Baseball Savant pitch search on Spiral, shows the price and runs it.
Baseball Savant pitch search providers and prices
Spiral runs Baseball Savant pitch search through Alexandria. Open a card for today's price, with every fee included.
Settings you can ask for
Ask Claude Code for any of these in your prompt.
| Setting | Allowed values | Default | Description |
|---|---|---|---|
| Limit | 1 to 1000 | 200 | Maximum rows per page (default 200, max 1000). |
| Game type | R, F, D, L, W, or S | R |
|
| Player ID | a number from 1 | MLBAM player id (the | |
| Player type | batter or pitcher | batter |
|
Every API field of MLB Baseball Savant · Search statcast is on its tool page: open its card above.
What can you do with Baseball Savant pitch search in Claude Code?
Build a baseball research panel that connects player discovery and daily games with season rankings and individual plays. A coding agent can populate the project's views with Baseball Savant profiles, pitch summaries, plate appearances, and pitch records.
Morning baseball research notes
Organize yesterday's games, identify trending players, resolve their names, and confirm their profiles. Add hitter plate appearances, pitch type summaries, individual pitches, and season rankings to explain the performances worth reviewing.
Broadcast matchup preparation
Start with the day's games and trending players to research. Confirm player identities, compare season rankings, examine pitchers' arsenals and hitters' plate appearances, and select individual pitch examples for preparation notes.
Weekly story shortlist
Use trending players as research leads, then resolve each player and check the biography. Test possible stories against season rankings, recent plate appearances, pitch summaries, individual pitch records, and the games in which they occurred.
Baseball data literacy lesson
Choose a trending MLB player, resolve the name, and confirm the profile. Use the schedule, season leaderboard, pitch summary, plate appearances, and pitch records to teach the difference between a game, a season average, a completed plate appearance, and an individual pitch.
Pitcher arsenal review
Resolve a pitcher and confirm the profile, then compare recent pitch usage, velocity, spin, and whiff rate with the season baseline. Inspect individual pitches to locate the outings behind a change.
Hitter results and contact review
Compare a hitter's actual and expected season statistics, then examine recent plate appearances and results against different pitch types. Use individual pitch records to investigate specific sequences.
Game research index
Organize a day's MLB games and connect hitter plate appearances with their game identifiers. Add pitch records for the same date to create a navigable index for a baseball research project.
More on Baseball Savant pitch search and Claude Code
Overview
Baseball Savant pitch search in other agents
Questions about Baseball Savant pitch search in Claude Code
Can Claude Code use Baseball Savant pitch search?
Yes. Add Spiral to Claude Code as an MCP server, and Claude Code can find and run Baseball Savant pitch search like any built-in tool.
How much does Baseball Savant pitch search cost in Claude Code?
$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Claude Code plan is separate.
Do I need an Alexandria account to use Baseball Savant pitch search in Claude Code?
No. Spiral runs Baseball Savant pitch search on its own Alexandria account. You sign in to Spiral once and never paste a key.
How long does it take to set up Baseball Savant pitch search in Claude Code?
About two minutes: add the hosted server, then sign in.
Does Claude Code wait while Baseball Savant pitch search runs?
Baseball Savant pitch search runs in the background. Claude Code starts the run, checks on it and gives you the json when it's ready.
When did Statcast reach every MLB ballpark?
All 30 parks had Statcast by 2015.
Are all batted-ball measurements tracked directly?
No. Baseball Savant includes estimates for a limited subset of batted balls that were not tracked directly.
Why can a player be missing from a qualified leaderboard?
The expected-statistics board requires 2.1 plate appearances per team game for batters and 1.25 for pitchers. Players below those thresholds do not qualify for that view.
Where do the older pitch velocities come from?
Baseball Savant identifies Pitch F/X as the source of its 2008-2016 pitch velocities.
Did pitch-location measurements change in 2026?
Yes. Through 2025, horizontal and vertical plate locations referred to the front of home plate; from 2026, they refer to the middle to align with ABS.
Start using Baseball Savant pitch search in Claude Code
One Spiral account for every tool your agent needs. No subscription; you pay per run.
Paste this into Claude Code:
set up https://spiral.ai/SKILL.md


