NHL

An unofficial collection of NHL data tools, written in Go 🏒

Features

• API Client
• CLI
• Model Context Protocol (MCP) Server

NHL API Client

A client wrapper around the NHL web api, based on the reference spec defined here.

Supported Functionality

• Teams (Rosters)
• Players (Stats)
• Schedule (by date, by team)
• Standings

See roadmap.md for more details.

NHL CLI

See /examples for usage.

./nhl -player -name "Miro Heiskanen"

NHL MCP Server

Exposes NHL API data via the Model Context Protocol, allowing for easy integration with LLMs.

Installation

Build the nhl-mcp binary:

cd ./mcp && go build -o nhl-mcp

Add path to the nhl-mcp binary to your claude_desktop_config.json file:

"nhl": {
  "command": "/path/to/nhl-mcp"
}

git clone https://github.com/carsonjones/nhl-go.git
cd nhl-go

go build -o nhl && cd ./mcp && go build -o ../nhl-mcp && cd ../

npx @modelcontextprotocol/inspector ./nhl-mcp

go test -v './...'

HOCKEY!!!