sports-hub — Claude Code MCP server: what it does, how to install
Brings sports analytics, match scores, and odds from 42 external APIs into your coding agent. Ideal for creating live scoreboards and fantasy sports tools.
claude mcp add --env SPORTS_HUB_PROVIDERS=<SPORTS_HUB_PROVIDERS> --env API_SPORTS_KEY=<API_SPORTS_KEY> --env PANDASCORE_TOKEN=<PANDASCORE_TOKEN> --env THE_ODDS_API_KEY=<THE_ODDS_API_KEY> --transport stdio sports-hub -- npx -y mcp-sports-hubWhat sports-hub does
This server bundles 410 tools spanning 70+ sports disciplines, including esports and motorsport. It communicates with AI clients over stdio transport.
Running the package requires Node.js 18+. Nineteen data sources, including ESPN, NHL, and OpenF1, operate immediately without accounts or secret tokens. Setting the SPORTS_HUB_PROVIDERS=free environment variable restricts tool registration strictly to these keyless endpoints.
The remaining 23 providers need developer keys from free tier registrations. Missing credentials will not crash server startup; the system returns an error message only when you trigger an unauthenticated tool.
What it helps with
- Fetch live match scores and schedules across leagues
- Retrieve Formula 1 race history and telemetry metrics
- Query player stats and puzzles from Lichess or Chess.com
- Track competitive esports fixtures through PandaScore
Example prompts for the agent
- Show recent NHL game scores and team standings
- Get telemetry data for the latest Formula 1 Grand Prix
- Look up a player rating and recent games on Lichess
How to install sports-hub
Platform CLI
claude mcp add --env SPORTS_HUB_PROVIDERS=<SPORTS_HUB_PROVIDERS> --env API_SPORTS_KEY=<API_SPORTS_KEY> --env PANDASCORE_TOKEN=<PANDASCORE_TOKEN> --env THE_ODDS_API_KEY=<THE_ODDS_API_KEY> --transport stdio sports-hub -- npx -y mcp-sports-hubReplace <…> with your own values
Platform CLI
codex mcp add sports-hub --env SPORTS_HUB_PROVIDERS=<SPORTS_HUB_PROVIDERS> --env API_SPORTS_KEY=<API_SPORTS_KEY> --env PANDASCORE_TOKEN=<PANDASCORE_TOKEN> --env THE_ODDS_API_KEY=<THE_ODDS_API_KEY> -- npx -y mcp-sports-hubReplace <…> with your own values
Config file
{
"mcpServers": {
"sports-hub": {
"command": "npx",
"args": [
"-y",
"mcp-sports-hub"
],
"env": {
"SPORTS_HUB_PROVIDERS": "<SPORTS_HUB_PROVIDERS>",
"API_SPORTS_KEY": "<API_SPORTS_KEY>",
"PANDASCORE_TOKEN": "<PANDASCORE_TOKEN>",
"THE_ODDS_API_KEY": "<THE_ODDS_API_KEY>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"sports-hub": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"mcp-sports-hub"
],
"env": {
"SPORTS_HUB_PROVIDERS": "<SPORTS_HUB_PROVIDERS>",
"API_SPORTS_KEY": "<API_SPORTS_KEY>",
"PANDASCORE_TOKEN": "<PANDASCORE_TOKEN>",
"THE_ODDS_API_KEY": "<THE_ODDS_API_KEY>"
}
}
}
}Replace <…> with your own values
Platform CLI
gemini mcp add -e SPORTS_HUB_PROVIDERS=<SPORTS_HUB_PROVIDERS> -e API_SPORTS_KEY=<API_SPORTS_KEY> -e PANDASCORE_TOKEN=<PANDASCORE_TOKEN> -e THE_ODDS_API_KEY=<THE_ODDS_API_KEY> sports-hub npx -y mcp-sports-hubReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about sports-hub
How to install sports-hub in Claude Code?
Run `claude mcp add sports-hub -e API_SPORTS_KEY=<API_SPORTS_KEY> -e PANDASCORE_TOKEN=<PANDASCORE_TOKEN> -e THE_ODDS_API_KEY=<THE_ODDS_API_KEY> -- npx -y mcp-sports-hub in your terminal. You can pass credentials using the -e` flags.
What does sports-hub do?
It connects AI assistants to real-time scores, team stats, betting odds, and match archives across dozens of sports. Everything runs under a single MCP endpoint.
Can I run sports-hub without obtaining API keys?
Yes. 19 providers require no signup or keys, and you can filter the server to only load them by setting SPORTS_HUB_PROVIDERS=free.
