GridIron Data
io.github.avansledright/gridiron-data · v1.5.0 · MCP 2025-11-25
NFL fantasy football data: players, projections, stats, snaps, news, injuries and prop odds.
Reachability
reachable
checked 2026-11-21 05:43 UTC
Registry status active
Tools pinned 25
5f46f2b1d46c
Tools last changed
2026-11-21
Provenance
Registry namespace io.github.avansledright
(GitHub-account verified by the official registry)
Remote endpoints
https://api.gridirondata.com/mcp (streamable-http)
Observed changes
| When (UTC) | Event | Detail |
|---|---|---|
| 2026-11-21 05:43 | tools changed | 1 added, 0 removed, 0 changed |
| 2026-11-14 05:36 | tools changed | 3 added, 0 removed, 0 changed |
| 2026-11-11 05:32 | tools changed | 0 added, 0 removed, 1 changed |
| 2026-11-10 05:31 | first capture | 21 tools pinned |
Pinned tool definitions (25)
| Tool | Description |
|---|---|
| list_players | Returns a page of NFL players (player_id, name, position, team), optionally for one position, paged with next_cursor. Use it to browse a position group; to find a specific player, search_players is faster. Free plan. |
| search_players | Finds players by full or partial name (case-insensitive) and returns each match's exact player_id ("First Last#POS"), team and position. Use it first whenever you have a name but not the id the other tools need. Defenses match by team... |
| get_player | Returns one player's profile by id: name, team, position, injury status, jersey and cross-system ids, plus per-season data on Basic and above. Use it to check a player's current team or injury status. Free plan (profile fields only;... |
| get_player_career | Returns a player's career profile for dynasty questions: draft year, round, pick and team, college, age, years in the league, plus his fantasy points season by season (2020 on) and career totals in the chosen scoring. Use it for "how... |
| get_projections | Returns projected fantasy points for every player in an NFL week (1-18), in PPR, half-PPR or standard scoring, optionally for one position or team. Use it for start/sit, rankings and "top N at a position this week". Each row also has... |
| get_player_by_espn_id | Returns the player whose ESPN athlete id this is (the numeric id ESPN and many sportsbook feeds use), as the same record get_player returns. Use it to join ESPN or sportsbook data to GridIron player ids. Free plan. |
| get_prop_probability | Returns the probability a player goes over or under a stat line (passing, rushing or receiving yards, TDs, attempts, completions, interceptions, receptions), with fair no-vig American odds for each side, the projected mean and spread,... |
| get_defense_vs_position | Returns what each NFL defense allows per game to QBs, RBs, WRs or TEs: fantasy points plus yards, TDs, receptions and targets, from ESPN box scores, ranked so rank 1 allows the most (the best matchup). Use it for matchup-based start/sit... |
| get_player_stats | Returns a player's actual stats for one season (2020 to now): fantasy points week by week and in total in the chosen scoring, plus the raw stat line and snap share each week. Use it for "how did X do" questions, game logs and... |
| get_deviations | Returns how a player's actual fantasy points compared with his projections: the average deviation and each week's projected vs actual. Use it to judge boom/bust tendencies or whether a player keeps beating (or missing) his projection.... |
| get_snap_share | Returns a player's offensive snap share each week (the % of his team's offensive plays he was on the field for), the season average, and a trailing average with its change vs the season. Use it to spot role changes before they show in... |
| get_matchups | Returns a player's past games and fantasy points against one opponent. Use it for matchup questions like "how does he do against KC?". Basic plan and above. |
| get_player_news | Returns recent news headlines for one player, newest first, each tagged by impact (injury, role, transaction or general). Use it for "any news on X?" and injury or role questions about a specific player; for the whole league use... |
| request_news_scrape | Queues an on-demand news pull for a player who has no news coverage yet and returns at once (202); the headlines appear in get_player_news shortly after. Use it only when get_player_news comes back empty. Asking twice is harmless. Basic... |
| get_latest_news | Returns the league-wide NFL news feed across every tracked player, newest first: signings, trades, cuts, injuries and depth-chart moves, filterable by time, impact, position and team, paged with next_cursor. Use it for "what happened... |
| get_ros_projections | Returns each player's projected fantasy points for the rest of the current season (weeks already played and his bye are skipped), with games_remaining and points_per_game. Use it for trades, waiver pickups and dynasty or keeper... |
| get_schedule | Returns the NFL regular-season schedule: week, home and away teams, kickoff time (UTC), status and final score, for a season, one week or one team (with that team's bye week). Use it for "who plays whom", kickoff times and results.... |
| get_byes | Returns every team's bye week for a season, and the teams on bye each week. Use it to plan lineups and spot bye-week holes on a roster. Basic plan and above. |
| get_injury_changes | Returns players whose injury status changed since a time (default the last 24 hours, up to 14 days back), with previous_status, status and detected_at. Statuses are checked against ESPN every 2 minutes from 8am to 1am ET. Use it for... |
| get_player_by_gsis_id | Returns the player with this NFL GSIS id (e.g. "00-0034857", the key nflverse and NFL data use), as the same record get_player returns, with an ids map (gsis, pfr, pff, nfl, espn, sleeper) from the daily nflverse crosswalk. Use it to... |
| get_depth_chart | Returns NFL depth charts as of the daily nflverse refresh (as_of), for one team or all 32, optionally one position or group (CB, LB, EDGE, ...) or starters only. Each entry has the player, ids, position, formation, slot, depth within... |
| get_inactives | Returns the NFL's official game-day inactives for a week (default the newest week published), by team, with gsis, espn, sleeper and pfr ids. Published after the games, usually days later. Use it for audits and backtesting, not as a... |
| get_coverage_splits | Returns how a receiver does against man vs zone coverage and against each coverage shell (Cover 1, 2, 3, 4, ...): targets, catch rate, yards and EPA per target, and his share of targets in each. Coverage splits are the 2025 season... |
| get_defense_coverage | Returns what coverage a defense plays: its man vs zone rate, coverage shell mix, blitz and pressure rate, and what it allowed against man and zone, from the 2025 season (nflverse has no 2026 coverage file yet), plus its 2026... |
| get_coverage_matchup | Returns a receiver's man vs zone splits (2025 season) and blitz splits (2026 season to date) next to this week's opponent's coverage tendencies (man/zone mix, shells, what it allows) and 2026 blitz rate, with a one-line plain read. Use... |
Get alerted when this changes.
Email the moment io.github.avansledright/gridiron-data drifts, dies, or revives.
Status badge
[](https://toolpin.dev/servers/io.github.avansledright/gridiron-data)
Maintain this server? Add the badge to your README. It links your users to this live status page.