English Français العربية

PuckAPI

السجل الرسمي أخرى

NHL and PWHL stats, play-by-play, expected goals and odds. REST API and MCP server. Free to start.

الشيفرة المصدرية التوثيق

التثبيت

أضف هذا إلى إعدادات MCP في عميلك (Claude Desktop: claude_desktop_config.json، وCursor: ‏.cursor/mcp.json، ويستخدم VS Code وغيره الصيغة نفسها «mcpServers»).

Remote (streamable-http)
Claude Code 
claude mcp add --transport http puckapi 'https://mcp.puckapi.com/mcp' --header 'x-api-key: <Your PuckAPI API key. Get a free key (500 credits every month) at puckapi.com/signup>'
إعداد JSON (Claude Desktop وCursor وVS Code) 
{
    "mcpServers": {
        "puckapi": {
            "type": "http",
            "url": "https://mcp.puckapi.com/mcp",
            "headers": {
                "x-api-key": "<Your PuckAPI API key. Get a free key (500 credits every month) at puckapi.com/signup>"
            }
        }
    }
}

التوثيق

مأخوذ من ملف README للمشروع على GitHub ويُحدَّث أسبوعيًا. تفتح الروابط على GitHub.

المحتويات
  1. Quick Start
  2. Available Tools
  3. Data Coverage
  4. Pricing
  5. REST API
  6. Used by
  7. Related

The 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:

SettingValue
URLhttps://mcp.puckapi.com/mcp?key=YOUR_API_KEY
TransportStreamable 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

ToolDescription
get_gamesGame results with scores, periods, shots, and goals
get_scheduleUpcoming and past game schedules
get_game_detailFull box score for a specific game
get_head_to_headHistorical matchup data between two teams

Teams -- 3 tools

ToolDescription
get_standingsCurrent or historical standings by season
get_team_statsTeam-level stats (goals, shots, PP%, PK%, etc.)
list_teamsAll NHL teams with abbreviations and metadata

Players -- 5 tools

ToolDescription
search_playersFind players by name
get_player_statsSkater stats (goals, assists, points, TOI, etc.)
get_skater_season_statsSeason stats leaderboard -- goals, assists, points, TOI, shooting %, filterable by team and sortable by 5 metrics
get_goalie_statsGoalie stats (SV%, GAA, wins, shutouts, etc.)
get_player_game_logGame-by-game lines for a skater or goalie in a season: goals, assists, shots, PIM, saves, SV%

Odds -- 2 tools

ToolDescription
get_oddsOpening and closing moneyline, puck line and total by sportsbook, every game from 2019-20
get_line_movementTime-series odds grouped by bookmaker

Play-by-play -- 2 tools

ToolDescription
get_playsPlay-by-play events with rink coordinates, strength state and the players involved
get_shot_mapEvery shot attempt with rink coordinates, shot type, shooter and goalie

Data Coverage

CategoryDetails
Games23,000+ across 16 seasons
Play-by-playEvery event since 2010-11 with rink coordinates (6.8M+ events)
OddsEvery 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 movementHourly snapshots from September 2026
Players4,800+ skaters and goalies
ComputedExpected goals, GSAX, Corsi and Fenwick
PWHLGames, standings, play-by-play and shot locations; pass league: "pwhl" (details)
UpdatesGames daily; odds captured hourly

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

Pricing

PlanCredits/moPrice
Free500 every month$0
Starter10,000$19/mo
Pro30,000$49/mo
Scale125,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.
PuckAPI Skills28 free Claude Code skills for hockey analytics, betting models, and research
puckapi.comSign up, dashboard, API docs
NHL odds tonightEvery tracked sportsbook's moneyline, puck line and total, refreshed hourly
NHL player props todayPoints, goals, shots, saves and anytime scorer: the consensus line and the best over and under price per player
Shots on goal prop historyHow often a player goes over his shots line, game by game, in Python
Other sports, same tools and key format
EndzoneAPINFL and college football
DunkAPINBA, WNBA and college basketball
FastballAPIMLB and college baseball
StrikerAPISoccer, 17 competitions
AcesAPIATP and WTA tennis
BirdieAPIPGA Tour and other golf tours
FighterAPIUFC, PFL and Bellator

puckapi.com · API Docs · Skills

MIT License

الأسئلة الشائعة

ما هو PuckAPI؟

NHL and PWHL stats, play-by-play, expected goals and odds. REST API and MCP server. Free to start.

كيف أثبّت PuckAPI؟

يعمل كخادم بعيد. في Claude Code: claude mcp add --transport http puckapi 'https://mcp.puckapi.com/mcp' --header 'x-api-key: <Your PuckAPI API key. Get a free key (500 credits every month) at puckapi.com/signup>'. وفي العملاء الآخرين، الصق إعداد JSON من هذه الصفحة في إعدادات MCP الخاصة بهم.

هل يحتاج PuckAPI إلى مفتاح API؟

نعم. يتطلب x-api-key، وتضبطها في إعداداته.

هل PuckAPI مفتوح المصدر؟

نعم. شيفرته متاحة على GitHub بترخيص MIT.

من يصون PuckAPI؟

ينشره PuckAPI. يدرجه AI.tn لكنه لا يصونه ولا يوصي به.

من سجل MCP الرسمي. الإدراج ليس توصية: راجع شيفرة الخادم وصلاحياته قبل منحه الوصول إلى بياناتك.