Sports MCP Server - install, status & alternatives [2026]

01 · Install Sports MCP Server

before you install - you'll need

Set MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL before connecting.

Claude Code

claude mcp add cyanheads-sports-mcp-server -- npx -y @cyanheads/sports-mcp-server

Claude Desktop / Cursor / VS Code - add to config

{
  "mcpServers": {
    "cyanheads-sports-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/sports-mcp-server"
      ]
    }
  }
}

Same JSON for Cursor. For VS Code, rename the top-level key from `mcpServers` to `servers`.

Using another client? Same JSON, different key

Claude Desktop · mcpServers

Cursor · mcpServers

VS Code · servers

Windsurf · mcpServers

Zed · context_servers

Cline · mcpServers

Roo Code · mcpServers

Continue · mcpServers

LibreChat · mcpServers

Gemini CLI · mcpServers

Codex CLI · mcp_servers

Full setup guides: every client.

02 · Evidence

Security posture

What to check before giving this server access to your agent - from the registry, GitHub, and our own probes. We don't score safety; we show what's verifiable.

runs as local process (stdio) - runs on your machine with your user's permissions

license Apache-2.0 - declared in the repository

npm package @cyanheads/sports-mcp-server - published under the repo owner's npm scope (@cyanheads)

registry namespace io.github.cyanheads is GitHub-verified and matches the repo owner

03 · What Sports MCP Server can do

Prose above is summarized from the project's README and registry record - no invented capabilities.

What you can build

With this server connected, an agent can resolve a team name or partial name to its canonical record and source IDs. Use before any team-scoped query, and resolve a player name to their canonical record via TheSportsDB. Disambiguation step before player-scoped queries.

The 7 tools it gives your agent

Extracted from the project's README - what sports-mcp-server lets an agent do.

sports_find_team: - Resolve a team name or partial name to its canonical record and source IDs. Use before any team-scoped query.
sports_find_player: - Resolve a player name to their canonical record via TheSportsDB. Disambiguation step before player-scoped queries.
sports_get_scores: - Live and final scores for a league on a given date, optionally scoped to a specific team.
sports_get_schedule: - Upcoming and past fixtures for a team or league over a date range.
sports_get_standings: - Current standings or league table for a league and season.
sports_get_team: - Team detail: active roster, last 5 results, next 3 fixtures, venue, and metadata.
sports_get_player: - Player detail: bio, current team, position, nationality, birth date, height/weight, and thumbnail.

Latest releases

v0.2.1 · 2026-08-31

Provider schedules and team metadata fixes · League-wide ESPN and MLB schedules honor paired date ranges and provider-calendar MLB games (#5) · TheSportsDB team aliases retain merged cross-source metadata (#6) · Docker…

v0.2.0 · 2026-08-30

Selector validation and player profile parity · Required player and team selectors reject whitespace-only values; pass non-whitespace names and player IDs (#7) · sports_get_player preserves full biographies in…

v0.1.4 · 2026-08-21

mcp-ts-core ^0.12.3 - SDK v2 serving, strict inputs · Framework adoption brings protocol revision 2026-07-28 alongside legacy clients; unknown tool input keys are rejected by name before handlers run.…

04 · Who maintains Sports MCP Server

sports-mcp-server is maintained by cyanheads. We track 125 MCP servers from cyanheads - 119 actively maintained, 1,816 combined GitHub stars, oldest repo from Dec 2024. Full record: all servers from cyanheads.

05 · Facts

repository: github.com/cyanheads/sports-mcp-server
category: other - ranked #329 of 945 actively-maintained other servers as of 2026-09-18.
release cadence: 3 releases in the last 90 days (latest 2026-08-31)
registry: io.github.cyanheads/sports-mcp-server (active, first published 2026-06-05 · 6 versions)
packages: npm:@cyanheads/sports-mcp-server · npm:@cyanheads/sports-mcp-server

06 · Sports MCP Server FAQ

Is Sports MCP Server still maintained?

Yes - as of 2026-09-18, its last commit was 2026-08-31 and it shipped 3 releases in the last 90 days. We re-verify nightly.

What can Sports MCP Server do?

With this server connected, an agent can resolve a team name or partial name to its canonical record and source IDs. Use before any team-scoped query, and resolve a player name to their canonical record via TheSportsDB. Disambiguation step before player-scoped queries.

How do I install Sports MCP Server?

Run `npx -y @cyanheads/sports-mcp-server`. The README documents 2 environment variables (MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL) to set first. Set MCP_TRANSPORT_TYPE, MCP_LOG_LEVEL before connecting. You can also paste the ready-made client config above.

Does Sports MCP Server run locally?

Yes - it's a stdio server: it runs on your machine (via npx) with your user's permissions. Your data stays local unless the server itself calls external APIs.

07 · Alternatives to Sports MCP Server

Alternatives to Sports MCP Server

Maintained other servers if Sports MCP Server isn't the fit.

More MCP servers to compare · Stackexchange MCP Server · Survey MCP Server · Treasury Fiscaldata MCP Server · Un Comtrade MCP Server · Worldbank MCP Server

More TypeScript MCP servers · Toolkit MCP Server · see all