Skip to content
PuckAPI
MCP server + hockey skills

Claude skills for hockey analytics.

28 free skills that turn Claude into a hockey analyst: game previews, goalie analysis, odds and line movement, xG models, backtests and bet tracking, all wired to the PuckAPI MCP server.

# Install the skills as a Claude Code plugin (or git clone the repo)
> /plugin marketplace add PuckAPI/claude-sports-analytics
> /plugin install puckapi-skills@puckapi

# Add the MCP server
$ claude mcp add puckapi https://mcp.puckapi.com/mcp?key=YOUR_API_KEY --transport streamable-http

# Then ask Claude a stable first question
$ claude "Using PuckAPI, list the supported hockey teams, then show today's schedule if games are available. Keep the answer concise and cite the tools used."

Claude Desktop config

Use this when your MCP client accepts a Streamable HTTP URL.

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

First useful prompts

“Using PuckAPI, list the supported hockey teams, then show today's schedule if games are available. Keep the answer concise and cite the tools used.”

“Using PuckAPI, show the current standings, then summarize the top teams by division or conference. Cite the tools used.”

“Using PuckAPI, search for a player by name, then show available player stats. If the result is a goalie, use goalie stats instead. Cite the tools used.”

27 MCP tools

The same hockey data is available through REST and MCP. Credits are charged per tool call.

Open endpoint docs
list_teams1cr

All 32 active NHL teams with divisions, conferences, and arenas

get_standings2cr

Current standings with advanced stats

get_schedule2cr

Upcoming games for next N days

search_players2cr

Find players by name, team, or position

get_games5cr

Query by date, team, season, game state, or type

get_team_stats5cr

Detailed stats for a specific team with advanced metrics

get_player_stats5cr

Player bio and team context; season line for skaters, goalie stats for goalies

get_goalie_stats5cr

Goalie leaderboard sorted by save%, GAA, GSAX, or wins

get_skater_season_stats5cr

Skater leaderboard sorted by points, goals, assists, +/-, or shots

get_player_game_log5cr

A player's game-by-game stat lines for a season, not a season total

get_predictions5cr

The model's win probability and A/B/C grade for each game on the current slate, with the model version and a backtest note

get_prop_projections25cr

Paid plans only. The model's projected goals, assists, points, shots and saves for tonight's players, with ranges and over probabilities

get_odds10cr

Odds by game with bookmaker filters

get_game_detail10cr

Full game detail with odds and goalie starts

get_head_to_head10cr

Matchup history with win/loss records

get_plays10cr

Play-by-play events with rink coordinates, strength state, and the players involved

get_shot_map10cr

Every shot attempt with rink coordinates, shot type, shooter and goalie

get_shifts10cr

Every player's shifts in a game, to the second, with official time on ice and plus/minus

get_situation_time10cr

Exact seconds each team spent at 5v5, 5v4, 4v5, 6v5 and every other on-ice state, by game or date

get_line_movement25cr

Time-series odds grouped by bookmaker

get_player_props10cr

Player prop lines by sportsbook: the closing line; the opening line where held

get_prop_history10cr

A player's prop lines against the result, game by game

get_prop_movement10cr

How one player's prop line moved before a game, every capture by sportsbook

get_market_odds10cr

Opening and closing lines by sportsbook for the period and regulation-result markets (history from May 2023)

get_game_probabilities5cr

What the market thinks of a game: average implied and fair probability for the moneyline, puck lines and totals

get_prop_probabilities10cr

What the market thinks of a game's player props: average implied and fair probability for each player and line

get_prop_backtest25cr

How often a kind of player prop hit against what the market implied, by your filters, since May 2023

27
MCP tools
28
skills
7
skill categories
01

Data Exploration

Find games, compare teams, scout players, check odds.

game-lookup

Find games by date, team, season. Scores and schedule.

team-analysis

Standings, stats, strength of schedule, rankings.

player-scouting

Player search, stats, comparison, NHLe translation.

goalie-analysis

GSAA, xSV%, high-danger save%, workload tracking.

odds-explorer

Multi-book odds comparison, line movement detection.

nl-to-query

Natural language to structured data queries.

game-preview

Full game preview: matchup, goalie, trends, odds.

02

Hockey Analytics

Understand and build the metrics that matter.

hockey-analytics

Corsi, Fenwick, xG, PDO, RAPM, WAR definitions and context.

xg-model-building

Build an expected goals model from play-by-play shot data.

03

Methodology

Feature engineering, model training, validation, calibration.

feature-engineering

Rolling windows, shift(1) leakage detection, feature catalogs.

walk-forward-validation

Temporal cross-validation. Refuses k-fold on time series.

model-building

LR to RF to XGBoost ladder. Hard-vote ensemble.

elo-engineering

5 Elo variants with NHL-tuned configs.

probability-calibration

Platt scaling, isotonic regression, Brier score decomposition.

odds-analysis

4 devigging methods (power, multiplicative, Shin, worst-case).

data-pipeline

GitHub Actions automation, SQLite schema, credit budgeting.

04

Betting

Find edges, size bets, track performance honestly.

edge-detection

EV calculation, Kelly criterion sizing, CLV tracking.

backtesting

Walk-forward historical strategy simulation.

daily-card

Full slate analysis with edge rankings. Requires your model.

bet-tracker

Log predictions, track CLV, test statistical significance.

visualization

Calibration plots, edge charts, player cards, correlation matrices.

05

Sport-Specific Models

Specialized prediction models for specific bet types.

totals-modeling

Over/under prediction. Pace metrics, Poisson, under bias.

prop-modeling

Player prop projections. TOI-first architecture, SGP correlation.

war-gar-decomposition

RAPM ridge regression, component GAR, contract surplus.

playoff-simulation

Monte Carlo season and bracket simulation.

06

Workflow

Prompt patterns, hypothesis testing, skill routing.

ai-hockey-workflow

4 workflow patterns for hypothesis testing with Claude.

dispatch

Routes requests to the right 2-3 skills automatically.

07

Infrastructure

MCP tool routing, credit tracking, data source management.

puckapi-tool

Routes all MCP tool calls. 27 endpoints, credit tracking, BYOD support.

Skills for other sports

Open source methodology. Production-ready data.

The skills are free forever. When you need real data, PuckAPI is ready. Start with 500 free credits every month.