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.
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →
Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →
Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →
On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
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
seasonstringSeason ID (e.g. 20252026). Defaults to current season.
divisionstringFilter by division (e.g. Atlantic, Metropolitan, Central, Pacific)
conferencestringFilter by conferenceone of
Eastern · Westernget_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
teamstringTeam abbreviation (e.g. BUF, TOR, NYR)
seasonstringSeason ID (e.g. 20252026). Defaults to current season.
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
divisionstringFilter by division
conferencestringFilter by conferenceone of
Eastern · Westernget_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
teamstringTeam abbreviation to filter (home or away)
limitintegerMax results (default 100)
seasonstringSeason ID (e.g. 20252026)
date_tostringEnd date (YYYY-MM-DD)
date_fromstringStart date (YYYY-MM-DD)
game_typestringFilter by game typeone of
regular · playoff · preseasongame_statestringFilter by game stateone of
FUT · LIVE · FINAL · OFFget_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)
team1stringFirst team abbreviation (e.g. BUF)
team2stringSecond team abbreviation (e.g. TOR)
seasonstringSeason ID to filter. Omit for all-time.
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
teamstringFilter by team abbreviation
limitintegerMax results (default 10)
querystringPlayer name to search for (partial match supported)
activebooleanFilter by active status (default: true). Set false to search active plus retired/historical players.
positionstringFilter by positionone of
G · D · C · LW · RWget_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
teamstringFilter by team abbreviation
limitintegerMax results (default 20)
seasonstringSeason ID. Defaults to current.
sort_bystringSort metric (default save_pct)one of
save_pct · gaa · gsax · winsmin_gamesintegerMinimum games played (default 10)
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
game_idstringNHL game ID (e.g. 2025020887)
bookmakerstringFilter by bookmaker key (e.g. draftkings, fanduel, betmgm). Lowercase.
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
game_idstringNHL game ID
bookmakerstringFilter by specific bookmaker key (lowercase)
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 puckapi \
--transport streamable-http \
"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 for REST API usage.
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 | Pre-game odds from 15+ sportsbooks (ML, spread, total) |
get_line_movement | Track how lines move from open to close |
Data Coverage
| Category | Details |
|---|---|
| Seasons | 2008-09 through current (16+) |
| Games | 22,000+ with full box scores |
| Odds | Pre-game ML, spread, totals from 15+ books |
| Line movement | Opening to closing line tracking |
| Players | 3,000+ skaters and goalies |
| Updates | Scores and odds refresh throughout the day |
Pricing
| Plan | Credits/mo | Price |
|---|---|---|
| Free | 500 | $0 |
| Starter | 10,000 | $19/mo |
| Pro | 30,000 | $49/mo |
| Scale | 125,000 | $149/mo |
Each tool call costs 1 credit. Top up anytime with wallet deposits.
REST API
PuckAPI also offers a standard REST API:
curl -H "x-api-key: YOUR_API_KEY" \
https://mcp.puckapi.com/v1/get_standings
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
Keep your Mac awake while Claude Code and 40+ AI agents run. Sleeps when they're idle.
One time payment $9 →Integrate web data into your AI product. One API to scrape website & brand data.
Get API Key Now →Agent, run crypto. Access onchain data & trade routes via 1inch.
Install now →On Capafy, your Skill runs online 24/7 as an agent product, and you get paid every time someone uses it.
Start earning →
