# Claude Sports Analytics

> 28 free Claude Code skills for NHL analytics, betting models, and hockey research. Works with PuckAPI MCP server for live data.

- **Type:** MCP server
- **Install:** `agentstack add mcp-puckapi-claude-sports-analytics`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [PuckAPI](https://agentstack.voostack.com/s/puckapi)
- **Installs:** 0
- **Category:** [Data & Analytics](https://agentstack.voostack.com/c/data-and-analytics)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [PuckAPI](https://github.com/PuckAPI)
- **Source:** https://github.com/PuckAPI/claude-sports-analytics
- **Website:** https://puckapi.com

## Install

```sh
agentstack add mcp-puckapi-claude-sports-analytics
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

**Turn Claude into a hockey analyst.** 28 free skills covering NHL analytics,betting methodology, and predictive modeling. No code to install.

[](LICENSE)
[](skills/)
[](https://github.com/PuckAPI/mcp)

[Quick Start](#quick-start) · [All Skills](#skills) · [How It Works](#how-it-works) · [Data](#data) · [Docs](#reference-docs)

```
You:    "Build me an expected goals model from shot data"
Claude: [loads xg-model-building skill → walks you through feature selection,
         spatial coordinates, shot type encoding, logistic regression baseline,
         gradient boosting upgrade, calibration, and evaluation]
```

```
You:    "What's the edge on tonight's Sabres game?"
Claude: [loads odds-explorer + edge-detection → pulls live odds from 15+ books,
         compares to your model's probabilities, calculates EV, sizes the bet]
```

## Quick Start

**1. Clone the skills:**

```bash
git clone https://github.com/PuckAPI/claude-sports-analytics.git
```

**2. Connect live NHL data** (optional — 500 free credits):

```bash
claude mcp add puckapi \
  --transport streamable-http \
  "https://mcp.puckapi.com/mcp?key=YOUR_API_KEY"
```

Get your free key at puckapi.com. Skills also work with your own CSV/JSON files — no API key needed.

**3. Ask Claude anything:**

```
"Analyze the Maple Leafs' season — record, Corsi, xG, special teams"
"Help me build a game prediction model"
"Show me tonight's odds and flag any line movement"
"Compare McDavid and MacKinnon across every stat"
"Backtest my betting strategy over the last 3 seasons"
```

The `dispatch` skill routes your request to the right 2-3 skills automatically.

---

## Skills

Data Exploration — 7 skills

| Skill | What It Does |
|-------|-------------|
| `game-lookup` | Find games by date, team, season. Scores, schedule, results. |
| `team-analysis` | Standings, advanced stats, strength of schedule, power rankings. |
| `player-scouting` | Player search, comparison, NHLe translation, career trajectory. |
| `goalie-analysis` | GSAA, xSV%, high-danger save rate, workload tracking. |
| `odds-explorer` | Multi-book odds comparison, best price, line movement detection. |
| `nl-to-query` | Translates natural language questions into structured data queries. |
| `game-preview` | Full pre-game breakdown: matchup, goalies, trends, odds, prediction. |

Hockey Analytics — 2 skills

| Skill | What It Does |
|-------|-------------|
| `hockey-analytics` | Corsi, Fenwick, xG, PDO, RAPM, WAR — definitions, context, proper usage. |
| `xg-model-building` | Build an expected goals model from scratch. Feature engineering through calibration. |

Modeling Methodology — 7 skills

| Skill | What It Does |
|-------|-------------|
| `feature-engineering` | Rolling windows, lag features, leakage detection, feature catalogs. |
| `walk-forward-validation` | Temporal cross-validation. Refuses k-fold on time-series data. |
| `model-building` | LR → RF → XGBoost ladder. Hard-vote ensemble. Knows when to stop. |
| `elo-engineering` | 5 Elo variants (standard, margin, venue, recency, surface) with tuning. |
| `probability-calibration` | Platt scaling, isotonic regression, reliability diagrams, Brier decomposition. |
| `odds-analysis` | 4 devigging methods: power, multiplicative, Shin, worst-case. |
| `data-pipeline` | GitHub Actions automation, SQLite schema design, credit budgeting. |

Betting — 5 skills

| Skill | What It Does |
|-------|-------------|
| `edge-detection` | Expected value, Kelly criterion sizing, closing line value tracking. |
| `backtesting` | Walk-forward historical strategy simulation with realistic constraints. |
| `daily-card` | Full slate analysis with edge rankings. Requires your model's probabilities. |
| `bet-tracker` | Log predictions, track P&L, CLV, and test for statistical significance. |
| `visualization` | Calibration plots, edge distributions, player cards, correlation matrices. |

Advanced Models — 4 skills

| Skill | What It Does |
|-------|-------------|
| `totals-modeling` | Over/under prediction. Pace metrics, Poisson distribution, under bias. |
| `prop-modeling` | Player prop projections. TOI-first architecture, same-game parlay correlation. |
| `war-gar-decomposition` | RAPM ridge regression, component GAR, contract surplus valuation. |
| `playoff-simulation` | Monte Carlo bracket simulation. Series pricing, path probabilities. |

Workflow + Infrastructure — 3 skills

| Skill | What It Does |
|-------|-------------|
| `dispatch` | Routes your request to the right skills automatically. Start here. |
| `ai-hockey-workflow` | 4 patterns for hypothesis testing: explore, model, validate, deploy. |
| `puckapi-tool` | MCP tool router. 13 endpoints, credit tracking, BYOD data support. |

---

## How It Works

Skills are **markdown files, not code**. Each one teaches Claude a specific domain. When you mention a topic, Claude reads the relevant skill and gains that expertise for the conversation.

**What each skill includes:**

- When to use / when NOT to use
- Step-by-step methodology
- Python/pandas code templates
- Anti-patterns it actively prevents
- Chaining to the next logical skill

**What skills prevent:**

- k-fold on time-series data
- Future data leakage in features
- Overfitting to small samples
- Wrong devigging methods
- Misinterpreting advanced stats

---

## Data

| Source | Coverage |
|--------|----------|
| **[PuckAPI MCP](https://github.com/PuckAPI/mcp)** | 22,000+ games · 107,000+ odds records · 3,000+ players · 16 seasons (2008-present) |
| **Your own files** | Every skill accepts CSV/JSON. Bring your own data, no credits needed. |

---

## Reference Docs

| Doc | Contents |
|-----|----------|
| [`hockey-glossary.md`](docs/hockey-glossary.md) | Corsi, Fenwick, xG, PDO, RAPM, WAR |
| [`betting-glossary.md`](docs/betting-glossary.md) | Odds formats, vig, devigging, Kelly, CLV |
| [`tool-routing.md`](docs/tool-routing.md) | Decision tree for picking the right data source |
| [`season-logic.md`](docs/season-logic.md) | NHL season IDs, game ID format, lockout handling |

---

## Contributing

Found an issue with a skill? Have a methodology improvement? PRs welcome.

Skills are markdown files in `skills/[name]/SKILL.md`. Each skill has a consistent structure — follow the existing patterns.

---

**[PuckAPI MCP Server](https://github.com/PuckAPI/mcp)** · **[puckapi.com](https://puckapi.com)** · **[API Docs](https://puckapi.com/docs)**

MIT License

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [PuckAPI](https://github.com/PuckAPI)
- **Source:** [PuckAPI/claude-sports-analytics](https://github.com/PuckAPI/claude-sports-analytics)
- **License:** MIT
- **Homepage:** https://puckapi.com

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-puckapi-claude-sports-analytics
- Seller: https://agentstack.voostack.com/s/puckapi
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.