PuckAPI

冰球數據API。統計數據、賠率,以及介於兩者之間的一切。

文件

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:

SettingValue
URLhttps://mcp.puckapi.com/mcp?key=YOUR_API_KEY
TransportStreamable 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.


Starter projects

  • nhl-xg-model: a season of shot locations to a calibrated expected-goals model, in one Python script.

Use it in

Available Tools

28 tools. Credits per call in the second column.

ToolCreditsWhat it returns
list_teams1Use when you need team abbreviations, or to see all 32 active NHL teams with city, conference, division, and arena.
get_schedule2Use when checking what games are coming up.
get_standings2Use when checking where teams rank in their division or conference.
search_players2Use when looking up a player by name.
get_game_probabilities5Use for what the market thinks of one game, not any one book's price: the average implied probability (margin in) and the fair probability (margin out) for the moneyline, each puck line and each total, with how many books each rests on.
get_games5Use when querying past or future games with filters.
get_goalie_stats5Use when ranking goalies or comparing goalie performance.
get_player_game_log5Use when you need a player's game-by-game stat lines for a season, not a season total.
get_player_stats5Use when you need full details for one player: bio, team, and physical attributes.
get_predictions5Use 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.
get_skater_season_stats5Use when ranking skaters or comparing scoring.
get_team_stats5Use 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).
get_alt_lines10Use for alternate puck lines and totals by sportsbook: every point on each book's ladder with its price (e.g. -2.5 at +250, over 7.5 at +160), for one game.
get_game_detail10Use when you need everything about one game: both teams' full info, all betting odds, and the goalies who started, with their time on ice.
get_head_to_head10Use when comparing two teams' history.
get_market_odds10Use 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.
get_odds10Use when checking betting lines.
get_player_props10Use 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).
get_plays10Use 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.
get_prop_history10Use 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), the opening line (the same as the close wherever only one capture was taken), the prices, what the player actually recorded from our box scores and the result against the line, plus the over rate, up to 200 games a call.
get_prop_movement10Use 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.
get_prop_probabilities10Use for what the market thinks of the player props in one game, not any one book's price: for each player and each line, the average implied probability (margin in) and the fair probability (margin out), with how many books each rests on.
get_shifts10Use 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.
get_shot_map10Use when you want shot locations rather than a list of events: every shot attempt with rink coordinates, shot type, strength, shooter and goalie.
get_situation_time10Use 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.
get_line_movement25Use when analyzing how betting lines moved over time.
get_prop_backtest25Use to test an idea about player props without pulling every row: how often a kind of prop went over or under against what the market implied, across every finished game we hold prices for that fits your filters.
get_prop_projections25Paid plans only (not available on the free plan).

Data Coverage

CategoryDetails
Games23,000+ across 16 seasons
Play-by-playEvery event since 2010-11 with rink coordinates (6.8M+ events)
OddsEvery 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 movementHourly snapshots from September 2026
Players4,800+ skaters and goalies
ComputedExpected goals, GSAX, Corsi and Fenwick
PWHLGames, standings, play-by-play and shot locations; pass league: "pwhl" (details)
UpdatesGames daily; odds captured hourly

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


Pricing

PlanCredits/moPrice
Free500 every month$0
Starter10,000$19/mo
Pro30,000$49/mo
Scale125,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.


Used by

PuckCast, our NHL predictions site, runs on this API.

Related

PuckAPI Skills28 free Claude Code skills for hockey analytics, betting models, and research
puckapi.comSign up, dashboard, API docs
NHL odds tonightEvery tracked sportsbook's moneyline, puck line and total, refreshed hourly
NHL player props todayPoints, goals, shots, saves and anytime scorer: the consensus line and the best over and under price per player
Shots on goal prop historyHow often a player goes over his shots line, game by game, in Python

Other sports, same tools and key format

EndzoneAPINFL and college football
DunkAPINBA, WNBA and college basketball
FastballAPIMLB and college baseball
StrikerAPISoccer, 17 competitions
AcesAPIATP and WTA tennis
BirdieAPIPGA Tour and other golf tours
FighterAPIUFC, PFL and Bellator

puckapi.com · API Docs · Skills

MIT License