[Integrations](https://spiral.ai/integrations) › [Codex](https://spiral.ai/integrations/codex) › [Baseball Savant leaderboards](https://spiral.ai/integrations/codex/baseball-savant-leaderboards)

# How to Use Baseball Savant leaderboards in Codex

Returns season rankings for expected statistics, contact quality, sprint speed, defense, or pitch arsenals. Use it to compare players across the league before examining individual performances.

|  |  |
| --- | --- |
| Model | Baseball Savant leaderboards |
| 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 leaderboards in Codex

- Use Baseball Savant leaderboards for 2024 batter expected statistics and add a sortable project table comparing actual batting average and slugging percentage with their expected values.
- Use Baseball Savant leaderboards to look this up and give me the result as a table. Save the result in ./assets.
- Pull the latest numbers from Baseball Savant leaderboards and tell me what changed since last week.
- Check Baseball Savant leaderboards and summarize what you find in three bullet points.
- Pull the newest data from Baseball Savant leaderboards and give me the result as a table.

## How to set up Baseball Savant leaderboards in Codex

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

### Use Spiral's MCP server

1. **Add the hosted server**

```bash
codex mcp add spiral --url https://api.spiral.ai/mcp
```

2. **Sign in**: Codex opens the browser: sign in to Spiral and click Authorize. No API key. `codex mcp list` then shows Spiral.

```bash
codex mcp login spiral
```

### Use the Spiral skill

1. **Send Codex 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 leaderboards**: 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/get_leaderboard",
    "input": {
      "board": "expected_statistics",
      "season": 2008
    }
  }'
```

Then paste one of the prompts above: Codex finds Baseball Savant leaderboards on Spiral, shows the price and runs it.

Setup guide in the docs: https://spiral.ai/docs/quickstarts/codex

## Baseball Savant leaderboards tools and prices

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

## Settings you can ask for

| Setting | Allowed values | Default | Description |
| --- | --- | --- | --- |
| limit | 1 to 1000 | 50 | Maximum rows per page (default 50, max 1000). |
| cursor |  | — | Continuation cursor from a previous response's `next_cursor`; send it with the same other inputs to get the next page. |
| player_type | batter, pitcher | batter | `batter` (default) or `pitcher`; applies to `expected_statistics` and `statcast` only. |

## What can you do with Baseball Savant leaderboards in Codex?

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.

### 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.

## Overview

- [Alexandria](https://spiral.ai/providers/alexandria)
- [All Codex guides](https://spiral.ai/integrations/codex)

## Baseball Savant leaderboards in other agents

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

## More Codex guides

- [Baseball Savant MLB daily schedule](https://spiral.ai/integrations/codex/baseball-savant-mlb-daily-schedule)
- [Baseball Savant pitch search](https://spiral.ai/integrations/codex/baseball-savant-pitch-search)
- [Spiral media tools](https://spiral.ai/integrations/codex/spiral)
- [Baseball Savant pitch type summary](https://spiral.ai/integrations/codex/baseball-savant-pitch-type-summary)
- [YouTube video transcript](https://spiral.ai/integrations/codex/youtube-video-transcript)
- [Baseball Savant player plate appearances](https://spiral.ai/integrations/codex/baseball-savant-player-plate-appearances)

## Questions about Baseball Savant leaderboards in Codex

**Can Codex use Baseball Savant leaderboards?**

Yes. Add Spiral to Codex as an MCP server, and Codex can find and run Baseball Savant leaderboards like any built-in tool.

**How much does Baseball Savant leaderboards cost in Codex?**

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

**Do I need an Alexandria account to use Baseball Savant leaderboards in Codex?**

No. Spiral runs Baseball Savant leaderboards 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 leaderboards in Codex?**

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

**Does Codex wait while Baseball Savant leaderboards runs?**

Baseball Savant leaderboards runs in the background. Codex 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.

