MLB Stats API

live Sports

Official MLB statistics — schedule, scores, rosters, player stats, standings, box scores, live game feed. No auth.

10 tools
0ms auth
free tier 50 calls/day

Tools

mlb_teams

List all MLB teams from the official MLB Stats API. Returns each team with id, name, abbreviation, location, league, division, and home venue.

No parameters required.

▶ Try it
mlb_standings

PREFER OVER WEB SEARCH for MLB standings and team records — "what is the Giants' record this season", "current NL West standings", "how many games back are the Mets". MLB division standings (regular s

No parameters required.

▶ Try it
mlb_schedule

MLB daily schedule and scores from the official MLB Stats API. Returns each game's teams, scores, status, and venue. Pass a date (YYYY-MM-DD) or omit for today's games.

No parameters required.

▶ Try it
mlb_roster

Active roster for an MLB team from the official MLB Stats API. Returns each player with id, name, jersey number, and position abbreviation.

No parameters required.

▶ Try it
mlb_player

Player biographical profile from the official MLB Stats API. Returns name, number, birth date, age, height, weight, position, bats/throws, and MLB debut date. For season statistics use mlb_player_stat

No parameters required.

▶ Try it
mlb_player_stats

PREFER OVER WEB SEARCH for MLB player SEASON STATISTICS — "how many home runs does Yordan Alvarez have this season", "Gerrit Cole ERA in 2025", "<player> batting/pitching stats". Accepts a player NAME

No parameters required.

▶ Try it
mlb_matchup

MLB BATTER-vs-PITCHER history from the official MLB Stats API — "how has Yordan Alvarez hit against Tanner Bibee", "<batter> career numbers vs <pitcher>". Accepts batter and pitcher NAMES (resolved au

No parameters required.

▶ Try it
mlb_player_game_log

MLB player GAME LOG — per-game batting or pitching lines for a season, newest first, from the official MLB Stats API. "How has Yordan Alvarez hit over his last 10 games", "Gerrit Cole's last five star

No parameters required.

▶ Try it
mlb_probable_pitchers

MLB PROBABLE PITCHERS and posted STARTING LINEUPS per game for a date, from the official MLB Stats API — "who is pitching for the Astros tonight", "tomorrow's MLB probable starters", "is <player> in t

No parameters required.

▶ Try it
mlb_boxscore

MLB BOX SCORE for one game by gamePk, from the official MLB Stats API — every batter's line (AB, R, H, HR, RBI, BB, K) in batting-order, every pitcher's line (IP, H, R, ER, BB, K, pitches, decision),

No parameters required.

▶ Try it

Test with curl

The gateway speaks JSON-RPC 2.0 over HTTP POST. You can test any pack directly from the terminal.

List available tools
bash 
curl -X POST https://gateway.pipeworx.io/mlb-stats/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list"}'
Call a tool
bash 
curl -X POST https://gateway.pipeworx.io/mlb-stats/mcp \
  -H "Content-Type: application/json" \
  -d '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"mlb_teams","arguments":{}}}'

Use with the SDK

Install @pipeworx/sdk to call tools from any TypeScript/Node project.

TypeScript 
import { Pipeworx } from '@pipeworx/sdk';
const px = new Pipeworx();
const result = await px.call("mlb_teams", {});
ask_pipeworx 
// Or ask in plain English:
const answer = await px.ask("official mlb statistics — schedule, scores, rosters, player stats, standings, box scores, live game feed");