Skip to content
PuckAPIPublic

About

NHL data MCP server for Claude and AI agents. Stats, odds, schedules, line movement.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Repository files navigation

PuckAPI MCP Server

The hockey data API. Stats, odds, and everything between.
REST API and MCP server. Free to start.


License: MIT Tools Seasons Skills Smithery

Quick Start · Tools · Data · Pricing · REST API


You:    "What were last night's NHL scores?"
Claude: [calls get_games → returns scores, periods, shots, goals]

You:    "Show me the line movement on the Sabres game"
Claude: [calls get_line_movement → opening line, current line, timestamps, book-by-book]

You:    "Compare McDavid and MacKinnon this season"
Claude: [calls get_player_stats x2 → side-by-side goals, assists, points, TOI, shooting %]

Quick Start

Claude Desktop -- add to claude_desktop_config.json:

{
  "mcpServers": {
    "puckapi": {
      "url": "https://mcp.puckapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}

Claude Code -- one command:

claude mcp add --transport http puckapi \
  "https://mcp.puckapi.com/mcp?key=YOUR_API_KEY"

Other MCP clients -- any client supporting Streamable HTTP:

Setting Value
URL https://mcp.puckapi.com/mcp?key=YOUR_API_KEY
Transport Streamable HTTP

Also accepts Authorization: Bearer or x-api-key headers. Connecting and listing tools works without a key; calling a tool needs one.

Get your free key at puckapi.com -- 500 credits, no credit card.


Available Tools

Games -- 4 tools
Tool Description
get_games Game results with scores, periods, shots, and goals
get_schedule Upcoming and past game schedules
get_game_detail Full box score for a specific game
get_head_to_head Historical matchup data between two teams
Teams -- 3 tools
Tool Description
get_standings Current or historical standings by season
get_team_stats Team-level stats (goals, shots, PP%, PK%, etc.)
list_teams All NHL teams with abbreviations and metadata
Players -- 5 tools
Tool Description
search_players Find players by name
get_player_stats Skater stats (goals, assists, points, TOI, etc.)
get_skater_season_stats Season stats leaderboard -- goals, assists, points, TOI, shooting %, filterable by team and sortable by 5 metrics
get_goalie_stats Goalie stats (SV%, GAA, wins, shutouts, etc.)
get_player_game_log Game-by-game lines for a skater or goalie in a season: goals, assists, shots, PIM, saves, SV%
Odds -- 2 tools
Tool Description
get_odds Opening and closing moneyline, puck line and total by sportsbook, every game from 2019-20
get_line_movement Time-series odds grouped by bookmaker
Play-by-play -- 2 tools
Tool Description
get_plays Play-by-play events with rink coordinates, strength state and the players involved
get_shot_map Every shot attempt with rink coordinates, shot type, shooter and goalie

Data Coverage

Category Details
Games 23,000+ across 16 seasons
Play-by-play Every event since 2010-11 with rink coordinates (6.8M+ events)
Odds Every game from 2019-20: about 12-14 books a game for 2020-21 to 2023-24, 60+ in 2025-26, and 8 books including Pinnacle captured hourly from October 2026
Line movement Hourly snapshots from September 2026
Players 4,800+ skaters and goalies
Computed Expected goals, GSAX, Corsi and Fenwick
PWHL Games, standings, play-by-play and shot locations; pass league: "pwhl" (details)
Updates Games daily; odds captured hourly

Live coverage by season: historical odds · play-by-play · shot data


Pricing

Plan Credits/mo Price
Free 500 $0
Starter 10,000 $19/mo
Pro 30,000 $49/mo
Scale 125,000 $149/mo

Tools cost 1 to 25 credits a call (per-tool costs). Wallet top-ups from $5 never expire.


REST API

PuckAPI also offers a standard REST API:

curl -X POST https://mcp.puckapi.com/v1/get_standings \
  -H "x-api-key: YOUR_API_KEY"

Full documentation at puckapi.com/docs.


Related

PuckAPI Skills 28 free Claude Code skills for hockey analytics, betting models, and research
puckapi.com Sign up, dashboard, API docs

puckapi.com · API Docs · Skills

MIT License

About

NHL data MCP server for Claude and AI agents. Stats, odds, schedules, line movement.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages