[Integrations](https://spiral.ai/integrations) › [Gemini CLI](https://spiral.ai/integrations/gemini-cli) › [Baseball Savant player search](https://spiral.ai/integrations/gemini-cli/baseball-savant-player-search)

# How to Use Baseball Savant player search in Gemini CLI

Finds players by full or partial name and supplies their MLBAM identifiers. Use it to resolve a name before requesting a player profile, plate appearances, or pitch data.

|  |  |
| --- | --- |
| Model | Baseball Savant player search |
| Available through | Alexandria |
| Category | Sports |
| Price | $0.00873 per call. |
| Returns | json |
| Runs | In the background |
| Setup | About 2 minutes, no API key |

## Prompts to try with Baseball Savant player search in Gemini CLI

- Use Baseball Savant player search to resolve Aaron Judge and Shohei Ohtani, then add their returned MLBAM identifiers to the project's baseball lookup table.
- Use Baseball Savant player 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 player search and tell me what changed since last week.
- Check Baseball Savant player search and summarize what you find in three bullet points.
- Pull the newest data from Baseball Savant player search and give me the result as a table.

## How to set up Baseball Savant player search in Gemini CLI

Pick the way that suits you. Each takes about two minutes.

### Use Spiral's MCP server

1. **Add the server**: Or add it to `~/.gemini/settings.json` yourself:

```bash
gemini mcp add --scope user --transport http spiral https://api.spiral.ai/mcp
```

2. **Sign in**: Start `gemini` and run:

```text
/mcp auth spiral
```

3. **Check it**: In Gemini CLI, run `/mcp`. From your shell:

```bash
gemini mcp list
```

### Use the Spiral skill

1. **Send Gemini CLI this message**: Your agent reads Spiral's skill and sets itself up.

```
set up https://spiral.ai/SKILL.md
```

2. **Sign in or paste a key**: Approve Spiral in the browser, or give the agent a key from the console.

### Use the Spiral CLI

1. **Install and sign in**: Installs the Spiral CLI, signs you in and adds its skill to your coding agents.

```bash
npx -y spiral-cli@latest init
```

### Call the Spiral API

1. **Create an API key**: In the console, under API keys.

2. **Run Baseball Savant player search**: One request; the result comes back by polling or a webhook.

```bash
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_players",
    "input": {
      "query": "<query>"
    }
  }'
```

Then paste one of the prompts above: Gemini CLI finds Baseball Savant player search on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/gemini-cli

## Baseball Savant player search tools and prices

- [MLB Baseball Savant · Search players](https://spiral.ai/tools/alexandria/baseballsavant-mlb-com/baseball-statcast/search_players) (Alexandria): $0.00873 per call.

## What can you do with Baseball Savant player search in Gemini CLI?

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.

### Player identity checks

Resolve a full or partial player name to an MLBAM identifier, then confirm the player using the profile's team and batting and throwing sides before attaching statistics to research notes.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Gemini CLI guides](https://spiral.ai/integrations/gemini-cli)

## Baseball Savant player search in other agents

- [Amp](https://spiral.ai/integrations/amp/baseball-savant-player-search)
- [ChatGPT](https://spiral.ai/integrations/chatgpt/baseball-savant-player-search)
- [Claude](https://spiral.ai/integrations/claude-desktop/baseball-savant-player-search)
- [Claude Code](https://spiral.ai/integrations/claude-code/baseball-savant-player-search)
- [Cline](https://spiral.ai/integrations/cline/baseball-savant-player-search)
- [Codex](https://spiral.ai/integrations/codex/baseball-savant-player-search)
- [Cursor](https://spiral.ai/integrations/cursor/baseball-savant-player-search)
- [Devin](https://spiral.ai/integrations/devin/baseball-savant-player-search)
- [dots](https://spiral.ai/integrations/dots/baseball-savant-player-search)
- [Factory Droid](https://spiral.ai/integrations/factory-droid/baseball-savant-player-search)
- [Gemini](https://spiral.ai/integrations/gemini/baseball-savant-player-search)
- [Google Antigravity](https://spiral.ai/integrations/antigravity/baseball-savant-player-search)
- [goose](https://spiral.ai/integrations/goose/baseball-savant-player-search)
- [Grok](https://spiral.ai/integrations/grok/baseball-savant-player-search)
- [Grok Build](https://spiral.ai/integrations/grok-build/baseball-savant-player-search)
- [Hermes](https://spiral.ai/integrations/hermes/baseball-savant-player-search)
- [Instinct](https://spiral.ai/integrations/instinct/baseball-savant-player-search)
- [Manus](https://spiral.ai/integrations/manus/baseball-savant-player-search)
- [Muse](https://spiral.ai/integrations/muse/baseball-savant-player-search)
- [Muse Code](https://spiral.ai/integrations/muse-code/baseball-savant-player-search)
- [n8n](https://spiral.ai/integrations/n8n/baseball-savant-player-search)
- [Notion](https://spiral.ai/integrations/notion/baseball-savant-player-search)
- [OpenClaw](https://spiral.ai/integrations/openclaw/baseball-savant-player-search)
- [opencode](https://spiral.ai/integrations/opencode/baseball-savant-player-search)
- [Perplexity](https://spiral.ai/integrations/perplexity/baseball-savant-player-search)
- [Raycast](https://spiral.ai/integrations/raycast/baseball-savant-player-search)
- [VS Code](https://spiral.ai/integrations/vscode/baseball-savant-player-search)
- [Windsurf](https://spiral.ai/integrations/windsurf/baseball-savant-player-search)
- [Zapier](https://spiral.ai/integrations/zapier/baseball-savant-player-search)

## More Gemini CLI guides

- [Baseball Savant player profile](https://spiral.ai/integrations/gemini-cli/baseball-savant-player-profile)
- [Baseball Savant trending players](https://spiral.ai/integrations/gemini-cli/baseball-savant-trending-players)
- [Baseball Savant player plate appearances](https://spiral.ai/integrations/gemini-cli/baseball-savant-player-plate-appearances)
- [CBS Sports fantasy projections](https://spiral.ai/integrations/gemini-cli/cbs-sports-fantasy-projections)
- [Baseball Savant pitch type summary](https://spiral.ai/integrations/gemini-cli/baseball-savant-pitch-type-summary)
- [CBS Sports fantasy rankings](https://spiral.ai/integrations/gemini-cli/cbs-sports-fantasy-rankings)

## Questions about Baseball Savant player search in Gemini CLI

**Can Gemini CLI use Baseball Savant player search?**

Yes. Add Spiral to Gemini CLI as an MCP server, and Gemini CLI can find and run Baseball Savant player search like any built-in tool.

**How much does Baseball Savant player search cost in Gemini CLI?**

$0.00873 per call. You pay from your Spiral balance as you go, with no subscription, and a failed run is not charged. Your Gemini CLI plan is separate.

**Do I need an Alexandria account to use Baseball Savant player search in Gemini CLI?**

No. Spiral runs Baseball Savant player 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 player search in Gemini CLI?**

About two minutes: add the server, then sign in, then check it.

**Does Gemini CLI wait while Baseball Savant player search runs?**

Baseball Savant player search runs in the background. Gemini CLI 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.

