Summary
Connects Claude to 16+ seasons of NHL data through 13 tools covering games, stats, odds, and line movement. You get box scores, player comparisons (goals, assists, TOI, shooting percentage), standings, head-to-head records, and pre-game odds from 15+ sportsbooks with opening-to-closing line tracking. Built on PuckAPI's REST API with the same endpoints exposed as MCP tools. Free tier includes 500 credits, each tool call costs one credit. Useful for sports analysis, betting research, or building hockey-aware agents that need current scores, historical matchups, or real-time odds without scraping or managing multiple data sources.
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →
belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →
Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →
Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →
Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →Tools
Public tool metadata for what this MCP can expose to an agent.
12 tools
get_standingsGet current NHL standings with team records, points, and advanced stats. Optionally filter by conference or division.3 params
Get current NHL standings with team records, points, and advanced stats. Optionally filter by conference or division.
Parameters* required
conferencestringFilter by conferenceone of
Eastern · WesterndivisionstringFilter by division (e.g. Atlantic, Metropolitan, Central, Pacific)
seasonstringSeason ID (e.g. 20252026). Defaults to current season.
get_team_statsGet detailed stats for a specific NHL team including record, advanced metrics, and rankings.2 params
Get detailed stats for a specific NHL team including record, advanced metrics, and rankings.
Parameters* required
seasonstringSeason ID (e.g. 20252026). Defaults to current season.
teamstringTeam abbreviation (e.g. BUF, TOR, NYR)
list_teamsList all 32 active NHL teams with basic info. Excludes historical/relocated franchises (ATL, ARI). Optionally filter by conference or division.2 params
List all 32 active NHL teams with basic info. Excludes historical/relocated franchises (ATL, ARI). Optionally filter by conference or division.
Parameters* required
conferencestringFilter by conferenceone of
Eastern · WesterndivisionstringFilter by division
get_gamesGet NHL games filtered by date range, team, season, or game state. Returns scores, teams, and game metadata.7 params
Get NHL games filtered by date range, team, season, or game state. Returns scores, teams, and game metadata.
Parameters* required
date_fromstringStart date (YYYY-MM-DD)
date_tostringEnd date (YYYY-MM-DD)
game_statestringFilter by game stateone of
FUT · LIVE · FINAL · OFFgame_typestringFilter by game typeone of
regular · playoff · preseasonlimitintegerMax results (default 100)
seasonstringSeason ID (e.g. 20252026)
teamstringTeam abbreviation to filter (home or away)
get_scheduleGet upcoming NHL games that haven't been played yet.2 params
Get upcoming NHL games that haven't been played yet.
Parameters* required
daysintegerNumber of days ahead to look (default 7)
teamstringTeam abbreviation to filter
get_game_detailGet full details for a specific game including team info, odds (available for 2020-2026 seasons), and goalie starts.1 params
Get full details for a specific game including team info, odds (available for 2020-2026 seasons), and goalie starts.
Parameters* required
game_idstringNHL game ID (e.g. 2025020887)
get_head_to_headGet matchup history between two teams. Shows recent games and series record.4 params
Get matchup history between two teams. Shows recent games and series record.
Parameters* required
limitintegerMax games to return (default 20)
seasonstringSeason ID to filter. Omit for all-time.
team1stringFirst team abbreviation (e.g. BUF)
team2stringSecond team abbreviation (e.g. TOR)
search_playersSearch NHL players by name across 16 seasons (3,000+ players). Returns active players by default; set active=false to include active plus retired/historical players.5 params
Search NHL players by name across 16 seasons (3,000+ players). Returns active players by default; set active=false to include active plus retired/historical players.
Parameters* required
activebooleanFilter by active status (default: true). Set false to search active plus retired/historical players.
limitintegerMax results (default 10)
positionstringFilter by positionone of
G · D · C · LW · RWquerystringPlayer name to search for (partial match supported)
teamstringFilter by team abbreviation
get_player_statsGet stats for a specific player by their NHL player ID.1 params
Get stats for a specific player by their NHL player ID.
Parameters* required
player_idintegerNHL player ID
get_goalie_statsGet goalie performance stats leaderboard. Data available when goalie_stats table is populated. Optionally filter by team.5 params
Get goalie performance stats leaderboard. Data available when goalie_stats table is populated. Optionally filter by team.
Parameters* required
limitintegerMax results (default 20)
min_gamesintegerMinimum games played (default 10)
seasonstringSeason ID. Defaults to current.
sort_bystringSort metric (default save_pct)one of
save_pct · gaa · gsax · winsteamstringFilter by team abbreviation
get_oddsGet betting odds for a specific game. Returns moneyline, spread, and totals from available bookmakers. Odds data covers 2020-2026 seasons; earlier games return empty odds.3 params
Get betting odds for a specific game. Returns moneyline, spread, and totals from available bookmakers. Odds data covers 2020-2026 seasons; earlier games return empty odds.
Parameters* required
bookmakerstringFilter by bookmaker key (e.g. draftkings, fanduel, betmgm). Lowercase.
game_idstringNHL game ID (e.g. 2025020887)
snapshot_typestringFilter by snapshot type: opening (game-day morning lines) or closing (final pre-game lines). Default returns both.one of
opening · closingget_line_movementGet odds snapshots for a game grouped by bookmaker, showing opening vs closing lines. Odds data covers 2020-2026 seasons.2 params
Get odds snapshots for a game grouped by bookmaker, showing opening vs closing lines. Odds data covers 2020-2026 seasons.
Parameters* required
bookmakerstringFilter by specific bookmaker key (lowercase)
game_idstringNHL game ID
The hockey data API. Stats, odds, and everything between.
REST API and MCP server. Free to start.
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 -- 4 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.) |
Odds -- 2 tools
| Tool | Description |
|---|---|
get_odds | Opening and closing moneyline, puck line and total by sportsbook, back to 2020-21 |
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 | Opening and closing lines back to 2020-21; 60+ books including Pinnacle from 2025-26 |
| Line movement | Hourly snapshots from September 2026 |
| Players | 4,800+ skaters and goalies |
| Computed | Expected goals, GSAX, Corsi and Fenwick |
| 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
Featured
Fastest browser for AI agents to run web automation tasks, always free.
Download Free life-time →belt cli automatically finds the best tools and skills for your agent. image, video, music, tts...
one prompt install →Free an open-source skills that make AI coding agents easier to understand, verify, and control.
Download for free →Connect your Claude agent to live crypto prices and trading routes via 1inch
Get the MCP →Notes, actions and memory. Without a meeting bot. First month 100% off.
Download for free →
