io.github.dachhack/stathead-mcp
NPM · STATHEAD-MCP
Fantasy football analytics: stats, dynasty, projections, prospects, Sleeper leagues, Excel I/O
Available components
Last scanned (1 hour ago)
Scores higher than 94% of npm servers
Category Entertainment and Games
How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →
Supply Chain Security100
- No malware found by supply-chain analysis.Pass
- No known CVEs affecting this package version or its production dependencies.Pass
- No install/post-install scripts declared.Pass
- No production dependencies, so there is no dependency health to assess. View diagnostics → Pass
Provenance & Transparency97
- Source repository is publicly reachable at the declared URL. View diagnostics → Pass
- Cryptographically verified build provenance (signed, bound to dachhack/stathead). View diagnostics → Pass
- Clear OSI-approved license (MIT).Pass
- Actively maintained (last published 29 days ago).Pass
- Disclosure check failed: no security disclosure policy was found in the source repository. See how to fix → Fail
Schema Quality & AI Usability60
- AI-judged instruction clarity (excellent).Pass
- Context-footprint check failed: tool/resource definitions use about 23260 tokens (~422/item across 55 items; 55 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
- Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management100
- No destabilizing schema changes in the last 30 days.Pass
Tool Coverage100
- 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
- 100% of tool parameters carry a description.Pass
Tool Safety75
- No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
- 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "clear_overrides" implies "remove" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
- An AI judge read all 55 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
- Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.Pass
Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.
- 4 Nov 26 0
- Security disclosure: unverified → fail ▼ functional
- 3 Nov 26 0
- Security disclosure: fail → unverified ▼ functional
- 19 Oct 26 +1
- Stability: 0.97 → pass security
- 17 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 90 to 93. That category is still filling its 30-day observation window: 27 days of observed history at the previous scan, 28 at this one. The score rises as the window fills, whether or not the server changes.
- 15 Oct 26 +1
No change was recorded against any check on this day. Stability & Change Management went from 83 to 87. That category is still filling its 30-day observation window: 25 days of observed history at the previous scan, 26 at this one. The score rises as the window fills, whether or not the server changes.
- 14 Oct 26 +39
- Injection markers: unverified → pass ▲ security
- Security disclosure: unverified → fail ▼ functional
- Tool coverage: unverified → 100 ▲ functional
- Stability: unverified → 0.83 ▲ functional
- MCP protocol: unverified → pass ▲ functional
- 13 Oct 26 0
- Security disclosure: fail → unverified ▼ functional
- Package version: 1.0.112 → 1.0.113 functional
- 11 Oct 26 −40
- Stability: fail → unverified ▼ security
- Tool safety: pass → unverified ▼ security
- Capabilities: pass → unverified ▼ functional
- Tool coverage: 100 → unverified ▼ functional
- Package version: 1.0.112 → 1.0.113 functional
Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.
Captured 5 Nov 2026 · Analysed npm/stathead-mcp@1.0.113
Provenance Verified
A signed build attestation was found and verified, binding this exact artifact to the source repository it claims to come from.
| Result | Verified |
|---|---|
| Ecosystem | npm |
| Reason | Verified |
| Discovered via | Registry attestation endpoint |
| Source repo | dachhack/stathead |
| Certificate issuer | https://token.actions.githubusercontent.com |
| Certificate SAN | https://github.com/dachhack/stathead/.github/workflows/publish-mcp.yml@refs/heads/claude/nfl-fantasy-workbench-6D1yd |
| Rekor log index | 3114141518 |
| Predicate type | SLSA build provenance https://slsa.dev/provenance/v1 |
| Subject digest | sha512:0f1b08d74611b63fcacc124b582661fffa1d6a0402469a1c695649d7b660b1ff80200b411e043ce395ef59a512308af817b6f4ece2dc2bf164b4ba5d3 |
Background: How many MCP packages publish verified provenance →
Dependencies 0 packages
| Packages resolved | 0 |
|---|---|
| Tree resolution | Complete |
Background: SBOMs and build attestations, explained →
The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →
get_sleeper_matchups ~193
Get head-to-head matchups and scores for a Sleeper league in a given week. Pairs teams by matchup, with each team's points and (optionally) starters. Source: Sleeper public API. See also: get_metadata for season coverage, valid enums, and analytic caveats.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | string | – | Comma-separated column names to return (projection), e.g. "player_name,games,fantasy_points_ppr". Omit to return all columns. Unknown names are ignored. |
| league_id | string | yes | Sleeper league id. |
| output_format | string | – | Output format: "table" (default markdown), "csv", or "jsonl". Use csv/jsonl for compact, token-efficient output on large pulls. |
| starters | boolean | – | Include each team's starting lineup (default false). |
| week | number | yes | Week number (1-18). |
No output schema declared.
No examples provided.
get_sleeper_projections ~227
Kept for compatibility: returns StatHead's own projections, not Sleeper's (third-party projections are inputs only, never shown raw). Pass week for StatHead's weekly projection (same as get_weekly_projections), or omit week for StatHead's season projection (same as get_projections). See also: get_metadata for season coverage, valid enums, and analytic caveats.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | string | – | Comma-separated column names to return (projection), e.g. "player_name,games,fantasy_points_ppr". Omit to return all columns. Unknown names are ignored. |
| limit | number | – | Max rows (default 50) |
| output_format | string | – | Output format: "table" (default markdown), "csv", or "jsonl". Use csv/jsonl for compact, token-efficient output on large pulls. |
| position | string | – | Filter by position |
| season | number | yes | NFL season year |
| week | number | – | Week number (omit for season-long totals summed across weeks 1–18) |
No output schema declared.
No examples provided.
get_sleeper_transactions ~302
Get a Sleeper league's transactions — trades, waiver claims, and free-agent adds/drops — with players and teams resolved to names. Pass a week, or omit it to sweep the season (weeks 1-18). Filter by type. Identify the league by league_id OR username + name. Use for trade history, waiver activity, and roster churn. Source: Sleeper public API. See also: get_metadata for season coverage, valid enums, and analytic caveats.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | string | – | Comma-separated column names to return (projection), e.g. "player_name,games,fantasy_points_ppr". Omit to return all columns. Unknown names are ignored. |
| league_id | string | – | Sleeper league id. |
| limit | number | – | Max transactions (default 40). |
| name | string | – | League name to match (substring); requires username. |
| output_format | string | – | Output format: "table" (default markdown), "csv", or "jsonl". Use csv/jsonl for compact, token-efficient output on large pulls. |
| season | number | – | Season for username+name lookup (default 2026). |
| type | string | – | Filter by transaction type. |
| username | string | – | Alternative to league_id: with name, finds the league among this user's leagues. |
| week | number | – | Week (1-18). Omit to sweep the whole season. |
No output schema declared.
No examples provided.
get_sleeper_trending ~189
Get trending player adds or drops from Sleeper fantasy platform. Shows which players are being most added/dropped across all Sleeper leagues. Use for waiver wire analysis and league-wide sentiment. See also: get_metadata for season coverage, valid enums, and analytic caveats.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | string | – | Comma-separated column names to return (projection), e.g. "player_name,games,fantasy_points_ppr". Omit to return all columns. Unknown names are ignored. |
| hours | number | – | Lookback window in hours (default 24) |
| limit | number | – | Number of players (default 25) |
| output_format | string | – | Output format: "table" (default markdown), "csv", or "jsonl". Use csv/jsonl for compact, token-efficient output on large pulls. |
| type | string | – | Trending adds or drops |
No output schema declared.
No examples provided.
get_sleeper_user_history ~276
Multi-season Sleeper career history for a user: every league they fielded across recent seasons with record, points, regular-season finish, and championship/runner-up result, plus a career summary (total record, titles, leagues). Identify the user by username/user_id, OR display_name + league_id. Source: Sleeper public API. See also: get_metadata for season coverage, valid enums, and analytic caveats.
| Name | Type | Req | Description |
|---|---|---|---|
| display_name | string | – | Manager's in-league display or team name; requires league_id. |
| fields | string | – | Comma-separated column names to return (projection), e.g. "player_name,games,fantasy_points_ppr". Omit to return all columns. Unknown names are ignored. |
| league_id | string | – | Alternative to username: with display_name, resolves a manager to their user_id. |
| limit | number | – | Max league-season rows (default 60). |
| output_format | string | – | Output format: "table" (default markdown), "csv", or "jsonl". Use csv/jsonl for compact, token-efficient output on large pulls. |
| seasons | number | – | How many recent seasons to sweep, ending this year (default 5, max 12). |
| username | string | – | Sleeper username or user_id. |
No output schema declared.
No examples provided.
get_sleeper_user_leagues ~319
Look up a Sleeper user's fantasy leagues. Identify the user by username/user_id, OR by display_name + league_id (to scout a manager you just saw in get_sleeper_league). Returns each league's id, name, size, status, and format (Dynasty/Keeper/Redraft, Superflex/2QB/1QB, Best Ball, IDP), plus the resolved user_id. This is the entry point of the Sleeper graph: take a league_id from here into get_sleeper_league / get_sleeper_matchups / get_sleeper_waiver_wire. Source: Sleeper public API. See also: get_metadata for season coverage, valid enums, and analytic caveats.
| Name | Type | Req | Description |
|---|---|---|---|
| display_name | string | – | Manager's in-league display or team name; requires league_id. |
| fields | string | – | Comma-separated column names to return (projection), e.g. "player_name,games,fantasy_points_ppr". Omit to return all columns. Unknown names are ignored. |
| league_id | string | – | Alternative to username: with display_name, resolves a manager seen in a league to their user_id. |
| output_format | string | – | Output format: "table" (default markdown), "csv", or "jsonl". Use csv/jsonl for compact, token-efficient output on large pulls. |
| season | number | – | NFL season (default 2026). |
| username | string | – | Sleeper username or user_id. |
No output schema declared.
No examples provided.
get_sleeper_user_snooper ~315
Scout a Sleeper user across all their leagues for a season: their league list plus cross-league player exposure — which players they roster in the most leagues (and start most), with the league names. Identify the user by username/user_id, OR by display_name + league_id (to scout a manager you just saw in get_sleeper_league). Use to see who a manager is heavily invested in. Source: Sleeper public API. See also: get_metadata for season coverage, valid enums, and analytic caveats.
| Name | Type | Req | Description |
|---|---|---|---|
| display_name | string | – | Manager's in-league display or team name; requires league_id. |
| fields | string | – | Comma-separated column names to return (projection), e.g. "player_name,games,fantasy_points_ppr". Omit to return all columns. Unknown names are ignored. |
| league_id | string | – | Alternative to username: with display_name, resolves a manager seen in a league to their user_id. |
| limit | number | – | Max players in the exposure table (default 40). |
| output_format | string | – | Output format: "table" (default markdown), "csv", or "jsonl". Use csv/jsonl for compact, token-efficient output on large pulls. |
| position | string | – | Filter exposure to one position (QB, RB, WR, TE). |
| season | number | – | NFL season (default 2026). |
| username | string | – | Sleeper username or user_id. |
No output schema declared.
No examples provided.
get_sleeper_waiver_wire ~392
Find the best available (un-rostered) free agents in a Sleeper league. Cross-references the league's rostered players against all NFL players, then joins Sleeper trending-add counts and StatHead's projections: projected PPG, projected games, and rest-of-season points (ros_pts, the in-season ranking column). Sort by trending (default), ros, or ppg — ppg ranks players projected for at least min_games first, because a backup's ppg is a per-game rate conditional on playing (sorting on it alone returned thirty backup quarterbacks). Use for waiver-wire and streaming decisions. Source: Sleeper public API + StatHead projections. See also: get_metadata for season coverage, valid enums, and analytic caveats.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | string | – | Comma-separated column names to return (projection), e.g. "player_name,games,fantasy_points_ppr". Omit to return all columns. Unknown names are ignored. |
| league_id | string | yes | Sleeper league id. |
| limit | number | – | Max players (default 40). |
| min_games | number | – | For sort_by ppg: players projected for fewer games rank below the rest (default 8). |
| output_format | string | – | Output format: "table" (default markdown), "csv", or "jsonl". Use csv/jsonl for compact, token-efficient output on large pulls. |
| position | string | – | Filter by position (QB, RB, WR, TE, K, DEF). |
| sort_by | string | – | Sort column: trending (default, recent add count), ros (StatHead rest-of-season projected points — the right ranking in-season), or ppg (StatHead projected points per game, ranked among players proje… |
No output schema declared.
No examples provided.
get_snap_counts ~193
Get offensive/defensive snap count percentages by player per week. Use for workload analysis, role changes, snap share trends. See also: get_metadata for season coverage, valid enums, and analytic caveats.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | string | – | Comma-separated column names to return (projection), e.g. "player_name,games,fantasy_points_ppr". Omit to return all columns. Unknown names are ignored. |
| limit | number | – | Max rows (default 50) |
| output_format | string | – | Output format: "table" (default markdown), "csv", or "jsonl". Use csv/jsonl for compact, token-efficient output on large pulls. |
| player_name | string | – | Filter by player name |
| position | string | – | Filter by position |
| season | number | yes | NFL season year (2012+) |
| team | string | – | Filter by team abbreviation |
No output schema declared.
No examples provided.
get_team_metrics ~272
Get comprehensive team-level analytics for a season. Computed from play-by-play data. Offense: pass rate, neutral-script pass rate, EPA/play (total/pass/rush), success rate, yards/play, red zone TD rate, shotgun rate, deep pass rate, pace. Defense: EPA/play allowed (total/pass/rush), defensive success rate. Context: points scored/allowed, point differential, turnovers. Returns one row per team (32 teams). Use for team evaluation, matchup analysis, scheme identification. See also: get_metadata for season coverage, valid enums, and analytic caveats.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | string | – | Comma-separated column names to return (projection), e.g. "player_name,games,fantasy_points_ppr". Omit to return all columns. Unknown names are ignored. |
| output_format | string | – | Output format: "table" (default markdown), "csv", or "jsonl". Use csv/jsonl for compact, token-efficient output on large pulls. |
| season | number | yes | NFL season year |
| sort_by | string | – | Sort by any metric (descending). Common: total_epa_per_play, ppg, success_rate, neutral_pass_rate, def_epa_per_play |
| team | string | – | Filter to a specific team abbreviation |
No output schema declared.
No examples provided.
get_trades ~203
Get historical NFL trades. Shows which teams gave/received players and draft picks, including pick round, number, and conditional status. Use for trade history, draft capital analysis, team-building strategies. See also: get_metadata for season coverage, valid enums, and analytic caveats.
| Name | Type | Req | Description |
|---|---|---|---|
| fields | string | – | Comma-separated column names to return (projection), e.g. "player_name,games,fantasy_points_ppr". Omit to return all columns. Unknown names are ignored. |
| limit | number | – | Max rows (default 50) |
| output_format | string | – | Output format: "table" (default markdown), "csv", or "jsonl". Use csv/jsonl for compact, token-efficient output on large pulls. |
| player_name | string | – | Filter by traded player name |
| season | number | – | Filter to trades in this season |
| team | string | – | Filter to trades involving this team (gave or received) |
No output schema declared.
No examples provided.
get_weekly_projections ~2,147
StatHead's first-party PER-WEEK fantasy projections for 2026 — the season projection (get_projections) split across the schedule: each week = season PPG × a scoring-environment term × the opponent's position-specific deviation, normalized so the 17 games sum back to the season line. Where a market line is published, the environment term is the implied team total (blended 60% against def-vs-pos team strength, home field already priced in); elsewhere it is def-vs-pos team strength × a home/away nudge. An implied total predicts a team's actual points at RMSE 9.13 versus 10.16 for prior-season scoring and 10.20 for current-season-to-date, so where the market has spoken it replaces what we knew rather than supplementing it. 2026 lines currently cover weeks 1-7, 9-12 and 16 and fill in as books post them. Two modes: pass week (1-18) for that week's matchup-adjusted rankings (opponent, matchup %, projected points), or pass player_name alone for one player's full week-by-week outlook including the bye. Covers QB/RB/WR/TE plus kickers (current depth-chart PK1, position K), team defenses (position DST, name "<TEAM> DST", sleeper_id = team code) and individual defensive players (positions DL, LB, DB — the top 96 of each bucket by default-catalog points, which keeps pass rushers whose value is sacks rather than tackles). IDP weekly points come from the season component build split across the schedule, so the weekly feed and the season board quote one number. Expect the IDP matchup swing to be SMALL — a few percent, and near zero for DB: how much an offense concedes to a defensive bucket varies 29-43% within a season but barely repeats across one (yoy r = +0.25 DL, +0.24 LB, +0.08 DB), so the multiplier is shrunk to what persists. It sharpens in-season as current-year weeks blend in. In-season, injury designations are applied in week mode via an availability column as MEASURED expected-value multipliers (2016-2025, 4,147 designated player-weeks, points vs the player's own healt…
| Name | Type | Req | Description |
|---|---|---|---|
| fields | string | – | Comma-separated column names to return (projection), e.g. "player_name,games,fantasy_points_ppr". Omit to return all columns. Unknown names are ignored. |
| limit | number | – | Max players (default 50). |
| output_format | string | – | Output format: "table" (default markdown), "csv", or "jsonl". Use csv/jsonl for compact, token-efficient output on large pulls. |
| player_name | string | – | Filter to one player. Without week, returns their all-18-weeks outlook. DSTs match by team name (e.g. "SEA DST"). |
| position | string | – | Filter by position: QB, RB, WR, TE, K, DST, or the IDP buckets DL, LB, DB. |
| scoring | string | – | Scoring format for the points columns. tep0.5/tep1.0 add a TE-premium bonus per TE reception (exact, from recPG). Default ppr. |
| team | string | – | Filter to one NFL team abbreviation (e.g. DET). |
| week | number | – | NFL week (1-18) to rank. Omit together with player_name for a player's full-season strip; omitting both defaults to the current week (the first week whose games are not all final). |
No output schema declared.
No examples provided.
import_excel ~136
Read back an .xlsx workbook that you exported with export_excel and (optionally) edited, and save your custom values as overrides. After import, get_projections / get_fantasy_rankings / get_prospect_outcomes automatically use YOUR Proj PPG and rankings (flagged in the output) until you run clear_overrides. The workbook kind is auto-detected from its Meta sheet. Returns a summary of what was applied. See also: get_metadata for season coverage, valid enums, and analytic caveats.
| Name | Type | Req | Description |
|---|---|---|---|
| path | string | yes | Path to the .xlsx file to import (the one you exported and edited). |
No output schema declared.
No examples provided.
How do I install the io.github.dachhack/stathead-mcp server?
io.github.dachhack/stathead-mcp runs locally as an npm package, launched with npx -y stathead-mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.
npm · stathead-mcp
claude mcp add dachhack-stathead-mcp -- npx -y stathead-mcp
What is the io.github.dachhack/stathead-mcp server?
io.github.dachhack/stathead-mcp is listed in the public MCP registry as io.github.dachhack/stathead-mcp. Fantasy football analytics: stats, dynasty, projections, prospects, Sleeper leagues, Excel I/O. This page covers its npm package (stathead-mcp).
Is the io.github.dachhack/stathead-mcp server safe to use?
io.github.dachhack/stathead-mcp scores 91 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 5 November 2026. It declares no install or post-install scripts. Its build provenance is signed and verified. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.
What tools does the io.github.dachhack/stathead-mcp server expose?
io.github.dachhack/stathead-mcp exposes 55 tools: get_metadata, get_player_season_stats, get_player_weekly_stats, get_games, get_snap_counts, and 50 more. Their descriptions and schemas cost roughly 23,260 tokens of context every time the server is loaded.
Is the io.github.dachhack/stathead-mcp server still maintained?
io.github.dachhack/stathead-mcp is still listed as active in the MCP registry. We last reached this channel on 5 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.
What licence is the io.github.dachhack/stathead-mcp server under?
io.github.dachhack/stathead-mcp declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.