About PuckAPI
PuckAPI is a hockey data API for analysts and developers, covering NHL and PWHL games, players, teams, play-by-play, computed metrics and odds. Data is available through REST and a hosted MCP server.
Key features
- 01NHL and PWHL game and team data
- 02Player and goalie statistics
- 03Play-by-play and shot locations
- 04Expected goals, GSAX, Corsi and Fenwick
- 05Historical odds and line movement
Use cases
- 01Check game results, schedules and standings
- 02Compare player season statistics
- 03Inspect shot maps and play-by-play events
- 04Track bookmaker odds across a game
MCP support
The hosted MCP server exposes tools for games, teams, players, odds, play-by-play and shot maps. MCP clients connect over Streamable HTTP.
Configuration
Remote servers need no local install. Pick your client, then copy the config or install in one click.
https://mcp.puckapi.com/mcpclaude mcp add --transport http noahowsh-puckapi https://mcp.puckapi.com/mcp{"mcpServers":{"noahowsh-puckapi":{"type":"http","url":"https://mcp.puckapi.com/mcp"}}}Open in Cursor{"servers":{"noahowsh-puckapi":{"type":"http","url":"https://mcp.puckapi.com/mcp"}}}Open in VS Code{"mcpServers":{"noahowsh-puckapi":{"type":"http","url":"https://mcp.puckapi.com/mcp"}}}{"mcpServers":{"noahowsh-puckapi":{"serverUrl":"https://mcp.puckapi.com/mcp"}}}Run commands in a terminal; paste JSON into the client’s MCP config and restart. Servers that need sign-in will prompt on first connect.
https://mcp.puckapi.com/mcpAuth requiredTools
22| Parameter | Type | Required | Description |
|---|---|---|---|
| league | enum | No | League. Defaults to nhl. One of: nhl, pwhl, ohl, whl, qmjhl, echl, ahl, ushl.nhl | pwhl | ohl | whl | qmjhl | echl | ahl | ushl |
| season | string | No | Season ID, 8-digit (e.g. 20242025 for 2024-25). 2024-25 and 2024-2025 also accepted. Defaults to current season. |
| division | string | No | Filter by division (e.g. Atlantic, Metropolitan, Central, Pacific) |
| conference | enum | No | Filter by conferenceEastern | Western |
Details
From the project READMEThe 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 -- 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 every month | $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.
Used by
PuckCast, our NHL predictions site, runs on this API.
Related
| PuckAPI Skills | 28 free Claude Code skills for hockey analytics, betting models, and research |
| puckapi.com | Sign up, dashboard, API docs |
| NHL odds tonight | Every tracked sportsbook's moneyline, puck line and total, refreshed hourly |
| NHL player props today | Points, goals, shots, saves and anytime scorer: the consensus line and the best over and under price per player |
| Shots on goal prop history | How often a player goes over his shots line, game by game, in Python |
Other sports, same tools and key format
| EndzoneAPI | NFL and college football |
| DunkAPI | NBA, WNBA and college basketball |
| FastballAPI | MLB and college baseball |
| StrikerAPI | Soccer, 17 competitions |
| AcesAPI | ATP and WTA tennis |
| BirdieAPI | PGA Tour and other golf tours |
| FighterAPI | UFC, PFL and Bellator |
puckapi.com · API Docs · Skills
MIT License
Comments
New to MCP?
From what the protocol is to installing your first server, these answers cover most first questions.
An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.