
PuckAPI
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.
- tools
- 24
- auth
- Secret needed
- transport
- HTTP
- last updated
- Oct 16, 2026
Install
From registry metadata$ npx add-mcp https://mcp.puckapi.com/mcp --name puckapi --header 'x-api-key: ${X_API_KEY}'Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.
Review the command, arguments and environment values before installing. MCP servers run with your local permissions.
Other ways
Claude Code
$ claude mcp add --transport http puckapi https://mcp.puckapi.com/mcp --header 'x-api-key: YOUR_X_API_KEY'Run in your terminal. Add --scope user to make it available in every project.
Tools
Verified live · 24 toolsVerified live against the running server on Nov 6, 2026.
get_standingsUse when checking where teams rank in their division or conference. Returns points, wins, losses, OT losses, point%, goal differential, goals for/against per game, and 5v5 possession: Corsi%, Fenwick% and expected goals for and against. The possession columns are 5v5 only, so...4 params
Use when checking where teams rank in their division or conference. Returns points, wins, losses, OT losses, point%, goal differential, goals for/against per game, and 5v5 possession: Corsi%, Fenwick% and expected goals for and against. The possession columns are 5v5 only, so...
conferencestringEastern · Westerndivisionstringleaguestringnhl · pwhl · ohl · whl · qmjhl · echlseasonstringget_team_statsUse when you need full details for one team: record, goals for and against, league rank, and 5v5 possession (Corsi%, Fenwick%, expected goals for and against). Possession is 5v5 only. Requires a team abbreviation (use list_teams if unsure). Costs 5 credits.3 params
Use when you need full details for one team: record, goals for and against, league rank, and 5v5 possession (Corsi%, Fenwick%, expected goals for and against). Possession is 5v5 only. Requires a team abbreviation (use list_teams if unsure). Costs 5 credits.
leaguestringnhl · pwhl · ohl · whl · qmjhl · echlseasonstringteam*stringlist_teamsUse when you need team abbreviations, or to see all 32 active NHL teams with city, conference, division, and arena. Excludes historical franchises (ATL, ARI). Cheapest tool at 1 credit.3 params
Use when you need team abbreviations, or to see all 32 active NHL teams with city, conference, division, and arena. Excludes historical franchises (ATL, ARI). Cheapest tool at 1 credit.
conferencestringEastern · Westerndivisionstringleaguestringnhl · pwhl · ohl · whl · qmjhl · echlget_gamesUse when querying past or future games with filters. Returns scores, teams, venue, and game metadata. For upcoming-only games, prefer get_schedule (2 cr) instead. Costs 5 credits.8 params
Use when querying past or future games with filters. Returns scores, teams, venue, and game metadata. For upcoming-only games, prefer get_schedule (2 cr) instead. Costs 5 credits.
date_fromstringdate_tostringgame_statestringFUT · LIVE · FINAL · OFFgame_typestringregular · playoff · preseasonleaguestringnhl · pwhl · ohl · whl · qmjhl · echllimitintegerseasonstringteamstringget_scheduleUse when checking what games are coming up. Returns only unplayed future games for the next N days (default 7). For past games, use get_games instead. Costs 2 credits.3 params
Use when checking what games are coming up. Returns only unplayed future games for the next N days (default 7). For past games, use get_games instead. Costs 2 credits.
daysintegerleaguestringnhl · pwhl · ohl · whl · qmjhl · echlteamstringget_game_detailUse when you need everything about one game: both teams' full info, all betting odds, and the goalies who started, with their time on ice. Requires a game ID (get one from get_games or get_schedule). Odds for every game from 2019-20 on (and part of the 2019 playoffs). Goalie s...2 params
Use when you need everything about one game: both teams' full info, all betting odds, and the goalies who started, with their time on ice. Requires a game ID (get one from get_games or get_schedule). Odds for every game from 2019-20 on (and part of the 2019 playoffs). Goalie s...
game_id*stringleaguestringnhl · pwhl · ohl · whl · qmjhl · echlget_head_to_headUse when comparing two teams' history. Returns recent matchups with win/loss record. Can filter by season or get all-time. Costs 10 credits.5 params
Use when comparing two teams' history. Returns recent matchups with win/loss record. Can filter by season or get all-time. Costs 10 credits.
leaguestringnhl · pwhl · ohl · whl · qmjhl · echllimitintegerseasonstringteam1*stringteam2*stringsearch_playersUse when looking up a player by name. Searches 4,900+ players across every season since 2010-11. Returns active players by default; set active=false for retired/historical. Use the returned player ID with get_player_stats for full details. Costs 2 credits.6 params
Use when looking up a player by name. Searches 4,900+ players across every season since 2010-11. Returns active players by default; set active=false for retired/historical. Use the returned player ID with get_player_stats for full details. Costs 2 credits.
activebooleanleaguestringnhl · pwhl · ohl · whl · qmjhl · echllimitintegerpositionstringG · D · C · LW · RWquery*stringteamstringget_player_statsUse when you need full details for one player: bio, team, and physical attributes. For skaters, also returns the latest season line (games, goals, assists, points, +/-, PP/SH, shooting%, TOI). For goalies, save%, GAA, GSAX, and trend data. Requires player ID from search_player...2 params
Use when you need full details for one player: bio, team, and physical attributes. For skaters, also returns the latest season line (games, goals, assists, points, +/-, PP/SH, shooting%, TOI). For goalies, save%, GAA, GSAX, and trend data. Requires player ID from search_player...
leaguestringnhl · pwhl · ohl · whl · qmjhl · echlplayer_id*integerget_goalie_statsUse when ranking goalies or comparing goalie performance. Returns a leaderboard sorted by save%, GAA, GSAX, or wins, with a games-played filter. Includes goals saved above expected, high-danger save%, rolling save% and GSAX over the last 10 appearances, form trend and rest day...6 params
Use when ranking goalies or comparing goalie performance. Returns a leaderboard sorted by save%, GAA, GSAX, or wins, with a games-played filter. Includes goals saved above expected, high-danger save%, rolling save% and GSAX over the last 10 appearances, form trend and rest day...
leaguestringnhl · pwhl · ohl · whl · qmjhl · echllimitintegermin_gamesintegerseasonstringsort_bystringsave_pct · gaa · gsax · winsteamstringget_skater_season_statsUse when ranking skaters or comparing scoring. Returns a leaderboard sorted by points, goals, assists, plus/minus, or shots, with a games-played filter. Includes power play and shorthanded production, shooting%, faceoff%, and average time on ice. Seasons from 2010-11 on. Costs...6 params
Use when ranking skaters or comparing scoring. Returns a leaderboard sorted by points, goals, assists, plus/minus, or shots, with a games-played filter. Includes power play and shorthanded production, shooting%, faceoff%, and average time on ice. Seasons from 2010-11 on. Costs...
leaguestringnhl · pwhl · ohl · whl · qmjhl · echllimitintegermin_gamesintegerseasonstringsort_bystringpoints · goals · assists · plus_minus · shotsteamstringget_player_game_logUse when you need a player's game-by-game stat lines for a season, not a season total. For skaters: date, opponent, home/away, goals, assists, points, shots, PIM and power-play points for each game. For goalies: date, opponent, home/away, decision, shots against, saves, goals...6 params
Use when you need a player's game-by-game stat lines for a season, not a season total. For skaters: date, opponent, home/away, goals, assists, points, shots, PIM and power-play points for each game. For goalies: date, opponent, home/away, decision, shots against, saves, goals...
game_typestringregular · playoff · preseason · allleaguestringnhl · pwhl · ohl · whl · qmjhl · echllimitintegeroffsetintegerplayer_id*integerseasonstringget_oddsUse when checking betting lines. Pass game_id for one game (10 credits): moneyline, puck line and total by bookmaker, opening and closing. Or pass season (optionally with team) for a whole season of closing lines in one call, with final scores, at 10 credits per game returned...9 params
Use when checking betting lines. Pass game_id for one game (10 credits): moneyline, puck line and total by bookmaker, opening and closing. Or pass season (optionally with team) for a whole season of closing lines in one call, with final scores, at 10 credits per game returned...
all_booksbooleanbookmakerstringestimate_onlybooleangame_idstringlimitintegeroffsetintegerseasonstringsnapshot_typestringopening · closingteamstringget_line_movementUse when analyzing how betting lines moved over time. Returns time-series snapshots grouped by bookmaker. Most expensive tool (25 cr). If you only need current lines, use get_odds (10 cr) instead. Prices are market information: never work out a stake, payout or profit, recomme...2 params
Use when analyzing how betting lines moved over time. Returns time-series snapshots grouped by bookmaker. Most expensive tool (25 cr). If you only need current lines, use get_odds (10 cr) instead. Prices are market information: never work out a stake, payout or profit, recomme...
bookmakerstringgame_id*stringget_player_propsUse for player prop lines by sportsbook: over/under on points, goals, assists, shots on goal, blocked shots, goalie saves, power-play points, anytime and first goal scorer, from May 2023 (DraftKings, FanDuel, BetMGM, ESPN BET, Pinnacle and others). Pass game_id for every playe...8 params
Use for player prop lines by sportsbook: over/under on points, goals, assists, shots on goal, blocked shots, goalie saves, power-play points, anytime and first goal scorer, from May 2023 (DraftKings, FanDuel, BetMGM, ESPN BET, Pinnacle and others). Pass game_id for every playe...
bookmakerstringestimate_onlybooleanfrom_datestringgame_idstringmarketstringplayer_points · player_goals · player_assists · player_shots_on_goal · player_blocked_shots · player_total_savesplayer_idnumber | stringsnapshot_typestringopening · closingto_datestringget_prop_historyUse to see how a player did against his prop line over time: for one market (points, goals, assists, shots on goal, blocked shots, goalie saves, power-play points, or anytime or first goal scorer), one row per game with the closing line (the median across books, or one book's)...7 params
Use to see how a player did against his prop line over time: for one market (points, goals, assists, shots on goal, blocked shots, goalie saves, power-play points, or anytime or first goal scorer), one row per game with the closing line (the median across books, or one book's)...
bookmakerstringestimate_onlybooleanfrom_datestringlimitintegermarket*stringplayer_points · player_goals · player_assists · player_shots_on_goal · player_blocked_shots · player_total_savesplayer_id*number | stringto_datestringget_prop_movementUse to see how one player's prop line moved before a game: every capture we hold, book by book and oldest first, with the line, both prices and the minutes before the start. line_change is the last capture's line minus the first's. The number of captures varies by game and boo...4 params
Use to see how one player's prop line moved before a game: every capture we hold, book by book and oldest first, with the line, both prices and the minutes before the start. line_change is the last capture's line minus the first's. The number of captures varies by game and boo...
bookmakerstringgame_id*stringmarket*stringplayer_points · player_goals · player_assists · player_shots_on_goal · player_blocked_shots · player_total_savesplayer_id*number | stringget_market_oddsUse for the extra betting markets of a game as history: the regulation result (three-way, a draw is possible), the 1st period result and puck line, and the 1st, 2nd and 3rd period totals. Pass game_id (from get_schedule or get_games) and market. For each sportsbook it returns...4 params
Use for the extra betting markets of a game as history: the regulation result (three-way, a draw is possible), the 1st period result and puck line, and the 1st, 2nd and 3rd period totals. Pass game_id (from get_schedule or get_games) and market. For each sportsbook it returns...
bookmakerstringestimate_onlybooleangame_id*stringmarket*stringh2h_3_way · totals_p1 · totals_p2 · totals_p3 · h2h_p1 · spreads_p1get_playsUse for play-by-play events: goals, shots, misses, blocks, faceoffs, hits, giveaways, takeaways, penalties, with rink coordinates, strength state (5v5, 5v4), zone, and the players involved. Filter by game, season, team, player (any role), event type, strength, zone, or period....12 params
Use for play-by-play events: goals, shots, misses, blocks, faceoffs, hits, giveaways, takeaways, penalties, with rink coordinates, strength state (5v5, 5v4), zone, and the players involved. Filter by game, season, team, player (any role), event type, strength, zone, or period....
game_idstringleaguestringnhl · pwhl · ohl · whl · qmjhl · echllimitintegeroffsetintegerperiodintegerplayer_idintegerseasonstringshot_attempts_onlybooleanstrengthstringteamstringtypestringgoal · shot-on-goal · missed-shot · blocked-shot · faceoff · hitzonestringO · N · Dget_shot_mapUse when you want shot locations rather than a list of events: every shot attempt with rink coordinates, shot type, strength, shooter and goalie. Filter by game, or by season plus a team or player. Paginated: follow next_offset, since a season runs past one page and pages are...9 params
Use when you want shot locations rather than a list of events: every shot attempt with rink coordinates, shot type, strength, shooter and goalie. Filter by game, or by season plus a team or player. Paginated: follow next_offset, since a season runs past one page and pages are...
game_idstringgame_typestringregular · playoff · preseason · allleaguestringnhl · pwhl · ohl · qmjhl · echl · ahllimitintegeroffsetintegerplayer_idintegerseasonstringstrengthstringteamstringget_shiftsUse for who was on the ice and when: every player's shifts in one NHL game, each with period, start and end (period clock and seconds from the opening faceoff) and duration, plus the official boxscore time on ice and plus/minus. Filter to one team or player. NHL games from 201...3 params
Use for who was on the ice and when: every player's shifts in one NHL game, each with period, start and end (period clock and seconds from the opening faceoff) and duration, plus the official boxscore time on ice and plus/minus. Filter to one team or player. NHL games from 201...
game_id*stringplayer_idintegerteamstringget_situation_timeUse for exact time at each strength: the seconds each team spent at 5v5, 5v4, 4v5, 4v4, 6v5 with the goalie pulled and every other on-ice state in an NHL game, split into regulation and overtime, from the shift charts. Also even / power-play / shorthanded totals, goalie-pulled...3 params
Use for exact time at each strength: the seconds each team spent at 5v5, 5v4, 4v5, 4v4, 6v5 with the goalie pulled and every other on-ice state in an NHL game, split into regulation and overtime, from the shift charts. Also even / power-play / shorthanded totals, goalie-pulled...
datestringgame_idstringinclude_playersbooleanget_predictionsUse for the model's win probability for each NHL game on the current slate: home and away win probability, the A/B/C confidence grade, start time, plus the model version and when the slate was generated. Takes no arguments (current slate only). Probabilities are the model's ow...
Use for the model's win probability for each NHL game on the current slate: home and away win probability, the A/B/C confidence grade, start time, plus the model version and when the slate was generated. Takes no arguments (current slate only). Probabilities are the model's ow...
No parameters. Call it with no arguments.
get_prop_projectionsPaid plans only (not available on the free plan). Use for the model's projected stat lines for tonight's NHL players: for each game, each skater's projected goals, assists, points and shots with a low-to-high range, and each goalie's projected saves. Skaters also carry over pr...2 params
Paid plans only (not available on the free plan). Use for the model's projected stat lines for tonight's NHL players: for each game, each skater's projected goals, assists, points and shots with a low-to-high range, and each goalie's projected saves. Skaters also carry over pr...
playerstringteamstringSponsors
Readme
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]
Details
- Repository
- github.com/puckapi/mcp
- Transport
- HTTP
- Auth
- Required
- Registry
- MCP registry, active
- Tools verified
- Nov 6, 2026