Skip to content

PuckAPI/mcp

Folders and files

NameName
Last commit message
Last commit date

Latest commit

 

History

16 Commits
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 
 

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 puckapi \
  --transport streamable-http \
  "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 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:

curl -H "x-api-key: YOUR_API_KEY" \
  https://mcp.puckapi.com/v1/get_standings

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

Releases

No releases published

Packages

 
 
 

Contributors