io.github.avansledright/gridiron-datav1.0.0 GitHub verified
NFL fantasy football data: players, projections, stats, snaps, news, injuries and prop odds.
Maintained by@avansledright(verified)Also a maintainer?
Try it
Call this server's tools from your browser. Nothing to install.
https://api.gridirondata.com/mcp
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
get_byes Read-only
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.
Season year, 2020 or later. Default: the current season.
Install
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http gridiron-data https://api.gridirondata.com/mcp
Tools (21)
get_byesReturns 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.
read-only
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.
| Argument | Type | Description |
|---|---|---|
| season | any | Season year, 2020 or later. Default: the current season. |
Input schema (JSON)
{
"type": "object",
"title": "get_byesArguments",
"properties": {
"season": {
"anyOf": [
{
"type": "string",
"pattern": "^(19|20)\\d{2}$"
},
{
"type": "null"
}
],
"title": "Season",
"default": null,
"examples": [
"2026",
"2025"
],
"description": "Season year, 2020 or later. Default: the current season."
}
}
}get_defense_vs_positionReturns 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 and streaming, optionally over the last N weeks. Pro plan (Free and Basic keys get 403 pro_required).
read-only
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 and streaming, optionally over the last N weeks. Pro plan (Free and Basic keys get 403 pro_required).
| Argument | Type | Description |
|---|---|---|
| last | any | Only the trailing N weeks with games, 1-18. Default: the whole season. |
| team | any | Only this defense. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable. |
| scoring | string | Fantasy scoring: ppr (full PPR, the default), half (half-PPR) or standard. |
| position | any | QB, RB, WR or TE. Default: all four. |
Input schema (JSON)
{
"type": "object",
"title": "get_defense_vs_positionArguments",
"properties": {
"last": {
"anyOf": [
{
"type": "integer",
"maximum": 18,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Last",
"default": null,
"examples": [
4
],
"description": "Only the trailing N weeks with games, 1-18. Default: the whole season."
},
"team": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Team",
"default": null,
"examples": [
"BUF",
"KC",
"PHI"
],
"description": "Only this defense. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable."
},
"scoring": {
"enum": [
"ppr",
"half",
"standard"
],
"type": "string",
"title": "Scoring",
"default": "ppr",
"description": "Fantasy scoring: ppr (full PPR, the default), half (half-PPR) or standard."
},
"position": {
"anyOf": [
{
"enum": [
"QB",
"RB",
"WR",
"TE"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Position",
"default": null,
"description": "QB, RB, WR or TE. Default: all four."
}
}
}get_depth_chartReturns NFL depth charts as of the daily nflverse refresh (as_of): each entry's player, ids, position, formation, slot and rank (1 = starter), for one team or all 32, optionally one position or starters only. Use it for "who starts at QB for X?" or the next man up behind an injured player. Built from public depth charts, not official team depth charts. Pro plan (Free and Basic keys get 403 pro_required).
read-only
get_depth_chart
Returns NFL depth charts as of the daily nflverse refresh (as_of): each entry's player, ids, position, formation, slot and rank (1 = starter), for one team or all 32, optionally one position or starters only. Use it for "who starts at QB for X?" or the next man up behind an injured player. Built from public depth charts, not official team depth charts. Pro plan (Free and Basic keys get 403 pro_required).
| Argument | Type | Description |
|---|---|---|
| team | any | Only this team. Default: all 32. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable. |
| position | any | Depth chart position, e.g. QB, RB, WR, TE, LT, C, PK; K, OT, G and OL also work. |
| starters | boolean | true = starters only (rank 1). With position=QB, every team's starting QB. |
Input schema (JSON)
{
"type": "object",
"title": "get_depth_chartArguments",
"properties": {
"team": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Team",
"default": null,
"examples": [
"BUF",
"KC",
"PHI"
],
"description": "Only this team. Default: all 32. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable."
},
"position": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Position",
"default": null,
"examples": [
"QB",
"RB",
"LT"
],
"description": "Depth chart position, e.g. QB, RB, WR, TE, LT, C, PK; K, OT, G and OL also work."
},
"starters": {
"type": "boolean",
"title": "Starters",
"default": false,
"description": "true = starters only (rank 1). With position=QB, every team's starting QB."
}
}
}get_deviationsReturns 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. Basic plan and above.
read-only
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. Basic plan and above.
| Argument | Type | Description |
|---|---|---|
| season | any | Season year, 2020 or later. Default: the current season. |
| player_id* | string | GridIron player id, "First Last#POS", matched case-insensitively. Defenses are "Team Name#DST". Unsure of the id? Call search_players first. |
Input schema (JSON)
{
"type": "object",
"title": "get_deviationsArguments",
"required": [
"player_id"
],
"properties": {
"season": {
"anyOf": [
{
"type": "string",
"pattern": "^(19|20)\\d{2}$"
},
{
"type": "null"
}
],
"title": "Season",
"default": null,
"examples": [
"2026",
"2025"
],
"description": "Season year, 2020 or later. Default: the current season."
},
"player_id": {
"type": "string",
"title": "Player Id",
"examples": [
"Josh Allen#QB",
"Justin Jefferson#WR",
"Houston Texans#DST"
],
"description": "GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first."
}
}
}get_inactivesReturns 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 pre-kickoff list (teams_published vs teams_played shows how complete the week is). Pro plan (Free and Basic keys get 403 pro_required).
read-only
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 pre-kickoff list (teams_published vs teams_played shows how complete the week is). Pro plan (Free and Basic keys get 403 pro_required).
| Argument | Type | Description |
|---|---|---|
| team | any | Only this team. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable. |
| week | any | Week 1-22 (19+ are playoffs). Default: the newest week with inactives published. |
| season | any | Season year, 2020 or later. Default: the current season. |
Input schema (JSON)
{
"type": "object",
"title": "get_inactivesArguments",
"properties": {
"team": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Team",
"default": null,
"examples": [
"BUF",
"KC",
"PHI"
],
"description": "Only this team. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable."
},
"week": {
"anyOf": [
{
"type": "integer",
"maximum": 22,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Week",
"default": null,
"examples": [
9
],
"description": "Week 1-22 (19+ are playoffs). Default: the newest week with inactives published."
},
"season": {
"anyOf": [
{
"type": "string",
"pattern": "^(19|20)\\d{2}$"
},
{
"type": "null"
}
],
"title": "Season",
"default": null,
"examples": [
"2026",
"2025"
],
"description": "Season year, 2020 or later. Default: the current season."
}
}
}get_injury_changesReturns 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 "who got hurt or cleared today?" and game-day checks; pass next_since back as since to get only newer changes. Pro plan (Free and Basic keys get 403 pro_required).
read-only
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 "who got hurt or cleared today?" and game-day checks; pass next_since back as since to get only newer changes. Pro plan (Free and Basic keys get 403 pro_required).
| Argument | Type | Description |
|---|---|---|
| team | any | Only this team. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable. |
| limit | any | Maximum changes, 1-1000. Default 500. |
| since | any | Only changes after this time: ISO-8601 or unix seconds. Default: 24 hours ago; at most 14 days back. Pass a previous answer's next_since to get only newer changes. |
| position | any | Only this position. |
Input schema (JSON)
{
"type": "object",
"title": "get_injury_changesArguments",
"properties": {
"team": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Team",
"default": null,
"examples": [
"BUF",
"KC",
"PHI"
],
"description": "Only this team. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable."
},
"limit": {
"anyOf": [
{
"type": "integer",
"maximum": 1000,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Limit",
"default": null,
"description": "Maximum changes, 1-1000. Default 500."
},
"since": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Since",
"default": null,
"examples": [
"2026-11-08T16:00:00Z"
],
"description": "Only changes after this time: ISO-8601 or unix seconds. Default: 24 hours ago; at most 14 days back. Pass a previous answer's next_since to get only newer changes."
},
"position": {
"anyOf": [
{
"enum": [
"QB",
"RB",
"WR",
"TE",
"K",
"DST"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Position",
"default": null,
"description": "Only this position."
}
}
}get_latest_newsReturns 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 today/this week" or a team's or position's latest news. Basic plan and above.
read-only
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 today/this week" or a team's or position's latest news. Basic plan and above.
| Argument | Type | Description |
|---|---|---|
| days | any | Lookback when since is omitted, 1-90. Default 7. |
| team | any | Only this team's players. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable. |
| limit | integer | Page size, 1-100. |
| since | any | Only news after this time: ISO-8601 or unix seconds. Default: the last `days` days. Clamped to 90 days. |
| cursor | any | next_cursor from the previous page; omit for the first page. |
| impact | any | Impact tags, comma-separated: injury, transaction, role, general. |
| position | any | Positions, comma-separated (QB, RB, WR, TE, K, DST). |
Input schema (JSON)
{
"type": "object",
"title": "get_latest_newsArguments",
"properties": {
"days": {
"anyOf": [
{
"type": "integer",
"maximum": 90,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Days",
"default": null,
"description": "Lookback when since is omitted, 1-90. Default 7."
},
"team": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Team",
"default": null,
"examples": [
"BUF",
"KC",
"PHI"
],
"description": "Only this team's players. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 25,
"maximum": 100,
"minimum": 1,
"description": "Page size, 1-100."
},
"since": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Since",
"default": null,
"examples": [
"2026-11-08T12:00:00Z"
],
"description": "Only news after this time: ISO-8601 or unix seconds. Default: the last `days` days. Clamped to 90 days."
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Cursor",
"default": null,
"description": "next_cursor from the previous page; omit for the first page."
},
"impact": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Impact",
"default": null,
"examples": [
"injury",
"injury,transaction"
],
"description": "Impact tags, comma-separated: injury, transaction, role, general."
},
"position": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Position",
"default": null,
"examples": [
"RB",
"WR,TE"
],
"description": "Positions, comma-separated (QB, RB, WR, TE, K, DST)."
}
}
}get_matchupsReturns 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.
read-only
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.
| Argument | Type | Description |
|---|---|---|
| opponent* | string | Opponent team code, e.g. KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable. |
| player_id* | string | GridIron player id, "First Last#POS", matched case-insensitively. Defenses are "Team Name#DST". Unsure of the id? Call search_players first. |
Input schema (JSON)
{
"type": "object",
"title": "get_matchupsArguments",
"required": [
"player_id",
"opponent"
],
"properties": {
"opponent": {
"type": "string",
"title": "Opponent",
"examples": [
"BUF",
"KC",
"PHI"
],
"description": "Opponent team code, e.g. KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable."
},
"player_id": {
"type": "string",
"title": "Player Id",
"examples": [
"Josh Allen#QB",
"Justin Jefferson#WR",
"Houston Texans#DST"
],
"description": "GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first."
}
}
}get_playerReturns 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; season data needs Basic).
read-only
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; season data needs Basic).
| Argument | Type | Description |
|---|---|---|
| season | any | Only include this season's data. Default: every season. |
| player_id* | string | GridIron player id, "First Last#POS", matched case-insensitively. Defenses are "Team Name#DST". Unsure of the id? Call search_players first. |
Input schema (JSON)
{
"type": "object",
"title": "get_playerArguments",
"required": [
"player_id"
],
"properties": {
"season": {
"anyOf": [
{
"type": "string",
"pattern": "^(19|20)\\d{2}$"
},
{
"type": "null"
}
],
"title": "Season",
"default": null,
"examples": [
"2026",
"2025"
],
"description": "Only include this season's data. Default: every season."
},
"player_id": {
"type": "string",
"title": "Player Id",
"examples": [
"Josh Allen#QB",
"Justin Jefferson#WR",
"Houston Texans#DST"
],
"description": "GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first."
}
}
}get_player_by_espn_idReturns 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.
read-only
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.
| Argument | Type | Description |
|---|---|---|
| espn_id* | integer | ESPN athlete id (numeric). |
Input schema (JSON)
{
"type": "object",
"title": "get_player_by_espn_idArguments",
"required": [
"espn_id"
],
"properties": {
"espn_id": {
"type": "integer",
"title": "Espn Id",
"examples": [
3918298
],
"description": "ESPN athlete id (numeric)."
}
}
}get_player_by_gsis_idReturns 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 join nflverse or NFL data to GridIron. Free plan.
read-only
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 join nflverse or NFL data to GridIron. Free plan.
| Argument | Type | Description |
|---|---|---|
| gsis_id* | string | NFL GSIS id, the key nflverse and NFL data use. |
Input schema (JSON)
{
"type": "object",
"title": "get_player_by_gsis_idArguments",
"required": [
"gsis_id"
],
"properties": {
"gsis_id": {
"type": "string",
"title": "Gsis Id",
"pattern": "^\\d{2}-\\d{7}$",
"examples": [
"00-0034857"
],
"description": "NFL GSIS id, the key nflverse and NFL data use."
}
}
}get_player_newsReturns 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 get_latest_news. Basic plan and above.
read-only
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 get_latest_news. Basic plan and above.
| Argument | Type | Description |
|---|---|---|
| days | integer | Lookback window in days, 1-90. |
| limit | integer | Maximum headlines, 1-50. |
| impact | any | Only headlines with this impact tag. |
| player_id* | string | GridIron player id, "First Last#POS", matched case-insensitively. Defenses are "Team Name#DST". Unsure of the id? Call search_players first. |
Input schema (JSON)
{
"type": "object",
"title": "get_player_newsArguments",
"required": [
"player_id"
],
"properties": {
"days": {
"type": "integer",
"title": "Days",
"default": 7,
"maximum": 90,
"minimum": 1,
"description": "Lookback window in days, 1-90."
},
"limit": {
"type": "integer",
"title": "Limit",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Maximum headlines, 1-50."
},
"impact": {
"anyOf": [
{
"enum": [
"injury",
"role",
"transaction",
"general"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Impact",
"default": null,
"description": "Only headlines with this impact tag."
},
"player_id": {
"type": "string",
"title": "Player Id",
"examples": [
"Josh Allen#QB",
"Justin Jefferson#WR",
"Houston Texans#DST"
],
"description": "GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first."
}
}
}get_player_statsReturns 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 comparisons with projections. Basic plan and above.
read-only
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 comparisons with projections. Basic plan and above.
| Argument | Type | Description |
|---|---|---|
| season* | string | Season year, 2020 or later. |
| scoring | string | Fantasy scoring: ppr (full PPR, the default), half (half-PPR) or standard. |
| player_id* | string | GridIron player id, "First Last#POS", matched case-insensitively. Defenses are "Team Name#DST". Unsure of the id? Call search_players first. |
Input schema (JSON)
{
"type": "object",
"title": "get_player_statsArguments",
"required": [
"player_id",
"season"
],
"properties": {
"season": {
"type": "string",
"title": "Season",
"pattern": "^(19|20)\\d{2}$",
"examples": [
"2026",
"2025"
],
"description": "Season year, 2020 or later."
},
"scoring": {
"enum": [
"ppr",
"half",
"standard"
],
"type": "string",
"title": "Scoring",
"default": "ppr",
"description": "Fantasy scoring: ppr (full PPR, the default), half (half-PPR) or standard."
},
"player_id": {
"type": "string",
"title": "Player Id",
"examples": [
"Josh Allen#QB",
"Justin Jefferson#WR",
"Houston Texans#DST"
],
"description": "GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first."
}
}
}get_projectionsReturns 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 gridiron_projection, GridIron Data's own model (with model_version and as_of; null when none), which unlike projected_points may be displayed under Pro + Commercial. Players who can't play project 0 with available=false. Free plan: the current week of the current season; other weeks and seasons need Basic; Pro adds projected_stats per row (pass_yds, rec, rush_yds, ...).
read-only
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 gridiron_projection, GridIron Data's own model (with model_version and as_of; null when none), which unlike projected_points may be displayed under Pro + Commercial. Players who can't play project 0 with available=false. Free plan: the current week of the current season; other weeks and seasons need Basic; Pro adds projected_stats per row (pass_yds, rec, rush_yds, ...).
| Argument | Type | Description |
|---|---|---|
| team | any | Only this team's players. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable. |
| week* | integer | NFL regular-season week, 1-18. |
| season | any | Season year, 2020 or later. Default: the current season. |
| scoring | string | Fantasy scoring: ppr (full PPR, the default), half (half-PPR) or standard. |
| position | any | Only this position. |
| weekly_only | boolean | true = only real weekly projections, without the season-prorated fallback used for weeks not yet published. |
| gridiron_only | boolean | true = only GridIron Data's own model projections (gridiron_projection). |
Input schema (JSON)
{
"type": "object",
"title": "get_projectionsArguments",
"required": [
"week"
],
"properties": {
"team": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Team",
"default": null,
"examples": [
"BUF",
"KC",
"PHI"
],
"description": "Only this team's players. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable."
},
"week": {
"type": "integer",
"title": "Week",
"maximum": 18,
"minimum": 1,
"examples": [
10
],
"description": "NFL regular-season week, 1-18."
},
"season": {
"anyOf": [
{
"type": "string",
"pattern": "^(19|20)\\d{2}$"
},
{
"type": "null"
}
],
"title": "Season",
"default": null,
"examples": [
"2026",
"2025"
],
"description": "Season year, 2020 or later. Default: the current season."
},
"scoring": {
"enum": [
"ppr",
"half",
"standard"
],
"type": "string",
"title": "Scoring",
"default": "ppr",
"description": "Fantasy scoring: ppr (full PPR, the default), half (half-PPR) or standard."
},
"position": {
"anyOf": [
{
"enum": [
"QB",
"RB",
"WR",
"TE",
"K",
"DST"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Position",
"default": null,
"description": "Only this position."
},
"weekly_only": {
"type": "boolean",
"title": "Weekly Only",
"default": false,
"description": "true = only real weekly projections, without the season-prorated fallback used for weeks not yet published."
},
"gridiron_only": {
"type": "boolean",
"title": "Gridiron Only",
"default": false,
"description": "true = only GridIron Data's own model projections (gridiron_projection)."
}
}
}get_prop_probabilityReturns 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, the week's game and betting line, and the model's backtest. Use it to price a player prop or compare a sportsbook line with a fair price. Players on bye or OUT/IR get p_over 0. Model estimate, not betting advice. Pro plan (Free and Basic keys get 403 pro_required).
read-only
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, the week's game and betting line, and the model's backtest. Use it to price a player prop or compare a sportsbook line with a fair price. Players on bye or OUT/IR get p_over 0. Model estimate, not betting advice. Pro plan (Free and Basic keys get 403 pro_required).
| Argument | Type | Description |
|---|---|---|
| line* | string | The line to price, or up to 10 comma-separated lines. |
| stat* | string | The stat the line is on. |
| week | any | NFL week, 1-18. Default: the current week, or the next one if the player's game this week is already final. |
| espn_id | any | ESPN athlete id, instead of player_id. |
| player_id | any | The player (give this or espn_id). GridIron player id, "First Last#POS", matched case-insensitively. Defenses are "Team Name#DST". Unsure of the id? Call search_players first. |
Input schema (JSON)
{
"type": "object",
"title": "get_prop_probabilityArguments",
"required": [
"stat",
"line"
],
"properties": {
"line": {
"type": "string",
"title": "Line",
"examples": [
"245.5",
"64.5,69.5,74.5"
],
"description": "The line to price, or up to 10 comma-separated lines."
},
"stat": {
"enum": [
"pass_yds",
"pass_td",
"pass_att",
"pass_cmp",
"pass_int",
"rush_yds",
"rush_att",
"rush_td",
"rec",
"rec_yds",
"rec_td"
],
"type": "string",
"title": "Stat",
"description": "The stat the line is on."
},
"week": {
"anyOf": [
{
"type": "integer",
"maximum": 18,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Week",
"default": null,
"examples": [
10
],
"description": "NFL week, 1-18. Default: the current week, or the next one if the player's game this week is already final."
},
"espn_id": {
"anyOf": [
{
"type": "integer"
},
{
"type": "null"
}
],
"title": "Espn Id",
"default": null,
"examples": [
4431452
],
"description": "ESPN athlete id, instead of player_id."
},
"player_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Player Id",
"default": null,
"examples": [
"Josh Allen#QB",
"Justin Jefferson#WR",
"Houston Texans#DST"
],
"description": "The player (give this or espn_id). GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first."
}
}
}get_ros_projectionsReturns 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 decisions. Filter by position, team or one player. Basic plan and above.
read-only
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 decisions. Filter by position, team or one player. Basic plan and above.
| Argument | Type | Description |
|---|---|---|
| team | any | Only this team's players. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable. |
| scoring | string | Fantasy scoring: ppr (full PPR, the default), half (half-PPR) or standard. |
| position | any | Only this position. |
| player_id | any | Only this player. GridIron player id, "First Last#POS", matched case-insensitively. Defenses are "Team Name#DST". Unsure of the id? Call search_players first. |
Input schema (JSON)
{
"type": "object",
"title": "get_ros_projectionsArguments",
"properties": {
"team": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Team",
"default": null,
"examples": [
"BUF",
"KC",
"PHI"
],
"description": "Only this team's players. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable."
},
"scoring": {
"enum": [
"ppr",
"half",
"standard"
],
"type": "string",
"title": "Scoring",
"default": "ppr",
"description": "Fantasy scoring: ppr (full PPR, the default), half (half-PPR) or standard."
},
"position": {
"anyOf": [
{
"enum": [
"QB",
"RB",
"WR",
"TE",
"K",
"DST"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Position",
"default": null,
"description": "Only this position."
},
"player_id": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Player Id",
"default": null,
"examples": [
"Josh Allen#QB",
"Justin Jefferson#WR",
"Houston Texans#DST"
],
"description": "Only this player. GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first."
}
}
}get_scheduleReturns 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. Basic plan and above; Pro keys also get each game's betting line (spread_home, over_under, moneylines, implied team points).
read-only
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. Basic plan and above; Pro keys also get each game's betting line (spread_home, over_under, moneylines, implied team points).
| Argument | Type | Description |
|---|---|---|
| team | any | Only this team's games (also returns its bye week). Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable. |
| week | any | Only this week, 1-18. Default: the whole season. |
| season | any | Season year, 2020 or later. Default: the current season. |
Input schema (JSON)
{
"type": "object",
"title": "get_scheduleArguments",
"properties": {
"team": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Team",
"default": null,
"examples": [
"BUF",
"KC",
"PHI"
],
"description": "Only this team's games (also returns its bye week). Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable."
},
"week": {
"anyOf": [
{
"type": "integer",
"maximum": 18,
"minimum": 1
},
{
"type": "null"
}
],
"title": "Week",
"default": null,
"examples": [
10
],
"description": "Only this week, 1-18. Default: the whole season."
},
"season": {
"anyOf": [
{
"type": "string",
"pattern": "^(19|20)\\d{2}$"
},
{
"type": "null"
}
],
"title": "Season",
"default": null,
"examples": [
"2026",
"2025"
],
"description": "Season year, 2020 or later. Default: the current season."
}
}
}get_snap_shareReturns 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 the box score (a committee back taking over, a rookie WR passing a veteran). Seasons 2020-2026, current season updated weekly. Basic plan and above.
read-only
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 the box score (a committee back taking over, a rookie WR passing a veteran). Seasons 2020-2026, current season updated weekly. Basic plan and above.
| Argument | Type | Description |
|---|---|---|
| trend | integer | Weeks in the trailing average compared with the season, 1-18. |
| season | any | Season year, 2020 or later. Default: the current season. |
| player_id* | string | GridIron player id, "First Last#POS", matched case-insensitively. Defenses are "Team Name#DST". Unsure of the id? Call search_players first. |
Input schema (JSON)
{
"type": "object",
"title": "get_snap_shareArguments",
"required": [
"player_id"
],
"properties": {
"trend": {
"type": "integer",
"title": "Trend",
"default": 4,
"maximum": 18,
"minimum": 1,
"description": "Weeks in the trailing average compared with the season, 1-18."
},
"season": {
"anyOf": [
{
"type": "string",
"pattern": "^(19|20)\\d{2}$"
},
{
"type": "null"
}
],
"title": "Season",
"default": null,
"examples": [
"2026",
"2025"
],
"description": "Season year, 2020 or later. Default: the current season."
},
"player_id": {
"type": "string",
"title": "Player Id",
"examples": [
"Josh Allen#QB",
"Justin Jefferson#WR",
"Houston Texans#DST"
],
"description": "GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first."
}
}
}list_playersReturns 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.
read-only
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.
| Argument | Type | Description |
|---|---|---|
| limit | integer | Players per page, 1-100. |
| cursor | any | next_cursor from the previous page; omit for the first page. |
| position | any | Only this position. Pro keys can also list offensive linemen with C, G or OT. |
Input schema (JSON)
{
"type": "object",
"title": "list_playersArguments",
"properties": {
"limit": {
"type": "integer",
"title": "Limit",
"default": 50,
"maximum": 100,
"minimum": 1,
"description": "Players per page, 1-100."
},
"cursor": {
"anyOf": [
{
"type": "string"
},
{
"type": "null"
}
],
"title": "Cursor",
"default": null,
"description": "next_cursor from the previous page; omit for the first page."
},
"position": {
"anyOf": [
{
"enum": [
"QB",
"RB",
"WR",
"TE",
"K",
"DST",
"C",
"G",
"OT"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Position",
"default": null,
"description": "Only this position. Pro keys can also list offensive linemen with C, G or OT."
}
}
}request_news_scrapeQueues 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 plan and above.
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 plan and above.
| Argument | Type | Description |
|---|---|---|
| player_id* | string | GridIron player id, "First Last#POS", matched case-insensitively. Defenses are "Team Name#DST". Unsure of the id? Call search_players first. |
Input schema (JSON)
{
"type": "object",
"title": "request_news_scrapeArguments",
"required": [
"player_id"
],
"properties": {
"player_id": {
"type": "string",
"title": "Player Id",
"examples": [
"Josh Allen#QB",
"Justin Jefferson#WR",
"Houston Texans#DST"
],
"description": "GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first."
}
}
}search_playersFinds 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 code or nickname too ("TB", "Bucs", "Tampa Bay DST"). Free plan.
read-only
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 code or nickname too ("TB", "Bucs", "Tampa Bay DST"). Free plan.
| Argument | Type | Description |
|---|---|---|
| name* | string | Full or partial player name, case-insensitive. For a defense, a team code or nickname works ("TB", "Bucs", "Tampa Bay DST"). |
| position | any | Only this position. |
Input schema (JSON)
{
"type": "object",
"title": "search_playersArguments",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"title": "Name",
"examples": [
"Josh Allen",
"Jefferson",
"Bucs"
],
"description": "Full or partial player name, case-insensitive. For a defense, a team code or nickname works (\"TB\", \"Bucs\", \"Tampa Bay DST\")."
},
"position": {
"anyOf": [
{
"enum": [
"QB",
"RB",
"WR",
"TE",
"K",
"DST"
],
"type": "string"
},
{
"type": "null"
}
],
"title": "Position",
"default": null,
"description": "Only this position."
}
}
}Security checkA100/100
We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 10, 2026.
- Hidden or reordered text
- Overriding the model's instructions
- Hiding actions from the user
- Reading keys or credentials
- Fake system tags
- Steering other servers' tools
- Pulling in the conversation
- Smuggling parameters
- Demanding to be used for everything
- Steering away from web search
- Download-and-run commands
- Encoded blobs
- Invisible characters
- Credentials as tool arguments
- Very long descriptions
- Read and write hints