Sports Hub

A unified MCP server that aggregates42 sports API providersinto a single service.410 toolscovering 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.

NBA scores, Premier League odds, Tennis H2H — all from a single MCP server.

Uses thestdio transportfrom theMCP SDK. Works with any LLM (Claude, GPT, Gemini, Llama, Mistral, etc.).

npm install -g mcp-sports-hub mcp-sports-hub

git clone https://github.com/lacausecrypto/mcp-sports-hub.git cd mcp-sports-hub npm install npm run build

This server is published on theofficial MCP Registryasio.github.lacausecrypto/sports-hub. MCP clients that support the registry can discover and install it automatically.

# Via flag npx mcp-sports-hub --http # Via env SPORTS_HUB_HTTP=1 SPORTS_HUB_PORT=3000 npx mcp-sports-hub

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 request

ADockerfileandsmithery.yamlare included for container hosting onSmithery. The hosted endpoint serves the keylessfreepreset, so clients connect with zero setup. The deploy setsSPORTS_HUB_DNS_REBINDING_PROTECTION=0because Smithery's proxy forwards a non-localhostHostheader.

# 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/

$env:API_SPORTS_KEY = "your-key" $env:PANDASCORE_TOKEN = "your-token"

set API_SPORTS_KEY=your-key set PANDASCORE_TOKEN=your-token

// 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 teams

SPORTS_HUB_MAX_RESULT_BYTES=40000 # default; serialized bytes per tool result

{ "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. Omitenventirely for free-only providers.

claude mcp add sports-hub node /absolute/path/to/mcp-sports-hub/dist/index.js

{ "mcpServers": { "sports-hub": { "command": "node", "args": ["/absolute/path/to/mcp-sports-hub/dist/index.js"], "env": { "PANDASCORE_TOKEN": "your-token" } } } }

By default, only thefree presetis loaded (19 providers, ~165 tools — no API keys needed). UseSPORTS_HUB_PROVIDERSto 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-hub

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 a404/410is remembered briefly (SPORTS_HUB_NEGATIVE_CACHE_TTL, default 30s) so a wrong ID can't be re-fetched in a loop.

429and5xxresponses are retried with exponential backoff, honouringRetry-Afterwhen the upstream sends one. Client errors (4xxother 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 attempt

"env": { "SPORTS_HUB_PROVIDERS": "us-major", "THE_ODDS_API_KEY": "your-key" }

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)

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 annotatedreadOnly/idempotentso 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_KEY

Each provider exportsregister(server). Keys are checked at call time, not startup.
- Fork the repository
- Createsrc/providers/my-api.tsexportingregister(server: McpServer)
- Prefix tool names:myapi_get_something
- Import + call insrc/index.ts
- npm run buildto verify
- Submit a PR

Access college football statistics from the College Football Data API.

Access Formula 1 data, including race results, driver standings, and circuit information.

Access extensive Formula 1 statistics and information using the FastF1 library and OpenF1 API.

Provides football (soccer) data using the API-Football service.

Access MLB game data, standings, and player statistics using the SportRadar API.

The hockey data API. Stats, odds, and everything between.

Provides club information and advanced player statistics for Euroleague and Eurocup basketball from the Euroleague API.

An MCP server for the NHL API, providing access to all documented endpoints.

Provides real-time football match information from the SoccerDataAPI using natural language.

Provides football (soccer) statistics and live match data using the API-Football service.