Mlb Data

Pulls everything you'd want from MLB via ESPN's public endpoints: live scores, standings, rosters, schedules, full box scores, play-by-play, win probability charts, injury reports, transactions, depth charts, and team/player stats. Zero configuration, no API keys required. Works through a CLI that avoids Python import hassles. Covers all 30 teams and handles season logic correctly (the MLB season runs April through October, so "current season" in February means last year). Won't help with minor leagues, college ball, or betting odds, but for major league data it's comprehensive and ready to go out of the box.

skills.sh installs: 775
GitHub stars: 268
last updated: Aug 21, 2026

View on GitHub

Install

$ npx -y skills add machina-sports/sports-skills --skill mlb-data --agent claude-code

Installs into .claude/skills of the current project.

Files

MLB Data

Before writing queries, consult references/api-reference.md for endpoints, ID conventions, and data shapes.

Setup

Before first use, check if the CLI is available:

which sports-skills || pip install sports-skills

If pip install fails with a Python version error, the package requires Python 3.10+. Find a compatible Python:

python3 --version  # check version
# If < 3.10, try: python3.12 -m pip install sports-skills
# On macOS with Homebrew: /opt/homebrew/bin/python3.12 -m pip install sports-skills

No API keys required.

Quick Start

Prefer the CLI — it avoids Python import path issues:

sports-skills mlb get_scoreboard
sports-skills mlb get_standings --season=2025
sports-skills mlb get_teams

CRITICAL: Before Any Query

CRITICAL: Before calling any data endpoint, verify:

Season year is derived from the system prompt's currentDate — never hardcoded.
If only a team name is provided, call get_teams to resolve the team ID before using team-specific commands.