Provides tools for accessing Chess.com's published-data API, including player profiles, stats, clubs, and leaderboards.
Provides tools for interacting with the Lichess API, including users, top players, broadcasts, and the daily puzzle.
Provides tools for accessing the MLB Stats API, covering MLB and MiLB scores, statistics, and related baseball data.
Provides tools for accessing the NHL Web API, covering NHL scores, statistics, and related hockey data.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Sports Hub MCP Server show me today's NBA scores and Premier League odds"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
A unified MCP server that aggregates 42 sports API providers into a single service. 410 tools covering scores, stats, odds, esports, college sports, chess, motorsport, boxing, AFL, and more across 70+ sports.
Each provider works independently. You only need API keys for the providers you use. Missing keys don't block startup — tools return an error when called without their key.
Works with:
NBA scores, Premier League odds, Tennis H2H — all from a single MCP server.
Related MCP server: Sports Hub MCP Server
OS | Status |
macOS | Supported |
Linux | Supported |
Windows | Supported |
Client | Status | Notes |
Claude Desktop | Supported | Anthropic's desktop app |
Claude Code (CLI) | Supported |
|
Cursor | Supported | Built-in MCP |
Windsurf (Codeium) | Supported | Built-in MCP |
Continue.dev | Supported | Open-source AI assistant |
Cline | Supported | VS Code extension |
Zed | Supported | Built-in MCP |
ChatGPT Desktop | Supported | OpenAI desktop app |
Gemini CLI | Supported | Google CLI |
Any MCP client | Supported | Stdio + HTTP/SSE transport |
Uses the stdio transport from the MCP SDK. Works with any LLM (Claude, GPT, Gemini, Llama, Mistral, etc.).
Requirements: Node.js 18+, npm.
These providers work out of the box. Just build and run.
Prefix | Provider | Coverage | Tools | Notes |
| 20+ sports | 10 | Unofficial — can break | |
| NHL | 13 | Undocumented but stable | |
| MLB/MiLB | 13 | Official, undocumented | |
| Formula 1 (1950+) | 13 | Community-maintained | |
| F1 live telemetry | 12 | Live race weekends only | |
| German football | 10 | Bundesliga focus | |
| 40+ sports | 13 | Test key auto, watermarks | |
| College sports | 8 | 5 req/s rate limit | |
| Football, basketball, MMA + streams | 7 | V1 free, V2 needs paid key | |
| Chess (users, top players, broadcasts, daily puzzle) | 7 | ~20 req/sec/IP | |
| Chess (profiles, stats, clubs, leaderboards) | 7 | Throttles on parallel calls | |
| AFL (Australian Football League) | 6 | Honest UA required | |
| MotoGP/Moto2/Moto3/MotoE | 7 | Unofficial — can break | |
| Formula E | 7 | Unofficial — can break | |
| NASCAR Cup/Xfinity/Truck | 3 | Unofficial CDN feeds | |
| Dota 2 analytics | 11 | 60 req/min, 50k/mo | |
| NFL fantasy | 10 | ~1000 req/min | |
| EuroLeague + EuroCup basketball | 6 | Keyless feeds | |
| Historical football results + odds | 2 | CSV, 25+ leagues |
Tip: Use
SPORTS_HUB_PROVIDERS=freeto load only these 19 providers (~165 tools).
Registration takes 1-2 minutes. All keys are free.
Prefix | Provider | Coverage | Tools | Free Limit | Get Key |
| PandaScore | Esports (13 titles) | 14 | 1000 req/hr | |
| API-Football | Soccer (960+ leagues) | 15 | 100 req/day | |
| API-Sports | 9 sports | 10 | 100 req/day/sport | |
| API-Tennis | Tennis (ATP/WTA/ITF) | 12 | 100 req/day | |
| BallDontLie | NBA/NFL/MLB/NHL | 10 | Basic tier | |
| CricketData | Cricket | 10 | 100 req/day | |
| Entity Sport | Cricket (250+ comps) | 12 | Free plan | |
| football-data.org | Soccer (12 leagues) | 11 | 10 req/min | |
| Sportmonks | Soccer | 12 | 3000 req/hr | |
| SportsDataIO | 9 sports | 12 | 1000 req/mo | |
| The Odds API | 70+ sports odds | 9 | 500 req/mo | |
| Odds-API.io | 34 sports odds | 10 | Free account | |
| Sports Game Odds | 55+ leagues odds | 10 | Trial | |
| Lumify | Odds, splits + AI bet analysis (8 sports) | 14 | Free trial key | |
| Fighting Tomatoes | MMA | 8 | 200 req/mo | |
| Live Golf API | Golf (PGA/DP World) | 8 | Free tier | |
| iSportsAPI | Football/Basketball (Asia) | 10 | Free tier | |
| SportDevs | Rugby/Volleyball/Handball | 12 | Trial | |
| MySportsFeeds | NFL/NBA/MLB/NHL | 12 | Free non-commercial | |
| GolfCourseAPI | 30K+ golf courses | 6 | 300 req/day | |
| College Football Data | NCAA football | 14 | 1000 req/mo | |
| Boxing Data API | Pro boxing (fighters/bouts/titles) | 8 | 100 req/mo | |
| Highlightly | Multi-sport highlights + odds | 6 | 100 req/day |
Providers with missing keys don't block the server — they just return an error when called. Register keys incrementally as you need them.
npx mcp-sports-hubnpm install -g mcp-sports-hub
mcp-sports-hubgit clone https://github.com/lacausecrypto/mcp-sports-hub.git
cd mcp-sports-hub
npm install
npm run buildThis server is published on the official MCP Registry as io.github.lacausecrypto/sports-hub. MCP clients that support the registry can discover and install it automatically.
npx mcp-sports-hub# Via flag
npx mcp-sports-hub --http
# Via env
SPORTS_HUB_HTTP=1 SPORTS_HUB_PORT=3000 npx mcp-sports-hubEndpoints:
POST /mcp — MCP protocol (Streamable HTTP with SSE)
GET /health — Health check ({"status":"ok","providers":19,"sessions":0,"mode":"session"})
Supports CORS and multi-client session management via the mcp-session-id header. Default port: 3000.
Each client gets its own session, created on initialize and addressed afterwards by its session id. Building a session costs ~90 ms for the 165-tool free preset, paid once per client rather than per request. Idle sessions are reaped.
SPORTS_HUB_MAX_SESSIONS=200 # concurrent sessions before new ones get a 503
SPORTS_HUB_SESSION_TTL=1800 # seconds a session may sit idle
SPORTS_HUB_STATELESS=1 # opt out: build a throwaway server per requestSPORTS_HUB_STATELESS=1 suits several replicas behind a load balancer with no sticky routing. It pays the build cost on every call, so prefer sessions for a single instance.
⚠ Security: HTTP mode binds to
127.0.0.1(loopback) by default. SettingSPORTS_HUB_HOST=0.0.0.0exposes an unauthenticated MCP endpoint to your whole network — anyone who can reach it can use your configured API keys. DNS-rebinding protection only blocks browser-origin attacks, not direct clients. Only expose it behind a reverse proxy with auth/TLS.SPORTS_HUB_CORS_ORIGINSmust list explicit origins (a literal*is rejected).
A Dockerfile and smithery.yaml are included for container hosting on Smithery. The hosted endpoint serves the keyless free preset, so clients connect with zero setup. The deploy sets SPORTS_HUB_DNS_REBINDING_PROTECTION=0 because Smithery's proxy forwards a non-localhost Host header.
SPORTS_HUB_DNS_REBINDING_PROTECTION=0disables the Host/Origin check (it is on by default). Only set it when the server runs behind a trusted proxy that owns routing — never for a server directly reachable by browsers on localhost.
Only set keys for providers you want:
# Free — no key needed:
# ESPN, NHL, MLB, Jolpica F1, OpenF1, OpenLigaDB, NCAA, TheSportsDB (test key),
# SportSRC (V1), Lichess, Chess.com, Squiggle (AFL),
# MotoGP, Formula E, NASCAR, OpenDota, Sleeper
# Optional (defaults to test key)
export THESPORTSDB_API_KEY="your-key" # https://www.thesportsdb.com/
# Requires free registration
export PANDASCORE_TOKEN="your-token" # https://pandascore.co/
export API_SPORTS_KEY="your-key" # https://api-sports.io/
export API_FOOTBALL_KEY="your-key" # https://www.api-football.com/
export API_TENNIS_KEY="your-key" # https://api-tennis.com/
export BALLDONTLIE_API_KEY="your-key" # https://www.balldontlie.io/
export CRICKETDATA_API_KEY="your-key" # https://cricketdata.org/
export ENTITY_SPORT_KEY="your-key" # https://www.entitysport.com/
export FOOTBALL_DATA_API_KEY="your-key" # https://www.football-data.org/
export SPORTMONKS_API_KEY="your-key" # https://www.sportmonks.com/
export SPORTSDATA_IO_KEY="your-key" # https://sportsdata.io/
export THE_ODDS_API_KEY="your-key" # https://the-odds-api.com/
export ODDS_API_IO_KEY="your-key" # https://odds-api.io/
export SPORTS_GAME_ODDS_KEY="your-key" # https://sportsgameodds.com/
export FIGHTING_TOMATOES_API_KEY="your-key" # https://fightingtomatoes.com/
export LIVE_GOLF_API_KEY="your-key" # https://livegolfapi.com/
export ISPORTSAPI_KEY="your-key" # https://www.isportsapi.com/
export SPORTDEVS_API_KEY="your-key" # https://sportdevs.com/
export GOLFCOURSE_API_KEY="your-key" # https://golfcourseapi.com/
export MYSPORTSFEEDS_USER="your-user" # https://www.mysportsfeeds.com/
export MYSPORTSFEEDS_PASS="your-pass"
export CFBD_API_KEY="your-key" # https://collegefootballdata.com/key
export LUMIFY_API_KEY="your-key" # https://lumify.ai/Windows (PowerShell):
$env:API_SPORTS_KEY = "your-key"
$env:PANDASCORE_TOKEN = "your-token"Windows (cmd):
set API_SPORTS_KEY=your-key
set PANDASCORE_TOKEN=your-tokenfields parameterSports APIs return very wide objects, and every byte a tool returns is spent from the model's context window. A single espn_get_scoreboard-style team listing is ~300 KB of JSON, of which the part anyone wants is under 3 KB.
Every tool accepts an optional fields parameter: a comma-separated list of key names to keep, matched at any depth. Branches that match nothing are dropped, and a matched key keeps its whole value.
// espn_get_teams { "sport": "basketball", "league": "nba" }
// -> 297 KB
// espn_get_teams { "sport": "basketball", "league": "nba",
// "fields": "id,abbreviation,displayName,location" }
// -> 2.9 KB, same 30 teamsIf fields matches nothing, the tool says so and lists the top-level keys it did see, rather than returning an empty object.
Responses are also capped. Above the limit, the longest lists in the payload are shortened until it fits (so the JSON still parses) and a note reports how many items were dropped.
SPORTS_HUB_MAX_RESULT_BYTES=40000 # default; serialized bytes per tool resultConfig file locations:
macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
Windows: %APPDATA%\Claude\claude_desktop_config.json
Linux: ~/.config/claude/claude_desktop_config.json
{
"mcpServers": {
"sports-hub": {
"command": "node",
"args": ["/absolute/path/to/mcp-sports-hub/dist/index.js"],
"env": {
"PANDASCORE_TOKEN": "your-token",
"API_SPORTS_KEY": "your-key",
"THE_ODDS_API_KEY": "your-key"
}
}
}
}Windows path: "args": ["C:/Users/you/mcp-sports-hub/dist/index.js"]
Only include env vars for providers you need. Omit env entirely for free-only providers.
claude mcp add sports-hub node /absolute/path/to/mcp-sports-hub/dist/index.jsOr in .claude/settings.json:
{
"mcpServers": {
"sports-hub": {
"command": "node",
"args": ["/absolute/path/to/mcp-sports-hub/dist/index.js"],
"env": {
"PANDASCORE_TOKEN": "your-token"
}
}
}
}By default, only the free preset is loaded (19 providers, ~165 tools — no API keys needed). Use SPORTS_HUB_PROVIDERS to change what's loaded:
# Default — free providers only (no config needed)
npx mcp-sports-hub
# Load ALL 42 providers (410 tools)
SPORTS_HUB_PROVIDERS=all npx mcp-sports-hub
# Use a preset
SPORTS_HUB_PROVIDERS=us-major npx mcp-sports-hub
# Pick specific providers
SPORTS_HUB_PROVIDERS=espn,nhl,odds npx mcp-sports-hub
# Exclude from all (prefix with -)
SPORTS_HUB_PROVIDERS=-sportsdata,-mma npx mcp-sports-hubPreset | Providers | Tools | Needs keys? |
| 19 no-key providers (espn, nhl, mlb, f1, openf1, openliga, sportsdb, ncaa, sportsrc, lichess, chesscom, squiggle, motogp, formulae, nascar, opendota, sleeper, euroleague, footballdatauk) | ~165 | No |
| all 42 providers | 410 | Yes (for key-required providers) |
| lichess, chesscom | 14 | No |
| espn, nhl, mlb, ncaa, cfbd, bdl, msf, nascar, sleeper | ~93 | Some |
| espn, apifootball, footballdata, sportmonks, openliga, sportsrc, footballdatauk, highlightly | ~73 | Some |
| f1, openf1 | 25 | No |
| f1, openf1, motogp, formulae, nascar | ~42 | No |
| pandascore, opendota | 25 | Some |
| odds, oddsio, sgo, lumify | 43 | Yes |
| cricket, entitycricket | 22 | Yes |
| livegolf, golfcourse | 14 | Some |
All GET responses are cached in memory for 60 seconds by default. This protects against duplicate calls and rate limit waste. Configure with:
SPORTS_HUB_CACHE_TTL=120 # seconds (0 to disable)The cache key includes a digest of the request's auth headers, so two API keys never read each other's entries. Concurrent identical requests are collapsed into a single upstream call, and a 404/410 is remembered briefly (SPORTS_HUB_NEGATIVE_CACHE_TTL, default 30s) so a wrong ID can't be re-fetched in a loop.
429 and 5xx responses are retried with exponential backoff, honouring Retry-After when the upstream sends one. Client errors (4xx other than 408/425/429) and timeouts are not retried.
SPORTS_HUB_MAX_RETRIES=2 # extra attempts after the first (0 disables)
SPORTS_HUB_RETRY_BASE_MS=300 # backoff base; doubles per attemptIn Claude Desktop config:
"env": {
"SPORTS_HUB_PROVIDERS": "us-major",
"THE_ODDS_API_KEY": "your-key"
}All tools follow {provider}_{action}:
espn_get_scoreboard — Live scores (ESPN)
nhl_get_standings — NHL standings
mlb_get_game_boxscore — MLB box score
f1_get_race_results — F1 results (1950+)
openf1_get_laps — F1 live telemetry
pandascore_get_lives — Live esports matches
apifootball_get_fixtures — Soccer fixtures (960+ leagues)
odds_get_odds — Betting odds (70+ sports)
sportsrc_get_xg_stats — Expected goals (xG)Beyond tools, the server exposes:
Resources (readable catalogs, no API call):
sportshub://providers — the full provider catalog (prefix, name, coverage, required key)
sportshub://presets — all presets and the providers they load
sportshub://provider/{key} — details for one provider (with key autocompletion)
Prompts (curated slash-command workflows over the 410 tools):
whats-on-today · compare-odds {event} · motorsport-weekend {series} · league-standings {league} · team-deep-dive {team} · f1-race {season} {round}
All tools are annotated readOnly / idempotent so clients can skip confirmation prompts.
src/
├── index.ts # Imports + registers all 42 providers; transports
├── shared/
│ ├── http.ts # fetchJson, fetchText, buildUrl, toolResult, errorResult
│ │ # + retry/backoff, coalescing, keyed cache
│ ├── catalog.ts # provider catalog + presets (single source of truth)
│ ├── annotations.ts # central read-only annotations + titles
│ ├── tool-pipeline.ts # central `fields` param, size cap, empty-result hints
│ ├── projection.ts # field projection used by the pipeline
│ ├── slim.ts # strips $schema boilerplate from tools/list
│ ├── resources.ts # MCP resources (provider/preset catalogs)
│ └── prompts.ts # MCP prompts (curated workflows)
└── providers/
├── espn.ts # 10 tools — no key
├── nhl.ts # 13 tools — no key
├── mlb-stats.ts # 13 tools — no key
├── jolpica-f1.ts # 13 tools — no key
├── openf1.ts # 12 tools — no key
├── openligadb.ts # 10 tools — no key
├── golfcourse.ts # 6 tools — GOLFCOURSE_API_KEY
├── thesportsdb.ts # 13 tools — optional key
├── pandascore.ts # 14 tools — PANDASCORE_TOKEN
├── api-football.ts # 15 tools — API_FOOTBALL_KEY
├── api-sports.ts # 10 tools — API_SPORTS_KEY
├── api-tennis.ts # 12 tools — API_TENNIS_KEY
├── balldontlie.ts # 10 tools — BALLDONTLIE_API_KEY
├── cricketdata.ts # 10 tools — CRICKETDATA_API_KEY
├── entity-sport-cricket.ts # 12 tools — ENTITY_SPORT_KEY
├── football-data.ts # 11 tools — FOOTBALL_DATA_API_KEY
├── sportmonks.ts # 12 tools — SPORTMONKS_API_KEY
├── sportsdata-io.ts # 12 tools — SPORTSDATA_IO_KEY
├── the-odds-api.ts # 9 tools — THE_ODDS_API_KEY
├── odds-api-io.ts # 10 tools — ODDS_API_IO_KEY
├── sports-game-odds.ts # 10 tools — SPORTS_GAME_ODDS_KEY
├── lumify.ts # 14 tools — LUMIFY_API_KEY
├── fighting-tomatoes.ts # 8 tools — FIGHTING_TOMATOES_API_KEY
├── live-golf.ts # 8 tools — LIVE_GOLF_API_KEY
├── isportsapi.ts # 10 tools — ISPORTSAPI_KEY
├── sportdevs.ts # 12 tools — SPORTDEVS_API_KEY
├── mysportsfeeds.ts # 12 tools — MYSPORTSFEEDS_USER/PASS
├── sportsrc.ts # 7 tools — V1 free, V2 needs paid key (not exposed)
├── ncaa.ts # 8 tools — no key
├── cfbd.ts # 14 tools — CFBD_API_KEY
├── lichess.ts # 7 tools — no key
├── chess-com.ts # 7 tools — no key
├── squiggle.ts # 6 tools — no key
├── motogp.ts # 7 tools — no key
├── formula-e.ts # 7 tools — no key
├── nascar.ts # 3 tools — no key
├── opendota.ts # 11 tools — no key
├── sleeper.ts # 10 tools — no key
├── euroleague.ts # 6 tools — no key
├── football-data-uk.ts # 2 tools — no key (CSV)
├── boxing.ts # 8 tools — BOXING_DATA_API_KEY
└── highlightly.ts # 6 tools — HIGHLIGHTLY_API_KEYEach provider exports register(server). Keys are checked at call time, not startup.
Fork the repository
Create src/providers/my-api.ts exporting register(server: McpServer)
Prefix tool names: myapi_get_something
Import + call in src/index.ts
npm run build to verify
Submit a PR
MIT
Get Chess.com club details by URL id (the slug after /club/ in the web URL).
Inputs: club_id (required), fields.
Get the list of titled Chess.com players from a country (returns usernames and titles).
Inputs: country (required), fields.
Get Chess.com global leaderboards across all categories (daily, daily960, live_rapid, live_blitz, live_bullet, tactics, rush, battle).
Inputs: fields.
Get a Chess.com player's public profile (name, country, joined date, last online, title, etc.).
Inputs: username (required), fields.
List the YYYY/MM archive URLs containing a player's monthly game history.
Inputs: username (required), fields.
Get the list of Chess.com clubs a player belongs to (with last-activity timestamps).
Inputs: username (required), fields.
Get a Chess.com player's stats by time control (daily, rapid, blitz, bullet) and chess960, with current ratings, best, and W/L/D records.
Inputs: username (required), fields.
Get information about a specific athlete, including bio, stats, and career history.
Inputs: sport (required), league (required), athlete_id (required), fields.
Get a detailed summary of a specific event/game, including play-by-play, box score, leaders, and game info.
Inputs: sport (required), league (required), event_id (required), fields.
Get the latest news articles for a sport/league, including headlines, descriptions, and links.
Inputs: sport (required), league (required), limit, fields.
Get live or date-specific scores for a sport/league. Returns current scoreboard with game status, scores, and basic game info.
Inputs: sport (required), league (required), dates, limit, +1 more.
Get available seasons for a sport/league, including season types (preseason, regular, postseason) and date ranges.
Inputs: sport (required), league (required), fields.
Get league standings. Returns conference/division standings with team records, win/loss, and ranking info.
Inputs: sport (required), league (required), group, fields, +1 more.
Get detailed information about a specific team, including record, stats, venue, and next event.
Inputs: sport (required), league (required), team_id (required), fields.
Get the full roster for a specific team, including player names, positions, jersey numbers, and basic stats.
Inputs: sport (required), league (required), team_id (required), fields.
List all teams in a league. Returns team names, IDs, abbreviations, logos, and locations.
Inputs: sport (required), league (required), limit, fields.
Get a team's schedule for a season, including past results and upcoming games.
Inputs: sport (required), league (required), team_id (required), fields, +1 more.
List the clubs participating in a EuroLeague/EuroCup season (names, codes, venues, country).
Inputs: season_year (required), fields, competition.
Get a game's full box score (per-player and team stats for both teams). Use a game code from euroleague_get_games.
Inputs: game_code (required), season_year (required), fields, competition.
Get a game's header/summary: final and per-quarter scores, teams, coaches. Use a game code from euroleague_get_games.
Inputs: game_code (required), season_year (required), fields, competition.
Get a game's full play-by-play feed (every event by quarter). Use a game code from euroleague_get_games.
Inputs: game_code (required), season_year (required), fields, competition.
Get all EuroLeague/EuroCup games for a season (teams, scores, dates, round, status).
Inputs: season_year (required), fields, competition.
List the rounds (game days) of a EuroLeague/EuroCup season.
Inputs: season_year (required), fields, competition.
List Formula 1 circuits for a given season or all-time. Returns circuit names, locations, and coordinates.
Inputs: limit, fields, offset, season.
List Formula 1 constructors/teams for a given season or all-time.
Inputs: limit, fields, offset, season.
Get Formula 1 World Constructors' Championship standings for a given season.
Inputs: limit, fields, offset, season.
Get all race results for a specific driver in a given season. Use driver IDs like 'hamilton', 'max_verstappen', 'leclerc'.
Inputs: driver_id (required), limit, fields, offset, +1 more.
List Formula 1 drivers for a given season or all-time. Returns driver IDs, names, nationalities, and other info.
Inputs: limit, fields, offset, season.
Get Formula 1 World Drivers' Championship standings for a given season.
Inputs: limit, fields, offset, season.
Get lap times for a specific race. Can return all laps or a specific lap number. Data available from 1996 onwards.
Inputs: round (required), season (required), lap, limit, +2 more.
Get pit stop data for a specific race. Can return all pit stops or a specific stop number. Data available from 2012 onwards.
Inputs: round (required), season (required), stop, limit, +2 more.
Get Formula 1 qualifying results. Returns Q1/Q2/Q3 times for drivers in a specific qualifying session.
Inputs: limit, round, fields, offset, +1 more.
Get Formula 1 race results. Returns finishing positions, drivers, constructors, times, and status for a season or specific round.
Inputs: limit, round, fields, offset, +1 more.
Get the Formula 1 race schedule/calendar for a given season, including circuit info and race dates.
Inputs: limit, fields, offset, season.
List all Formula 1 seasons from 1950 to present, including Wikipedia links.
Inputs: limit, fields, offset.
Get Formula 1 sprint race results for a specific round.
Inputs: limit, round, fields, offset, +1 more.
Get historical matches (results + bookmaker odds) for a league and season from football-data.co.uk. Returns the most recent matches first; filter by team and cap with limit.
Inputs: league (required), season (required), team, limit, +1 more.
List the football-data.co.uk league codes usable with footballdata_uk_get_matches, and how to form the season code.
Inputs: fields.
List Formula E championships (one per season, from 2014-15 to the current season) with their ids and status. The id (championshipId) feeds the standings tools.
Inputs: fields.
Get the Formula E drivers' championship standings for a championship (season). Pass a championshipId from formulae_get_championships.
Inputs: championship_id (required), fields.
Get details for a single Formula E race (sessions, circuit, schedule). Use a race id from formulae_get_races.
Inputs: race_id (required), fields.
Get the race results / classification for a Formula E race (driver, team, position, points). Use a race id from formulae_get_races.
Inputs: race_id (required), fields.
List Formula E races / E-Prix with id, name, country, city, date and result-availability flags. Paginated — use page to advance. Each race id feeds formulae_get_race / formulae_get_race_results.
Inputs: page, fields.
List Formula E teams with wins, podiums and race starts.
Inputs: fields.
Get the Formula E teams' championship standings for a championship (season). Pass a championshipId from formulae_get_championships.
Inputs: championship_id (required), fields.
List official Lichess broadcast tournaments (live coverage of OTB events). Returns up to ~20 most recent.
Inputs: max, fields.
Get the Lichess puzzle of the day, including the source game and the solution moves.
Inputs: fields.
Get information about a Lichess team: description, member count, leader, open/closed status.
Inputs: team_id (required), fields.
Get the top N players for a Lichess performance variant (bullet, blitz, rapid, classical, etc.).
Inputs: perf (required), n, fields.
Get current Lichess Arena tournaments (created, started, and recently finished).
Inputs: fields.
Get a Lichess user's public profile, including per-variant ratings, played games, and account flags.
Inputs: username (required), fields.
Get realtime online + streaming status for up to 100 Lichess users in a single call.
Inputs: ids (required), fields.
List all MLB divisions with their IDs, names, and associated leagues.
Inputs: fields.
Get detailed game data from the live feed including plays, box score, and line score.
Inputs: game_pk (required), fields.
Get the box score for a game with full batting and pitching stats for both teams.
Inputs: game_pk (required), fields.
Get the line score (inning-by-inning scoring summary) for a game.
Inputs: game_pk (required), fields.
Get play-by-play data for a specific game including all at-bats and pitches.
Inputs: game_pk (required), fields.
Get league stat leaders for categories like home runs, batting average, ERA, strikeouts, etc.
Inputs: leaderCategories (required), fields, season, sportId.
Get detailed player information including bio, position, and optionally hydrated stats.
Inputs: player_id (required), fields, hydrate.
Get detailed statistics for a player by stat type and group.
Inputs: group (required), player_id (required), stats_type (required), fields, +1 more.
Get the MLB game schedule for a date or date range. Returns games with scores, status, and teams.
Inputs: date, fields, teamId, endDate, +2 more.
Get league standings with win/loss records, division ranks, and streaks.
Inputs: fields, season, leagueId, standingsTypes.
Get a team's roster with player names, positions, jersey numbers, and status.
Inputs: team_id (required), fields, season, rosterType.
List MLB teams with their IDs, names, venues, divisions, and leagues.
Inputs: fields, season, sportId.
Search for players by name. Returns matching players with their IDs, teams, and positions.
Inputs: names (required), fields, sportId.
List the racing categories (MotoGP, Moto2, Moto3, MotoE) for a season, with their UUIDs. Use a seasonUuid from motogp_get_seasons; the returned categoryUuid feeds sessions and standings.
Inputs: season_uuid (required), fields.
List the events (Grands Prix) in a season with circuit, country and dates. Each event's UUID feeds motogp_get_sessions.
Inputs: season_uuid (required), fields, is_finished.
List MotoGP riders with their profile data (name, number, country, team). Optionally filter by category UUID.
Inputs: fields, category_uuid.
List MotoGP seasons with their UUIDs and year. The id (seasonUuid) feeds the categories/events/standings tools. current:true marks the live season.
Inputs: fields.
Get the full classification (results) of a session: rider, team, constructor, time/gap and points. Use a session id from motogp_get_sessions.
Inputs: session_id (required), test, fields.
List the sessions (practice, qualifying, race, etc.) for an event and category. Pass eventUuid from motogp_get_events and categoryUuid from motogp_get_categories. Each session id feeds motogp_get_session_classification.
Inputs: event_uuid (required), category_uuid (required), fields.
Get the championship standings for a season and category (riders' or constructors' points table). Pass seasonUuid and categoryUuid.
Inputs: season_uuid (required), category_uuid (required), fields.
Get per-driver lap times and speeds for a specific race. Use the race_id from nascar_get_schedule.
Inputs: year (required), race_id (required), series_id (required), fields.
Get the live race feed: current lap, flag state, laps to go, leader and per-vehicle running order. When no race is live, fields are in an idle state (flag_state 9, race_id -1).
Inputs: fields.
Get the NASCAR race schedule for a season and series, including track, dates, winners and stage info for completed races.
Inputs: year (required), series_id (required), fields.
Get detailed information about a specific NCAA game, including play-by-play, box score, and stats.
Inputs: sport (required), game_id (required), fields.
Get the latest NCAA news, optionally filtered by sport.
Inputs: sport, fields.
Get NCAA rankings/polls (AP, Coaches, CFP, etc.) for a sport.
Inputs: sport (required), poll, week, year, +2 more.
Get a team's NCAA schedule for a season.
Inputs: sport (required), team_id (required), year, fields.
Get the NCAA scoreboard for a sport and division. Returns games with scores, status, and basic info.
Inputs: sport (required), division (required), date, fields.
Get NCAA standings for a sport and division, optionally for a specific year.
Inputs: sport (required), year, fields, division.
Get player or team statistics for an NCAA sport/division.
Inputs: sport (required), division (required), year, fields, +1 more.
Get NCAA teams in a division, optionally filtered by conference.
Inputs: sport (required), division (required), fields, conference_id.
Get the current NHL draft rankings and prospect information.
Inputs: fields.
Get the box score for a specific NHL game. Includes goals, assists, shots, saves, and other stats.
Inputs: game_id (required), fields.
Get the game landing page data for an NHL game. Includes summary, three stars, scoring plays, and more.
Inputs: game_id (required), fields.
Get the full play-by-play feed for an NHL game. Contains every event (shots, goals, penalties, faceoffs, etc.).
Inputs: game_id (required), fields.
Get detailed information about an NHL player -- bio, career stats, current season stats, awards.
Inputs: player_id (required), fields.
Get the game-by-game stats log for an NHL player in a given season.
Inputs: player_id (required), fields, season, game_type.
Get the NHL schedule for a given date. Returns all games, start times, teams, and venues.
Inputs: date, fields.
Get live and final scores for today's NHL games.
Inputs: fields.
Get NHL standings. Optionally filter by date or season.
Inputs: date, fields, season.
Get the NHL stat leaders for a given category (points, goals, assists, wins, etc.).
Inputs: fields, season, category.
Get the roster for an NHL team. Returns forwards, defensemen, and goalies with jersey numbers and positions.
Inputs: team_abbrev (required), fields, season.
Get the monthly schedule for an NHL team.
Inputs: team_abbrev (required), month, fields.
Get current-season stats for an NHL team (goals, shots, power play, penalty kill, etc.).
Inputs: team_abbrev (required), fields.
List all Dota 2 heroes with id, name, primary attribute and roles.
Inputs: fields.
Get hero stats / current meta: per-bracket pick and win counts for every hero.
Inputs: fields.
Get full detail for a Dota 2 match: players, heroes, K/D/A, items, gold/xp, objectives.
Inputs: match_id (required), fields.
Get a player's profile and aggregate stats by Steam32 account id (rank, MMR estimate, profile).
Inputs: account_id (required), fields.
Get a player's per-hero stats (games, win rate, last played).
Inputs: account_id (required), fields.
Get a player's recent matches (hero, result, K/D/A, duration). Use limit to cap the list.
Inputs: account_id (required), limit, fields.
Get a player's overall win/loss record.
Inputs: account_id (required), fields.
List Dota 2 leagues / tournaments with id, name and tier.
Inputs: fields.
Get recent professional Dota 2 matches (teams, league, duration, winner). Use a match_id with opendota_get_match for full detail.
Inputs: fields.
List professional Dota 2 teams with rating, wins/losses and last match time.
Inputs: fields.
Search for Dota 2 players by persona name. Returns account_id values for use with the player tools.
Inputs: query (required), fields.
Get detailed car telemetry: speed, RPM, gear, throttle, brake, DRS. WARNING: This endpoint returns massive amounts of data (multiple samples per second per car). Always use date_gte and date_lte filters to limit the time window, ideally to a few seconds or a single lap.
Inputs: session_key (required), fields, date_gte, date_lte, +3 more.
Get driver information for a session or across sessions. Returns driver names, numbers, team names, and more.
Inputs: fields, session_key, name_acronym, driver_number.
Get interval data showing the gap between drivers and the leader during a session.
Inputs: session_key (required), fields, driver_number.
Get lap timing data including sector times, lap duration, and more for a session.
Inputs: session_key (required), fields, lap_number, driver_number.
Get meeting (race weekend/event) information. A meeting groups multiple sessions at one circuit.
Inputs: year, fields, meeting_key, country_name.
Get pit stop data including pit lane time and duration for each stop.
Inputs: session_key (required), fields, driver_number, pit_duration_lte.
Get position/ranking data during a session. Shows how positions change over time.
Inputs: session_key (required), fields, position, driver_number.
Get race control messages: flags, safety cars, penalties, track status changes, and other official messages.
Inputs: session_key (required), flag, fields, category.
List Formula 1 sessions. A session is a single on-track period such as a practice, qualifying, sprint, or race.
Inputs: year, fields, session_key, country_name, +3 more.
Get stint data including tire compound, stint number, lap counts, and tire age for each driver.
Inputs: session_key (required), fields, compound, driver_number.
Get team radio message metadata for a session. Returns URLs to audio recordings of driver-engineer communications.
Inputs: session_key (required), fields, driver_number.
Get weather data for a session: air/track temperature, humidity, pressure, wind speed/direction, rainfall.
Inputs: session_key (required), fields, date_gte, date_lte.
List all available leagues and seasons in OpenLigaDB.
Inputs: fields.
Get the matches for the current matchday of a league.
Inputs: league_shortcut (required), fields.
Get the last completed match for a team. Use get_teams to find team IDs.
Inputs: team_id (required), fields.
Get detailed data for a specific match by its ID, including goals, results, and location.
Inputs: match_id (required), fields.
Get all matches for a league and season. Known league shortcuts: bl1 (1. Bundesliga), bl2 (2. Bundesliga), bl3 (3. Liga), dfb (DFB-Pokal), ucl (Champions League).
Inputs: season (required), league_shortcut (required), fields.
Get matches for a specific matchday in a league and season.
Inputs: season (required), matchday (required), league_shortcut (required), fields.
Get the next upcoming match for a team. Use get_teams to find team IDs.
Inputs: team_id (required), fields.
Get the league table / standings for a league and season.
Inputs: season (required), league_shortcut (required), fields.
Get the list of teams participating in a league for a given season.
Inputs: season (required), league_shortcut (required), fields.
Get the top goal scorers for a league and season.
Inputs: season (required), league_shortcut (required), fields.
Get all picks for a draft (round, pick number, roster, player_id, metadata). Get a draft_id from sleeper_get_league (draft_id) or the league's drafts.
Inputs: draft_id (required), fields.
Get details for a Sleeper league (settings, scoring, roster positions, status).
Inputs: league_id (required), fields.
Get the matchups for a league in a given week (roster_id, points, starters).
Inputs: week (required), league_id (required), fields.
Get all rosters in a league (owners, player_ids, wins/losses, points).
Inputs: league_id (required), fields.
Get all users (managers) in a league with display names and team names.
Inputs: league_id (required), fields.
Get the current NFL season, week, and season type (pre/regular/post/off) as tracked by Sleeper.
Inputs: fields.
Get the most-added or most-dropped NFL players over a lookback window, enriched with names/teams/positions. Doubles as a crude buzz signal.
Inputs: type (required), limit, fields, lookback_hours.
Get a Sleeper user (profile, user_id, display name) by username or numeric user id.
Inputs: username_or_id (required), fields.
List the NFL leagues a user belongs to for a given season. Use the user_id from sleeper_get_user.
Inputs: season (required), user_id (required), fields.
Search the Sleeper NFL player database by name (and optionally team/position). Returns slim records with injury status, depth-chart order, team and position. The full player set is cached for 24h.
Inputs: query (required), team, limit, fields, +1 more.
Get full details for a specific event by its TheSportsDB ID. Includes scores, venue, thumbnails, and video highlights.
Inputs: event_id (required), fields.
Get past event results for a specific round of a league season.
Inputs: round (required), season (required), league_id (required), fields.
Get sporting events on a specific date. Optionally filter by sport or league name.
Inputs: date (required), sport, fields, league.
Get the last 15 completed events for a team. Includes scores and results.
Inputs: team_id (required), fields.
List all leagues, optionally filtered by country and/or sport.
Inputs: sport, fields, country.
Get the next 15 upcoming events for a team.
Inputs: team_id (required), fields.
Get full details for a player by their TheSportsDB ID. Includes biography, position, stats, and images.
Inputs: player_id (required), fields.
List all available seasons for a league.
Inputs: league_id (required), fields.
List all available sports on TheSportsDB.
Inputs: fields.
Get league table / standings for a given league and season.
Inputs: season (required), league_id (required), fields.
Get full details for a team by its TheSportsDB ID. Includes description, stadium, badges, social links, and more.
Inputs: team_id (required), fields.
Search players by name, or list all players on a team. Provide either player_name or team_name (or both).
Inputs: fields, team_name, player_name.
Search teams by name. Returns matching teams with basic info, badges, and stadium details.
Inputs: team_name (required), fields.
List football leagues/competitions supported by SportSRC. Returns league ids you can pass to scores and tables tools.
Inputs: fields.
Get scores / recent results for a specific football league.
Inputs: league (required), fields.
Convenience: get the matches feed for a sport. Filter the returned data array client-side by status for live games.
Inputs: category (required), fields.
Get detailed match information including streams, venue, and lineups.
Inputs: category (required), match_id (required), fields.
List matches for a sport. Returns live, upcoming, and recently finished matches with team info.
Inputs: category (required), fields.
List sport categories supported by SportSRC. Returns ids you can pass to other tools.
Inputs: fields.
Get the standings table for a specific football league.
Inputs: league (required), fields.
Get AFL games with optional filters. Returns home/away teams, scores, completion status, venue, and time.
Inputs: team, year, round, fields, +1 more.
Get the projected AFL ladder for a given year and round, by prediction model. Each model gives its own projected wins / mean rank.
Inputs: year (required), round (required), fields, source.
List the prediction model sources contributing to Squiggle (Squiggle, MoS, FiveThirtyEight, etc.). Use the returned ids with tips and ladder tools.
Inputs: fields.
Get the actual AFL ladder/standings (wins, losses, draws, points, percentage) for a year and round.
Inputs: year (required), round, fields.
List all AFL teams in the Squiggle database (current and historic), with id, abbreviation, debut/retirement years, and logo path.
Inputs: fields.
Get game-level tips/predictions from one or all Squiggle prediction models. Each tip includes margin, confidence, and post-hoc correctness when known.
Inputs: game, year, round, fields, +1 more.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 165 tools
The tool set contains many overlapping capabilities across different providers: scoreboards, standings, team rosters, schedules, player searches, and event details appear under ESPN, SportsDB, NCAA, SportSRC, OpenLiga, footballdata, and league-specific tools. Formula 1 is especially ambiguous because F1 data is split across f1_*, openf1_*, and conceptually similar session/result tools. Provider prefixes help, but an agent must know which source to choose for a given sport and request.
Most tools follow a predictable provider_get_resource or provider_search_resource pattern, using snake_case throughout. There are minor deviations such as get versus list/search, sportsdb_get_league_list, euroleague_get_game_playbyplay versus play_by_play elsewhere, and mixed provider abbreviations. These are noticeable but do not make the naming chaotic.
165 tools is far beyond a reasonable surface for a single MCP server and exceeds the rubric's extreme-mismatch threshold. Even though the server aggregates many sports and data providers, the sheer number makes tool selection, maintenance, and agent reliability difficult.
Coverage is very broad: scores, schedules, standings, teams, rosters, players, stats, news, leagues, drafts, chess profiles, and Dota data are all represented. Some gaps remain, such as deeper cross-provider normalization and some sport-specific operations, but the surface is substantially complete for a multi-sport hub.
Live sports data: scores, play-by-play, box scores, odds and props. No key needed to start.
Sports data across 8 sports under one canonical schema — scores, stats, standings, Elo, odds
Sports odds, player props and source coverage for AI assistants. Connect with your own API key.
Live odds, cross-book +EV and graded player-prop results across 37 books. Hosted endpoint included.
