nhl-stats-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Live NHL data: scores, standings, schedules, rosters, player stats and league leaders. Times are US Eastern. Data comes from the NHL's public web API.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_scoresA | Get NHL games for a date: live scores with period and clock, final scores, or start times for upcoming games. Set include_goals to list every goal with scorer, assists and strength. |
| get_standingsA | Get NHL standings (W-L-OTL, points, point %, goal differential, last 10, streak), grouped league-wide, by conference or by division. |
| search_playersA | Find NHL players (current and retired) by name. Returns player ids, positions and teams. Use this when a name is ambiguous before calling get_player_stats. |
| get_player_statsA | Get a player's profile, current-season and career regular-season stats, and their last 5 games. Accepts a player name (e.g. "McDavid") or a numeric NHL player id. Works for skaters and goalies. |
| get_team_scheduleA | Get a team's upcoming games (with start times) or recent results (W/L and score) for the current season. |
| get_team_rosterA | Get a team's current roster: forwards, defensemen and goalies with numbers, positions and player ids. |
| get_league_leadersB | Get the current season's NHL leaders in a stat category. Skater categories: points (Points), goals (Goals), assists (Assists), plusMinus (Plus/minus), goalsPp (Power-play goals), goalsSh (Shorthanded goals), penaltyMins (Penalty minutes), toi (Time on ice per game), faceoffLeaders (Faceoff win %). Goalie categories: wins (Wins), savePctg (Save %), goalsAgainstAverage (Goals-against average), shutouts (Shutouts). |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 7 tools
Each tool targets a distinct resource: rosters, daily scores, standings, player search, player stats, team schedule and league leaders. The only mild overlap is between get_scores (league-wide by date, including finals) and get_team_schedule (a single team's recent results), but the descriptions make the date-vs-team distinction workable.
All names use snake_case verb_noun form (get_team_roster, get_scores, search_players) with no case or style mixing. The single 'search_' prefix is semantically justified and does not break the pattern.
Seven tools is well within the ideal 3-15 range and each covers a distinct facet of NHL data (teams, players, games, standings, leaders). No tool feels redundant or like padding.
The surface covers the core lifecycle: discover a player (search_players), drill into stats (get_player_stats), browse teams, rosters, schedules, scores, standings and leaders. Minor gaps exist for team-level stats, head-to-head comparisons and historical season queries, but agents can work around most of these.