io.github.noahowsh/puckapi

Official

by PuckAPI · JavaScript

PuckAPI

The hockey data API. Stats, odds, and everything between. REST API and MCP server.

Query hockey statistics, odds, and game data via REST API and MCP.

Topics

aianthropicbettingclaudehockeymcpmcp-servernhlnhl-apioddssports-analyticssports-datamodel-context-protocolhockey-api

README.md5 KBView on GitHub

The hockey data API. Stats, odds, and everything between. REST API and MCP server. Free to start.

Quick Start · Tools · Data · Pricing · REST API

</div>

code

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:

json

{
  "mcpServers": {
    "puckapi": {
      "url": "https://mcp.puckapi.com/mcp?key=YOUR_API_KEY"
    }
  }
}

Claude Code -- one command:

bash

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

<details open> <summary>Games -- 4 tools</summary>

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

</details> <details> <summary>Teams -- 3 tools</summary>

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

</details> <details> <summary>Players -- 4 tools</summary>

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.)

</details> <details> <summary>Odds -- 2 tools</summary>

Tool	Description
`get_odds`	Pre-game odds from 15+ sportsbooks (ML, spread, total)
`get_line_movement`	Track how lines move from open to close

</details>

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:

bash

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

Full documentation at puckapi.com/docs.


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

</div>

Install

claude_desktop_config.json

{
  "mcpServers": {
    "puckapi": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://mcp.puckapi.com/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.