# FastballAPI [Health: Active]

**Category:** 🏃 Sports  
**Repository:** https://github.com/noahowsh/fastballapi-mcp  
**GitHub Stars:** 0  
**Views:** 0  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/fastballapi

## Description
MLB since 2015 plus college: pitches, plate appearances, box scores, odds by book. REST and MCP.

## Tools
Capabilities this server exposes over MCP:

- **list_teams** — Team ids, abbreviations and colours for a season
- **search_players** — Find players by name
- **get_games** — Games with runs, hits and errors by season, date, range or team
- **get_schedule** — Upcoming games with the median line across sportsbooks
- **get_standings** — Standings from every final game, with run differential and Pythagorean record
- **get_injuries** — The latest injury report
- **get_ratings** — Our team Elo ratings, ranked
- **get_game** — One game: every batting and pitching line, each book's line, win probability
- **get_player** — Season batting (AVG, OBP, SLG, OPS, RE24) and pitching (ERA, WHIP, K/9)
- **get_player_games** — A player's full batting and pitching game log
- **get_leaders** — Season leaders among qualified batters and pitchers
- **get_team_stats** — Runs for and against, team batting and opponents' batting
- **get_pitch_mix** — A pitcher's arsenal: usage, velocity, whiff rate per pitch type
- **get_odds** — Every sportsbook's moneyline, run line and total for a game (5) or a day (10)
- **get_plate_appearances** — Plate-appearance play-by-play with base-out state, batted ball, win probability, RE24
- **get_pitches** — Pitch-by-pitch: count, type, velocity, location, result
- **get_spray_chart** — Where a batter or team hits the ball, by trajectory and field
- **get_line_movement** — Snapshots of each sportsbook's line before first pitch
- **get_player_props** — Player prop lines by sportsbook, opening and closing
- **get_prop_history** — A player's prop lines against the result, game by game

## Claude Desktop Quick Installation
No confirmed install details yet, so no config is published. Follow the setup steps in the repository above.

## Documentation

## What FastballAPI MCP server does

FastballAPI MCP server gives an AI client structured access to baseball data from FastballAPI. MLB coverage begins in 2015, with pitch-by-pitch data available for every pitch from 2018 and approximately 98–99% of seasonal pitches for 2015–2017. The service also includes NCAA Division I games carried by ESPN, but not every college game.

The tools cover both historical analysis and current game information. An agent can find teams and players, retrieve schedules and completed games, inspect standings, injuries, Elo ratings, leaders, team statistics, and player season or game-log data. More granular endpoints return pitch characteristics, plate-appearance context, spray locations, and sportsbook prices.

The listing belongs to the 🏃 Sports category and is most relevant for baseball analysis, game previews, statistical research, odds comparison, and questions that depend on play-level data.

## How it works

FastballAPI MCP server is hosted remotely at `https://mcp.fastballapi.com/mcp` and uses Streamable HTTP, so the MCP connection does not require a local installation. The API key can be supplied in the server URL, an `x-api-key` header, or an `Authorization: Bearer` header. Clients can connect and list available tools without a key, but executing a tool requires authentication.

The same service exposes REST calls as `POST /v1/{tool}` with a JSON request body. This provides a direct option for scripts and applications that do not use MCP. Python and Node.js quickstart examples are included in the repository.

Data access uses credits. The service provides 500 free credits per month without a card; paid plans and wallet top-ups are documented by the provider.

## Setup and configuration

Add the remote MCP URL to a compatible client and include an API key. For Claude Code, the documented command uses the HTTP transport:

```bash
claude mcp add --transport http fastballapi "https://mcp.fastballapi.com/mcp?key=YOUR_API_KEY"
```

For Claude Desktop, Cursor, and other clients that accept a remote MCP URL, configure the server with the same endpoint. The repository examples use the `FASTBALLAPI_API_KEY` environment variable for scripts. Codex sends the key as a bearer token, while the hosted MCP endpoint accepts the authentication methods described above.

The repository also contains 16 Claude skills for baseball analysis. They can be cloned with the repository, installed as a Claude Code plugin, or added with the skills CLI. These skills call the MCP tools and cover subjects such as pitch mix, run value, spray charts, odds analysis, prop modeling, and backtesting.

## Tools and capabilities

The 20 tools include:

- Team, player, schedule, game, standings, injury, rating, leader, and team-stat lookups.
- Season batting and pitching metrics, including AVG, OBP, SLG, OPS, RE24, ERA, WHIP, and K/9.
- Pitch-level fields such as count, pitch type, velocity, location, and result.
- Plate-appearance records with base-out state, batted-ball information, win probability, and RE24.
- Pitch-mix usage, velocity, and whiff rate by pitch type, plus batter or team spray charts.
- Moneyline, run-line, total, line-movement, and player-prop data from sportsbooks.
- Historical prop results for hits, home runs, total bases, RBI, pitcher strikeouts, and pitcher outs.

College coverage has narrower scope: pitch tools, spray charts, and injuries are not offered for NCAA data. MLB player props begin in May 2023, and college player props are not available.

_Full upstream README: https://allmcps.com/mcp/fastballapi/readme_