playbooks

home / mcp / nhl mcp server

NHL MCP Server

Provides live NHL data and statistics with natural language query capabilities, including real-time scores, standings, schedules, and historical comparisons.

Installation
Add the following to your MCP client configuration file.

Configuration

View docs
{
  "mcpServers": {
    "argotdev-nhl-mcp-ts": {
      "command": "node",
      "args": [
        "/path/to/nhl-mcp-ts/dist/index.js"
      ]
    }
  }
}

You can run an MCP server that serves real-time NHL data and statistics through simple tool calls and natural language queries. It provides live game scores, standings, player stats, schedules, and historical comparisons, all accessible via a lightweight MCP client.

How to use

You interact with the NHL MCP Server by calling its available tools through an MCP client. Each tool returns a specific set of data you can reference in natural language queries. For example, you can ask for live game scores, current standings by division or conference, top player statistics, or playoff bracket information. Use the tool names below as the entry points for your questions, and tailor parameters like date, team, season, or category to refine the results.

How to install

Prerequisites: you need Node.js installed on your system. Ensure you have npm available to install dependencies and build the project.

Install dependencies and build the MCP server:

npm install
npm run build

Configure and run the MCP server

Configure your MCP client to connect to the NHL MCP Server using the stdio method shown here. This runs the server locally via Node and points to the compiled entry.

{
  "mcpServers": {
    "nhl": {
      "command": "node",
      "args": ["/path/to/nhl-mcp-ts/dist/index.js"]
    }
  }
}

Notes on data and capabilities

The NHL MCP Server exposes tools for live data, standings, player statistics, schedules, and historical comparisons. It relies on the official NHL data endpoints to deliver up-to-date scores, team and goalie statistics, head-to-head matches, streaks, and playoff brackets. Use the available tools to build queries that match your needs, such as filtering standings by division or conference, requesting top players in a season, or viewing the current playoff bracket.

Additional tips

If you plan to automate queries, combine multiple tools in your workflow. For example, fetch current live games with get_live_games, then drill into a specific game with get_game_details, and compare teams with compare_teams for deeper insights.

Available tools

get_live_games

Fetch live game scores and status for today or a specified date.

get_game_details

Retrieve detailed play-by-play information for a specific game by gameId.

get_standings

Get current NHL standings with optional filters for date, division, or conference.

get_team_stats

Get comprehensive statistics for a specific team and season.

get_player_stats

Get top player statistics across categories like points, goals, assists, and more.

get_goalie_stats

Fetch goalie metrics such as save percentage, GAA, wins, and shutouts.

get_schedule

Get game schedules for a date or team-specific query.

get_playoff_bracket

View the current playoff bracket and matchups.

compare_teams

Compare head-to-head statistics between two teams for a given season.

get_team_streak

Get a team's current winning or losing streak.

compare_seasons

Compare statistics across multiple seasons, optionally for a specific team.