# sports-leader-mcp

Free MCP server for live sports data. Get scores, standings, rosters, player stats, betting odds, play-by-play, injuries, transactions, and news across 17 sports and 139 leagues — NFL, NBA, MLB, NHL,…

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add wickwireadam-o0nh/sports-leader-mcp

# Browse available tools
npx -y @smithery/cli@latest tool list wickwireadam-o0nh/sports-leader-mcp

# Get full schema for a tool
npx -y @smithery/cli@latest tool get wickwireadam-o0nh/sports-leader-mcp get_scoreboard

# Call a tool
npx -y @smithery/cli@latest tool call wickwireadam-o0nh/sports-leader-mcp get_scoreboard '{}'
```

## Direct MCP Connection

Endpoint: `https://sports-leader-mcp--wickwireadam-o0nh.run.tools`

**Optional config:**
- `timeout` (query) — Request timeout in milliseconds for ESPN API calls
- `defaultSport` (query) — Default sports slug (e.g basketball, football)
- `defaultLeague` (query) — Default league slug (e.g. nba, nfl)

## Tools (20)

- `get_scoreboard` — Get live and scheduled games for a sport/league. Returns event IDs, scores, status, teams, start times, and venue. Use …
- `get_game_summary` — Get a full game summary: boxscore, plays, leaders, broadcasts, standings context, win probability. The richest single-c…
- `get_game_plays` — Get full play-by-play for a game from the Core API. For long games pass a high limit (e.g. 400).
- `get_game_odds` — Get betting odds (spread, moneyline, over/under) for a game. Optionally filter by sportsbook providerId.
- `get_game_probabilities` — Get the win-probability timeline for a game (probability of each team winning at each play).
- `get_standings` — Get league standings. Uses the correct /apis/v2/ path (the /site/v2/ path returns a stub).
- `get_league_leaders` — Get league-wide statistical leaders (points, rebounds, passing yards, etc. — varies by sport).
- `get_injuries` — Get the league-wide injury report (all teams). Works for NBA, NFL, NHL, MLB, Soccer. Returns 500 for MMA, Tennis, Golf.
- `get_transactions` — Get recent league transactions — signings, trades, waivers.
- `get_news` — Get real-time sports news from the Now API. Filter by sport, league, or team. Results include article URLs that can be …
- `get_teams` — List all teams in a league. Returns team IDs, names, abbreviations, colors, and logos. Use the IDs with get_team and ot…
- `get_team` — Get a team's info, roster, schedule, record, depth chart, injuries, transactions, history, news, or leaders. Pick which…
- `get_team_injuries` — Get the current injury report for a single team.
- `get_athlete_overview` — Get a player snapshot: season stats, next game, rotowire notes, recent news. The best single-call view of a player.
- `get_athlete_stats` — Get a player's full season stats with categories, labels, and glossary. Works best for NFL, NBA, NHL, MLB.
- `get_athlete_gamelog` — Get a player's game-by-game log with stats per game.
- `get_athlete_splits` — Get a player's statistical splits — home/away, by opponent, by month, by situation, etc.
- `list_sports_and_leagues` — Discover all valid sport and league slugs. Returns ESPN's full ontology of sports and leagues. Call this first when you…
- `search` — Global ESPN search for athletes, teams, news, and articles. Returns mixed results with IDs you can pass to other tools …
- `espn_fetch` — Escape hatch: fetch any ESPN URL and return its JSON. Use this for endpoints not covered by a dedicated tool, or to res…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get wickwireadam-o0nh/sports-leader-mcp <tool-name>
```

## Resources

- `sports://leagues` — Curated list of valid sport and league slug pairs for ESPN API tools. Read this once to know what values are valid for …
- `sports://reference/season-types` — Mapping of seasonType numeric codes used by ESPN API tools. Pass these as the `seasonType` parameter.
- `sports://reference/betting-providers` — Sportsbook provider IDs for the `providerId` parameter in the get_game_odds tool.
- `sports://reference/api-domains` — ESPN API base URL domains used by this server. Useful when constructing custom URLs via the espn_fetch tool.

## Prompts (5)

- `get-live-scores` (sport, league) — What games are happening right now?
- `player-stats-report` (player_name, sport, league) — Give me a full stats breakdown for a player
- `game-analysis` (sport, league, event_id) — Analyze a specific game in detail
- `league-overview` (sport, league) — What's the current state of a league?
- `compare-teams` (sport, league, team1_id, team2_id) — Compare two teams head to head