
Sports Mcp Server
Pulls live scores, schedules, standings, and player/team data from ESPN, MLB StatsAPI, and TheSportsDB without requiring API keys. Seven tools handle the full workflow: fuzzy-match team or player names, fetch today's games, pull upcoming fixtures, check league tables, and retrieve full roster or bio details. Routes each sport to its best source internally (MLB goes to StatsAPI, everything else to ESPN), then normalizes the output so you get consistent game, team, and player objects regardless of upstream API. Returns empty arrays with reason strings when there's no data instead of throwing errors, which keeps agents from breaking on off-season queries. Built on the author's mcp-ts-core framework with support for both stdio and streamable HTTP transports.
- GitHub stars
- 2
- tools
- 8
- transport
- STDIO, HTTP
- env vars
- 7
- last updated
- Oct 30, 2026
Tools
8 toolsPublic tool metadata for what this MCP can expose to an agent.
sports_find_teamResolve a team name or partial name to canonical records and source IDs across providers.
Resolve a team name or partial name to canonical records and source IDs across providers.
No parameter schema in public metadata yet.
sports_find_playerResolve a player name to canonical TheSportsDB records with ID, team, position, and bio fields.
Resolve a player name to canonical TheSportsDB records with ID, team, position, and bio fields.
No parameter schema in public metadata yet.
sports_get_scoresLive and final scores for a league on a given date, optionally filtered by team.
Live and final scores for a league on a given date, optionally filtered by team.
No parameter schema in public metadata yet.
sports_get_gameGame metadata, period scores, team totals, provider top performers, and paged scoring plays.
Game metadata, period scores, team totals, provider top performers, and paged scoring plays.
No parameter schema in public metadata yet.
sports_get_scheduleUpcoming and past fixtures for a team or league over a date range.
Upcoming and past fixtures for a team or league over a date range.
No parameter schema in public metadata yet.
sports_get_standingsCurrent standings or league table for a league and season.
Current standings or league table for a league and season.
No parameter schema in public metadata yet.
sports_get_teamTeam detail combining metadata, roster, recent results, and upcoming fixtures.
Team detail combining metadata, roster, recent results, and upcoming fixtures.
No parameter schema in public metadata yet.
sports_get_playerPlayer details from TheSportsDB — biography, team, position, and physical stats.
Player details from TheSportsDB — biography, team, position, and physical stats.
No parameter schema in public metadata yet.
Sponsors
Configuration
THESPORTSDB_API_KEYdefault: 123TheSportsDB API key. Defaults to '123', whose team/player searches have a one-record limit. A premium key enables broader searches.
MCP_LOG_LEVELdefault: infoSets the minimum log level for output (e.g., 'debug', 'info', 'warn').
MCP_TRANSPORT_TYPEdefault: httpSelects the HTTP transport.
MCP_HTTP_HOSTdefault: 127.0.0.1The hostname for the HTTP server.
MCP_HTTP_PORTdefault: 3010The port to run the HTTP server on.
MCP_HTTP_ENDPOINT_PATHdefault: /mcpThe endpoint path for the MCP server.
MCP_AUTH_MODEdefault: noneAuthentication mode to use: 'none', 'jwt', or 'oauth'.
Readme
@cyanheads/sports-mcp-server
Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, soccer, and more via MCP. STDIO or Streamable HTTP.
Details
- Repository
- github.com/cyanheads/sports-mcp-server
- Category
- Data & Analytics
- Package
@cyanheads/sports-mcp-server- Transport
- STDIO, HTTP
- Registry
- MCP registry, active
More from cyanheads
- Whois Mcp Server2
- Federal Reserve Mcp Server1
- Shift Mcp Server1
- Anime Mcp Server2
- Survey Mcp Server4
- Mcp Ts Template145
- nist-nvd-mcp-server
- open-meteo-mcp-server
- openfda-mcp-server
- wikipedia-mcp-server
- census-mcp-server
- crossref-mcp-server
- eur-lex-mcp-server
- faostat-mcp-server
- fema-mcp-server
- libofcongress-mcp-server
- openfoodfacts-mcp-server
- orcid-mcp-server
- reference-data-mcp-server
- usaspending-mcp-server
- arxiv-mcp-server
- exchange-rates-mcp-server
- openlibrary-mcp-server
- protein-mcp-server