Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

io.github.cyanheads/sports-mcp-server

NPM · @CYANHEADS/SPORTS-MCP-SERVER · SCANNED AUG 7

Get live scores, schedules, standings, team and player data for NFL, NBA, MLB, NHL, and soccer.

+58 this week 64 Trust /100
Trust breakdown (6 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score →

Supply Chain Security86
  • No malware found by supply-chain analysis.Pass
  • Known CVEs were checked across the 125 of 132 dependencies we could resolve, so this covers what we could see, not the whole tree.Partial
  • No install/post-install scripts declared.Pass
  • Dependency health was assessed across the 125 of 132 dependencies we could resolve, so this covers what we could see, not the whole tree. View diagnostics → Partial
Provenance & Transparency45
Schema Quality & AI Usability72
  • AI-judged instruction clarity (excellent).Pass
  • Context-footprint check failed: tool/resource definitions use about 1189 tokens (~169/item across 7 items; 7 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management0
  • Stability not yet verified: not enough scan history yet (needs a 30-day window).Unverified
Tool Coverage100
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 100% of tool parameters carry a description.Pass
  • Structured output schemas are declared (100% of tools); any adoption earns full credit.Pass
Capabilities100
  • Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass

Unverified: 1 category

A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

Install

Add this component to your MCP client. Where a client-specific snippet is available, pick your client below and copy it straight into your config; otherwise use the connection detail shown.

npm · @cyanheads/sports-mcp-server

# add to Claude Code
claude mcp add cyanheads-sports-mcp-server -- npx -y @cyanheads/sports-mcp-server
# add to Codex CLI
codex mcp add cyanheads-sports-mcp-server -- npx -y @cyanheads/sports-mcp-server
// opencode.json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "cyanheads-sports-mcp-server": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "@cyanheads/sports-mcp-server"
      ],
      "enabled": true
    }
  }
}
# add to OpenClaw
openclaw mcp add cyanheads-sports-mcp-server --command npx --arg -y --arg @cyanheads/sports-mcp-server
# ~/.hermes/config.yaml
mcp_servers:
  cyanheads-sports-mcp-server:
    command: "npx"
    args: ["-y", "@cyanheads/sports-mcp-server"]
// mcp.json
{
  "mcpServers": {
    "cyanheads-sports-mcp-server": {
      "command": "npx",
      "args": [
        "-y",
        "@cyanheads/sports-mcp-server"
      ]
    }
  }
}
Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 6 Aug 26 +29
    • Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window). security
    • MCP protocol: unverified → pass functional
    • Tool coverage: unverified → 100 functional
    • First check of Tool coverage: 100 functional
    • First check of Schema quality: fail functional
    • First check of Tool coverage: 100 functional
    • First check of Schema quality: excellent functional
    • First check of Schema quality: fail functional
  • 5 Aug 26 0
    • Security disclosure: unverified → fail functional
  • 4 Aug 26 0
    • Security disclosure: fail → unverified functional
  • 2 Aug 26 +30
    • Provenance: unverified → fail security
    • Install scripts: unverified → pass security
    • Known CVEs: unverified → partial security
    • Malware scan: unverified → pass security
    • Dependency health: unverified → partial functional
    • License: unverified → pass functional
    • Maintenance: unverified → pass functional
    • Licence: Apache-2.0 functional
  • 1 Aug 26 −1
    • We updated how we score, so this day's move reflects our rubric, not a change to the server See what changed → functional
  • 31 Jul 26 −18
    • Malware scan: pass → unverified security
  • 30 Jul 26 0
    • Schema quality: Schema quality not yet verified: our sandbox run of this package did not complete, so we have no schema to assess. functional
    • Tool coverage: Tool coverage not yet verified: our sandbox run of this package did not complete, so we have no tool definitions to assess. functional
  • 28 Jul 26 0
    • Tool coverage: Tool coverage not yet verified: we do not have a sandbox capture of the tool definitions this version of the package serves yet. functional
    • Schema quality: Schema quality not yet verified: we do not have a sandbox capture of the MCP schema this version of the package serves yet. functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 7 Aug 2026 · Analysed npm/@cyanheads/[email protected]

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem npm
Dependencies 125 packages
Packages resolved 125
Deprecated 125
Stale 39
Tree resolution Partial

The dependency tree was only partially resolved, so these counts may be incomplete.

MCP tools · 7 exposed · ~1,002 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability.

Tool Tokens
sports_find_player ~141

Resolve a player name to their canonical record via TheSportsDB. Returns player ID, full name, current team, position, nationality, birth date, and thumbnail URL. Use this before sports_get_player to get a valid player_id.

NameTypeReqDescription
querystringyesPlayer name or partial name to search, e.g. "Shohei Ohtani", "LeBron", "Messi".
sportstringAdvisory sport hint for disambiguation, e.g. "Baseball", "Soccer", "Basketball". TheSportsDB does not support server-side sport filtering, so all players matching the query are returned regardless of…
NameTypeReqDescription
playersarrayyesPlayers matching the search query.
querystringyesThe search query used.
totalFoundnumberyesTotal number of players found.

No examples provided.

sports_find_team ~126

Resolve a team name or partial name to its canonical record and source IDs across providers. Returns full name, league, logo URL, venue, and ESPN/MLB/TheSportsDB IDs. Use this before any team-scoped query to confirm the correct team name. Optionally scope to a specific league for faster, more accurate results.

NameTypeReqDescription
leaguestringNarrow search to a specific league. Optional but recommended for faster results.
querystringyesTeam name or partial name to search for, e.g. "Mariners", "Man United", "Seattle Seahawks".
NameTypeReqDescription
querystringyesThe search query used.
teamsarrayyesMatching teams found across sources.
totalFoundnumberyesTotal number of matching records.

No examples provided.

sports_get_player ~108

Full player detail from TheSportsDB: bio, current team, position, nationality, birth date, height/weight, career description, and media thumbnail. Requires a TheSportsDB player ID — use sports_find_player to resolve a player name to a valid player_id first.

NameTypeReqDescription
player_idstringyesTheSportsDB player ID. Accepts tsdb: prefixed (e.g. tsdb:34185573) or raw numeric string (e.g. 34185573).
NameTypeReqDescription
playerobjectyesFull player record.

No examples provided.

sports_get_schedule ~181

Upcoming and past fixtures for a team or full league over a date range. Returns opponent, home/away flag, UTC date/time, venue, and result if final. Use sports_find_team first to resolve an ambiguous team name to the canonical form before passing it as team_name.

NameTypeReqDescription
date_fromstringStart of date range in YYYY-MM-DD format. Inclusive.
date_tostringEnd of date range in YYYY-MM-DD format. Inclusive.
leaguestringyesLeague identifier. Supported: nfl, nba, mlb, nhl, epl, mls, laliga, bundesliga, seriea, ligue1, ucl, ncaaf, ncaab.
team_namestringTeam name or partial name to filter schedule. Fuzzy match. Omit for league-wide schedule.
NameTypeReqDescription
dateFromstringStart date filter applied, if any.
dateTostringEnd date filter applied, if any.
gamesarrayyesGames in the requested date range.
leaguestringyesThe league queried.
teamFilterstringTeam name filter applied, if any.
totalReturnednumberyesTotal number of games returned.

No examples provided.

sports_get_scores ~175

Live and final scores for a league on a given date, optionally scoped to a specific team. Returns each game with home/away teams, current score, status (scheduled/in-progress/final), period/clock, and UTC start time. Omit date for today's games. Use sports_find_team first to resolve a fuzzy team name before filtering by team_name.

NameTypeReqDescription
datestringDate in YYYY-MM-DD format. Omit for today's games.
leaguestringyesLeague identifier. Supported: nfl, nba, mlb, nhl, epl, mls, laliga, bundesliga, seriea, ligue1, ucl, ncaaf, ncaab.
team_namestringFilter results to games involving this team. Fuzzy match on team name or abbreviation.
NameTypeReqDescription
datestringyesThe effective date queried (YYYY-MM-DD).
gamesarrayyesList of games for the requested date and league.
leaguestringyesThe league queried.
reasonstringHuman-readable note when no games are found.

No examples provided.

sports_get_standings ~139

Current standings or league table for a league. Returns team rank, W/L record (or points for soccer/NHL), division or conference, streak, and games behind. Omit season for the current year. NHL standings use points; soccer uses points-based league tables.

NameTypeReqDescription
leaguestringyesLeague identifier. Supported: nfl, nba, mlb, nhl, epl, mls, laliga, bundesliga, seriea, ligue1, ucl, ncaaf, ncaab.
seasonstringSeason year, e.g. "2025". Omit for the current season.
NameTypeReqDescription
leaguestringyesThe league queried.
noticestringInformational note, e.g. "Season not currently active" when standings are unavailable during the off-season.
seasonyesThe season queried, or null if current.
sourcestringyesPrimary data source used.
standingsarrayyesStandings entries, ordered as returned by the source.

No examples provided.

sports_get_team ~132

Team detail: active roster, last 5 results, next 3 upcoming fixtures, venue, and team metadata. Combines team detail, roster, and schedule data. Use sports_find_team first to confirm the correct team name.

NameTypeReqDescription
leaguestringyesLeague identifier. Supported: nfl, nba, mlb, nhl, epl, mls, laliga, bundesliga, seriea, ligue1, ucl, ncaaf, ncaab.
team_namestringyesTeam name, abbreviation, or city. Fuzzy matched against ESPN/MLB team list.
NameTypeReqDescription
recentResultsarrayyesLast up to 5 completed games for this team.
rosterarrayyesActive roster.
teamobjectyesTeam metadata.
upcomingFixturesarrayyesNext up to 3 upcoming scheduled games for this team.

No examples provided.