NHL

You deploy this MCP server to access live NHL data from AI assistants. It exposes a large set of NHL API endpoints through the MCP protocol, letting you query standings, player stats, team rosters, game play-by-play, and more in real time. Use it to empower your AI workflows with current league information.

How to use

Connect your MCP client to the NHL API MCP server to begin querying data. You can ask for current standings, live scores, player and team statistics, rosters, schedules, game play-by-play, and playoff information. Use the tools exposed by the server to fetch exactly the data you need and integrate it into your AI assistant workflows.

Practical usage patterns you can adopt: - Retrieve current standings and team statistics for a quick league snapshot. - Pull a team roster and player bios to enrich contextual responses. - Get today’s scores or a specific game’s play-by-play for live analysis. - Query top skater and goalie stat leaders for season insights.

How to install

Prerequisites: you need Python installed on your system. You will also run commands to install dependencies and start the MCP server.

Step 1: Clone the project repository into your development environment.

Step 2: Install dependencies using Python’s package manager.

# Install Python dependencies
pip install -r requirements.txt

Step 3: Start the MCP server with Python.

python nhl_mcp_server.py

Step 4: (Optional) Configure your MCP client to connect to this server. Use the example configuration below as a starting point.

{
  "mcpServers": {
    "nhl_api": {
      "command": "python",
      "args": ["/path/to/nhl_mcp_server.py"]
    }
  }
}

Additional setup notes

If you plan to test or demonstrate capabilities, you can run the provided test and demo scripts to validate end-to-end behavior.

# Test the underlying NHL API client
python test_client.py

# Test the MCP server backend
python test_mcp_server.py

# Run a comprehensive demo
python demo.py

Available tools

get_player_info

Fetch detailed information about a player, including biographical data and career statistics.

get_player_game_log

Retrieve a player's game logs for current and historical seasons.

get_player_spotlight

Obtain featured players or spotlighted individuals.

get_standings_now

Get current NHL team standings.

get_club_stats_now

Fetch team statistics and performance metrics for a given team.

get_team_roster

Retrieve the roster for a specified team.

get_team_schedule

Get the schedule for a team, including upcoming games.

get_daily_scores_now

Fetch today’s scores and live scoreboards.

get_play_by_play

Obtain play-by-play data for a specific game.

get_game_boxscore

Retrieve boxscore and game statistics for a game.

get_current_skater_stats_leaders

Get current leaders in skater statistics.

get_current_goalie_stats_leaders

Get current leaders in goalie statistics.

get_schedule_now

Fetch the current league schedule.

get_tv_schedule_now

Retrieve the TV broadcast schedule.

get_team_codes

Provide a list of NHL team codes for reference.

get_season_format_help

Help text for season formatting and parameter usage.