PuckAPI README
The full upstream README, mirrored here for reference. Install config, tool schemas, adoption signals, and an original overview live on the PuckAPI listing page.
The hockey data API. Stats, odds, and everything between.
REST API and MCP server. Free to start.
Quick Start · Tools · Data · Pricing · REST API
Quick Start
Claude Desktop -- add to claude_desktop_config.json:
Claude Code -- one command:
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:
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