cyanheads avatar

Sports Mcp Server

cyanheads/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 tools

Public 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: 123

TheSportsDB API key. Defaults to '123', whose team/player searches have a one-record limit. A premium key enables broader searches.

MCP_LOG_LEVELdefault: info

Sets the minimum log level for output (e.g., 'debug', 'info', 'warn').

MCP_TRANSPORT_TYPEdefault: http

Selects the HTTP transport.

MCP_HTTP_HOSTdefault: 127.0.0.1

The hostname for the HTTP server.

MCP_HTTP_PORTdefault: 3010

The port to run the HTTP server on.

MCP_HTTP_ENDPOINT_PATHdefault: /mcp

The endpoint path for the MCP server.

MCP_AUTH_MODEdefault: none

Authentication 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.

8 Tools

Version License Docker MCP SDK npm TypeScript Bun


View the full README on GitHub

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

Related Data & Analytics MCP servers

View all
1dsbissett avatarOffice Addin Mcpdsbissett/office-addin-mcpMCP server for Office add-ins via WebView2/CDP. Provides excel.*, page.*, and addin.* tools.2stars
2houtini-ai avatarFmphoutini-ai/fmp-mcpAccess financial data and market information via Financial Modeling Prep API2stars
3ofershap avatarSqliteofershap/mcp-server-sqliteSQLite MCP — query databases, inspect schemas, explain queries, export data.2stars
4pipeworx-io avatarCzso Czpipeworx-io/mcp-czso-czCzech Statistical Office (Český statistický úřad, ČSÚ) open-data MCP.2stars
5socialapishub avatarSocialAPIssocialapishub/mcp-serverFacebook & Instagram data for AI agents: pages, posts, groups, ads, Marketplace, profiles, reels.0stars
6kyurish avatarPatreon Mcp Serverkyurish/patreon-mcp-serverAccess your Patreon creator data - campaigns, patrons, tiers, and posts.2stars