home / mcp / nhl mcp server

NHL MCP Server

Provides real-time NHL data and statistics through an MCP server that client apps can query via natural language.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "argotdev-nhl-mcp-python": {
      "command": "python",
      "args": [
        "-m",
        "nhl_mcp.server"
      ]
    }
  }
}

You can run this NHL MCP Server to query live NHL data and statistics through natural language requests. It provides real-time game data, team and player stats, standings, playoff information, and comparison tools, all accessible via a simple MCP client interface.

How to use

You connect to the NHL MCP Server using an MCP client. Start the server locally and point your client at the running process. From there, you can ask for live scores, game details, standings, team or player statistics, goalie metrics, schedules, playoff brackets, and head‑to‑head or season comparisons. Use natural language prompts such as asking for today’s scores, Toronto Maple Leafs statistics, top goal scorers, or the current playoff bracket.

How to install

Prerequisites: You need Python 3.10 or higher installed on your system.

From source install steps to run locally.

1) Clone the project directory to your machine.

2) Install dependencies in editable mode so you can develop against the codebase.

3) Start using the MCP server from the command line or integrate it into your MCP client configuration.

Configuration and usage notes

Configure your MCP client to launch the NHL MCP Server. Use the example below as a starting point to ensure your client can start the server process correctly.

{
  "mcpServers": {
    "nhl": {
      "command": "python",
      "args": ["-m", "nhl_mcp.server"]
    }
  }
}

Additional setup and run commands

If you install from source, navigate to the project folder and install dependencies in editable mode so you can run and develop against the codebase.

To run the server directly from the source tree, use Python to invoke the module that hosts the MCP server.

If you install via a package distribution, you can start the server using the provided CLI entry point.

Troubleshooting and tips

Ensure you are using Python 3.10 or higher and have the required dependencies installed. If the server does not start, check that the module name and script path in your command match the runtime entry point used by your installation method.

Validate your MCP client configuration by confirming the command and arguments are correct and that the client can spawn the NHL MCP Server process.

Available tools

get_live_games

Retrieve live NHL game scores and statuses for today or a specific date.

get_game_details

Fetch detailed information about a specific game, including play-by-play data.

get_standings

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

get_team_stats

Get detailed statistics for a specific NHL team, optionally for a specific season.

get_player_stats

Query statistics for top NHL players across categories like points, goals, and assists.

get_goalie_stats

Retrieve goalie metrics such as save percentage and goals-against average for a season.

get_schedule

Get the NHL schedule for upcoming games, with optional date or team filtering.

get_playoff_bracket

Access current playoff bracket information for a given season.

compare_teams

Compare head-to-head statistics between two teams, optionally for a specific season.

get_team_streak

Return the current winning or losing streak for a team.

compare_seasons

Compare statistics across multiple NHL seasons, with optional team filtering.