Nhl API MCP

nhl-api-mcp

MCP server for NHL statistics. Lets AI assistants answer hockey questions using real-time data from the NHL Web API and Stats API.

Powered by nhl-api-client.

Features

• 26 tools covering standings, scores, players, teams, games, schedule,

draft, playoffs, NHL Edge analytics, Stats API, and more

• Human-readable formatted responses optimized for AI consumption
• Real-time data from both NHL APIs

Quick Start

Prerequisites

• Node.js 18+

Build from Source

git clone https://github.com/jakubsvobodacz/nhl-api-mcp.git
cd nhl-api-mcp
npm install
npm run build

Setup by Tool

Claude Code

Add to ~/.claude.json:

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

Restart Claude Code. Verify with /mcp — you should see 26 tools listed.

Cursor

Settings → MCP → Add Server:

• Name: nhl
• Transport: stdio
• Command: node /absolute/path/to/nhl-api-mcp/dist/index.js

VS Code (Continue)

Add to .continue/config.json:

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

VS Code (Cline)

Open Cline MCP settings and add:

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

Windsurf

Settings → MCP → Add Server with stdio transport pointing to dist/index.js.

Claude Desktop

Add to claude_desktop_config.json:

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

Example Questions

• "What are the current NHL standings?"
• "Who won last night's games?"
• "Show me Connor McDavid's stats this season" (player ID: 8478402)
• "What's the Maple Leafs' roster?"
• "When is the next Rangers game?"
• "Who leads the league in goals?"
• "Show me the playoff bracket"
• "What are the fastest skaters in the NHL?"
• "Get me the boxscore for game 2024020567"
• "Who are the spotlight players right now?"
• "Show me the Oilers' prospects"
• "What games are on TV tonight?"
• "Show me all skaters with 30+ goals this season"
• "Who are the top goalie leaders?"
• "Explain what GAA means"

Available Tools

Common Parameters

• Team abbreviations: TOR, EDM, NYR, BOS, COL, FLA, VGK, DAL, CAR, WPG, etc.
• Season format: 20242025 (8-digit, start year + end year)
• Game ID format: SSSSTTNNNN (e.g., 2024020567 — season 2024, type 02=regular, game 0567)
• Game type: 2 = regular season, 3 = playoffs
• Edge reports: real-time, distance, speed, speed-bursts, zone-time, shot-speed, shot-location, time-between-shots, possession-time, penalty-kill, power-play, faceoffs, overview
• Skater stat reports: summary, bios, faceoffpercentages, goalsforagainst, realtime, penalties, penaltykill, powerplay, timeonice
• Goalie stat reports: summary, advanced, bios, daysrest, savesByStrength, startedVsRelieved

Development

npm install       # Install dependencies
npm run build     # Build with tsup (ESM + shebang)
npm run dev       # Run with tsx (hot reload)
npm run typecheck # TypeScript type checking
npm run test      # Run tests with vitest

License

MIT