Skip to content

Latest commit

 

History

17 Commits

Folders and files

NameName
Last commit message
Last commit date
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

Repository files navigation

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

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 -- 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 Opening and closing moneyline, puck line and total by sportsbook, back to 2020-21
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 Opening and closing lines back to 2020-21; 60+ books including Pinnacle from 2025-26
Line movement Hourly snapshots from September 2026
Players 4,800+ skaters and goalies
Computed Expected goals, GSAX, Corsi and Fenwick
Updates Games daily; odds captured hourly

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


Pricing

Plan Credits/mo Price
Free 500 $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.


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

About

NHL data MCP server for Claude and AI agents. Stats, odds, schedules, line movement.

Topics

Resources

Stars

0 stars

Watchers

0 watching

Forks

Releases

Packages

Contributors

Languages