GridIron Data

NFL fantasy football data: players, projections, stats, snaps, news, injuries and prop odds.

使うべきか

品質と安全性

A
説明の品質
95%
スキーマの完全性
87%
命名の品質
99%
ポイズニングのリスク
100%
権限の一致
100%
プロトコルへの準拠
100%

検出事項(1)

  • LOWTool 'get_byes' description lacks action verbget_byes 内

ツール定義とプロトコルへの準拠に関する自動分析に基づいています。

コンテキストコスト

~12,978トークン数(ツール定義)
~5.1 KB一般的なレスポンスサイズ
注意への影響は大きい(128k コンテキストの 10.14%)

これは、サーバーのツールがモデルのコンテキストに読み込まれるたびに消費されるおおよそのトークン数です。数が多いほど、ほかのタスクに使える注意が減ります。

インストール

ワンクリックインストール

これを `claude_desktop_config.json` ファイルに追加してください:

{
  "mcpServers": {
    "gridiron-data": {
      "url": "https://api.gridirondata.com/mcp"
    }
  }
}

リモートエンドポイント

https://api.gridirondata.com/mcpstreamable-http

できること

ツール一覧

ツール(24)

🟢 読み取り専用🟡 書き込み🔴 削除⚪ 不明
🟢list_players(position, limit, cursor)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "position": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "QB",
            "RB",
            "WR",
            "TE",
            "K",
            "DST",
            "C",
            "G",
            "OT"
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Position",
      "description": "Only this position. Pro keys can also list offensive linemen with C, G or OT.",
      "default": null
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "title": "Limit",
      "description": "Players per page, 1-100.",
      "default": 50
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cursor",
      "description": "next_cursor from the previous page; omit for the first page.",
      "default": null
    }
  },
  "title": "list_playersArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "players": {
      "description": "One page of players with their player_id, name, position and team."
    },
    "count": {
      "description": "Players on this page."
    },
    "next_cursor": {
      "description": "Pass back as cursor for the next page; absent on the last page."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "list_playersResult",
  "additionalProperties": true
}
🟢search_players(name, position)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "name": {
      "type": "string",
      "title": "Name",
      "description": "Full or partial player name, case-insensitive. For a defense, a team code or nickname works (\"TB\", \"Bucs\", \"Tampa Bay DST\").",
      "examples": [
        "Josh Allen",
        "Jefferson",
        "Bucs"
      ]
    },
    "position": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "QB",
            "RB",
            "WR",
            "TE",
            "K",
            "DST"
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Position",
      "description": "Only this position.",
      "default": null
    }
  },
  "required": [
    "name"
  ],
  "title": "search_playersArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "players": {
      "description": "Matching players, each with its exact player_id."
    },
    "count": {
      "description": "Number of matches."
    },
    "next_cursor": {
      "description": "Pass back as cursor for more matches; absent on the last page."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "search_playersResult",
  "additionalProperties": true
}
🟢get_player(player_id, season)

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).

入力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "type": "string",
      "title": "Player Id",
      "description": "GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first.",
      "examples": [
        "Josh Allen#QB",
        "Justin Jefferson#WR",
        "Houston Texans#DST"
      ]
    },
    "season": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^(19|20)\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "title": "Season",
      "description": "Only include this season's data. Default: every season.",
      "examples": [
        "2026",
        "2025"
      ],
      "default": null
    }
  },
  "required": [
    "player_id"
  ],
  "title": "get_playerArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "description": "GridIron player id (\"First Last#POS\")."
    },
    "player_name": {
      "description": "Player name."
    },
    "position": {
      "description": "Position."
    },
    "team": {
      "description": "Current team code."
    },
    "espn_player_id": {
      "description": "ESPN athlete id."
    },
    "updated_at": {
      "description": "When the record last changed."
    },
    "seasons": {
      "description": "Season year -> that season's data (Basic and above)."
    },
    "vs_opponent": {
      "description": "Team code -> career matchup history (Basic and above)."
    },
    "ids": {
      "description": "Other systems' ids (gsis, pfr, pff, nfl, espn, sleeper) from the nflverse crosswalk."
    },
    "free_plan": {
      "description": "Present on free keys: what the free plan includes."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "get_playerResult",
  "additionalProperties": true
}
🟢get_projections(week, position, scoring, season, weekly_only, ...)

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, ...).

入力スキーマ

{
  "type": "object",
  "properties": {
    "week": {
      "type": "integer",
      "minimum": 1,
      "maximum": 18,
      "title": "Week",
      "description": "NFL regular-season week, 1-18.",
      "examples": [
        10
      ]
    },
    "position": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "QB",
            "RB",
            "WR",
            "TE",
            "K",
            "DST"
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Position",
      "description": "Only this position.",
      "default": null
    },
    "scoring": {
      "type": "string",
      "enum": [
        "ppr",
        "half",
        "standard"
      ],
      "title": "Scoring",
      "description": "Fantasy scoring: ppr (full PPR, the default), half (half-PPR) or standard.",
      "default": "ppr"
    },
    "season": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^(19|20)\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "title": "Season",
      "description": "Season year, 2020 or later. Default: the current season.",
      "examples": [
        "2026",
        "2025"
      ],
      "default": null
    },
    "weekly_only": {
      "type": "boolean",
      "title": "Weekly Only",
      "description": "true = only real weekly projections, without the season-prorated fallback used for weeks not yet published.",
      "default": false
    },
    "team": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Team",
      "description": "Only this team's players. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable.",
      "examples": [
        "BUF",
        "KC",
        "PHI"
      ],
      "default": null
    },
    "gridiron_only": {
      "type": "boolean",
      "title": "Gridiron Only",
      "description": "true = only GridIron Data's own model projections (gridiron_projection).",
      "default": false
    }
  },
  "required": [
    "week"
  ],
  "title": "get_projectionsArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "week": {
      "description": "The NFL week."
    },
    "season": {
      "description": "The season."
    },
    "scoring": {
      "description": "Scoring used."
    },
    "team": {
      "description": "Present when filtered by team."
    },
    "projections": {
      "description": "One row per player: projected_points, player_id, team, injury status, available, gridiron_projection, and projected_stats on Pro."
    },
    "count": {
      "description": "Rows returned."
    },
    "prorated_count": {
      "description": "Rows that use the season-prorated fallback."
    },
    "unavailable_count": {
      "description": "Players who can't play (OUT, IR, bye) and project 0."
    },
    "projected_stats": {
      "description": "Below Pro only: a note that per-stat projections need Pro."
    },
    "source": {
      "description": "Present when only GridIron's own projections were asked for."
    },
    "gridiron_projections": {
      "description": "The week's GridIron projection run (model_version, as_of), or null."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "get_projectionsResult",
  "additionalProperties": true
}
🟢get_player_by_espn_id(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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "espn_id": {
      "type": "integer",
      "title": "Espn Id",
      "description": "ESPN athlete id (numeric).",
      "examples": [
        3918298
      ]
    }
  },
  "required": [
    "espn_id"
  ],
  "title": "get_player_by_espn_idArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "description": "GridIron player id (\"First Last#POS\")."
    },
    "player_name": {
      "description": "Player name."
    },
    "position": {
      "description": "Position."
    },
    "team": {
      "description": "Current team code."
    },
    "espn_player_id": {
      "description": "ESPN athlete id."
    },
    "ids": {
      "description": "Other systems' ids from the nflverse crosswalk."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "get_player_by_espn_idResult",
  "additionalProperties": true
}
🟢get_prop_probability(stat, line, player_id, espn_id, week)

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).

入力スキーマ

{
  "type": "object",
  "properties": {
    "stat": {
      "type": "string",
      "enum": [
        "pass_yds",
        "pass_td",
        "pass_att",
        "pass_cmp",
        "pass_int",
        "rush_yds",
        "rush_att",
        "rush_td",
        "rec",
        "rec_yds",
        "rec_td"
      ],
      "title": "Stat",
      "description": "The stat the line is on."
    },
    "line": {
      "type": "string",
      "title": "Line",
      "description": "The line to price, or up to 10 comma-separated lines.",
      "examples": [
        "245.5",
        "64.5,69.5,74.5"
      ]
    },
    "player_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Player Id",
      "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.",
      "examples": [
        "Josh Allen#QB",
        "Justin Jefferson#WR",
        "Houston Texans#DST"
      ],
      "default": null
    },
    "espn_id": {
      "anyOf": [
        {
          "type": "integer"
        },
        {
          "type": "null"
        }
      ],
      "title": "Espn Id",
      "description": "ESPN athlete id, instead of player_id.",
      "examples": [
        4431452
      ],
      "default": null
    },
    "week": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1,
          "maximum": 18
        },
        {
          "type": "null"
        }
      ],
      "title": "Week",
      "description": "NFL week, 1-18. Default: the current week, or the next one if the player's game this week is already final.",
      "examples": [
        10
      ],
      "default": null
    }
  },
  "required": [
    "stat",
    "line"
  ],
  "title": "get_prop_probabilityArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "description": "GridIron player id (\"First Last#POS\")."
    },
    "player_name": {
      "description": "Player name."
    },
    "position": {
      "description": "Position."
    },
    "team": {
      "description": "Current team code."
    },
    "espn_player_id": {
      "description": "ESPN athlete id."
    },
    "season": {
      "description": "Season."
    },
    "week": {
      "description": "Week priced."
    },
    "stat": {
      "description": "The stat."
    },
    "injury_status": {
      "description": "Standardized injury status."
    },
    "injury_status_raw": {
      "description": "Status as the source spelled it."
    },
    "available": {
      "description": "false on a bye or when unavailable; every p_over is then 0."
    },
    "unavailable_reason": {
      "description": "Why the player is unavailable, when he is."
    },
    "game": {
      "description": "The week's game, with the betting line."
    },
    "projection": {
      "description": "Projected mean and standard deviation for the stat."
    },
    "lines": {
      "description": "Per line: the over/under probabilities and fair no-vig American odds."
    },
    "model": {
      "description": "Method, fitted dispersion and the walk-forward backtest (Brier score, calibration)."
    },
    "disclaimer": {
      "description": "Model estimate, not betting advice."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "get_prop_probabilityResult",
  "additionalProperties": true
}
🟢get_defense_vs_position(position, last, team, scoring)

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).

入力スキーマ

{
  "type": "object",
  "properties": {
    "position": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "QB",
            "RB",
            "WR",
            "TE"
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Position",
      "description": "QB, RB, WR or TE. Default: all four.",
      "default": null
    },
    "last": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1,
          "maximum": 18
        },
        {
          "type": "null"
        }
      ],
      "title": "Last",
      "description": "Only the trailing N weeks with games, 1-18. Default: the whole season.",
      "examples": [
        4
      ],
      "default": null
    },
    "team": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Team",
      "description": "Only this defense. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable.",
      "examples": [
        "BUF",
        "KC",
        "PHI"
      ],
      "default": null
    },
    "scoring": {
      "type": "string",
      "enum": [
        "ppr",
        "half",
        "standard"
      ],
      "title": "Scoring",
      "description": "Fantasy scoring: ppr (full PPR, the default), half (half-PPR) or standard.",
      "default": "ppr"
    }
  },
  "title": "get_defense_vs_positionArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "season": {
      "description": "Season."
    },
    "scoring": {
      "description": "Scoring used."
    },
    "weeks": {
      "description": "Weeks included."
    },
    "position": {
      "description": "Position asked for."
    },
    "defenses": {
      "description": "Per defense: fantasy points, yards, TDs, receptions and targets allowed per game, and rank."
    },
    "by_position": {
      "description": "Without position: QB, RB, WR and TE lists."
    },
    "rank_meaning": {
      "description": "rank 1 = allows the most (the best matchup)."
    },
    "source": {
      "description": "Data source."
    },
    "updated_at": {
      "description": "When the data was last loaded."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "get_defense_vs_positionResult",
  "additionalProperties": true
}
🟢get_player_stats(player_id, season, scoring)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "type": "string",
      "title": "Player Id",
      "description": "GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first.",
      "examples": [
        "Josh Allen#QB",
        "Justin Jefferson#WR",
        "Houston Texans#DST"
      ]
    },
    "season": {
      "type": "string",
      "pattern": "^(19|20)\\d{2}$",
      "title": "Season",
      "description": "Season year, 2020 or later.",
      "examples": [
        "2026",
        "2025"
      ]
    },
    "scoring": {
      "type": "string",
      "enum": [
        "ppr",
        "half",
        "standard"
      ],
      "title": "Scoring",
      "description": "Fantasy scoring: ppr (full PPR, the default), half (half-PPR) or standard.",
      "default": "ppr"
    }
  },
  "required": [
    "player_id",
    "season"
  ],
  "title": "get_player_statsArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "description": "GridIron player id (\"First Last#POS\")."
    },
    "player_name": {
      "description": "Player name."
    },
    "position": {
      "description": "Position."
    },
    "team": {
      "description": "Current team code."
    },
    "season": {
      "description": "Season."
    },
    "scoring": {
      "description": "Scoring used."
    },
    "season_points": {
      "description": "Total fantasy points for the season."
    },
    "weekly_stats": {
      "description": "Week -> that week's stat line, points and snap share (box score from 2025)."
    },
    "season_totals": {
      "description": "Season stat totals."
    },
    "snap_counts": {
      "description": "Snap counts."
    },
    "injury_status": {
      "description": "Current injury status."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "get_player_statsResult",
  "additionalProperties": true
}
🟢get_deviations(player_id, season)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "type": "string",
      "title": "Player Id",
      "description": "GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first.",
      "examples": [
        "Josh Allen#QB",
        "Justin Jefferson#WR",
        "Houston Texans#DST"
      ]
    },
    "season": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^(19|20)\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "title": "Season",
      "description": "Season year, 2020 or later. Default: the current season.",
      "examples": [
        "2026",
        "2025"
      ],
      "default": null
    }
  },
  "required": [
    "player_id"
  ],
  "title": "get_deviationsArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "description": "GridIron player id."
    },
    "player_name": {
      "description": "Player name."
    },
    "position": {
      "description": "Position."
    },
    "season": {
      "description": "Season."
    },
    "avg_deviation": {
      "description": "Average actual minus projected points."
    },
    "weeks_analyzed": {
      "description": "Weeks compared."
    },
    "weekly_deviations": {
      "description": "Per week: actual vs projected points."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "get_deviationsResult",
  "additionalProperties": true
}
🟢get_snap_share(player_id, season, trend)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "type": "string",
      "title": "Player Id",
      "description": "GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first.",
      "examples": [
        "Josh Allen#QB",
        "Justin Jefferson#WR",
        "Houston Texans#DST"
      ]
    },
    "season": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^(19|20)\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "title": "Season",
      "description": "Season year, 2020 or later. Default: the current season.",
      "examples": [
        "2026",
        "2025"
      ],
      "default": null
    },
    "trend": {
      "type": "integer",
      "minimum": 1,
      "maximum": 18,
      "title": "Trend",
      "description": "Weeks in the trailing average compared with the season, 1-18.",
      "default": 4
    }
  },
  "required": [
    "player_id"
  ],
  "title": "get_snap_shareArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "description": "GridIron player id (\"First Last#POS\")."
    },
    "player_name": {
      "description": "Player name."
    },
    "position": {
      "description": "Position."
    },
    "team": {
      "description": "Current team code."
    },
    "season": {
      "description": "Season."
    },
    "games": {
      "description": "Games on the schedule so far."
    },
    "games_with_snaps": {
      "description": "Games he played offensive snaps in."
    },
    "season_snap_pct_avg": {
      "description": "Season average snap share (0-100)."
    },
    "recent_snap_pct_avg": {
      "description": "Average over the trailing trend weeks."
    },
    "trend_weeks": {
      "description": "Weeks in the trailing average."
    },
    "trend_delta": {
      "description": "Recent average minus season average (positive = growing role)."
    },
    "totals": {
      "description": "Season snap totals."
    },
    "weekly_snaps": {
      "description": "Per week: snaps and snap share."
    },
    "source": {
      "description": "Data source."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "get_snap_shareResult",
  "additionalProperties": true
}
🟢get_matchups(player_id, opponent)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "type": "string",
      "title": "Player Id",
      "description": "GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first.",
      "examples": [
        "Josh Allen#QB",
        "Justin Jefferson#WR",
        "Houston Texans#DST"
      ]
    },
    "opponent": {
      "type": "string",
      "title": "Opponent",
      "description": "Opponent team code, e.g. KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable.",
      "examples": [
        "BUF",
        "KC",
        "PHI"
      ]
    }
  },
  "required": [
    "player_id",
    "opponent"
  ],
  "title": "get_matchupsArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "description": "GridIron player id (\"First Last#POS\")."
    },
    "player_name": {
      "description": "Player name."
    },
    "position": {
      "description": "Position."
    },
    "team": {
      "description": "Current team code."
    },
    "opponent": {
      "description": "Opponent team code."
    },
    "stats": {
      "description": "His games and fantasy points against that opponent."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "get_matchupsResult",
  "additionalProperties": true
}
🟢get_player_news(player_id, days, limit, impact)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "type": "string",
      "title": "Player Id",
      "description": "GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first.",
      "examples": [
        "Josh Allen#QB",
        "Justin Jefferson#WR",
        "Houston Texans#DST"
      ]
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 90,
      "title": "Days",
      "description": "Lookback window in days, 1-90.",
      "default": 7
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "title": "Limit",
      "description": "Maximum headlines, 1-50.",
      "default": 10
    },
    "impact": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "injury",
            "role",
            "transaction",
            "general"
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Impact",
      "description": "Only headlines with this impact tag.",
      "default": null
    }
  },
  "required": [
    "player_id"
  ],
  "title": "get_player_newsArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "description": "GridIron player id."
    },
    "days": {
      "description": "Lookback window used."
    },
    "count": {
      "description": "Headlines returned."
    },
    "news": {
      "description": "Headlines, newest first, each tagged by impact."
    },
    "message": {
      "description": "Present when there is no news."
    },
    "request_scrape": {
      "description": "Present when there is no news: request_news_scrape queues a fresh pull."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "get_player_newsResult",
  "additionalProperties": true
}
🟢request_news_scrape(player_id)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "type": "string",
      "title": "Player Id",
      "description": "GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first.",
      "examples": [
        "Josh Allen#QB",
        "Justin Jefferson#WR",
        "Houston Texans#DST"
      ]
    }
  },
  "required": [
    "player_id"
  ],
  "title": "request_news_scrapeArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "description": "GridIron player id."
    },
    "status": {
      "description": "Request status."
    },
    "message": {
      "description": "What happens next."
    },
    "poll": {
      "description": "How to check for the result."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "request_news_scrapeResult",
  "additionalProperties": true
}
🟢get_latest_news(since, days, impact, position, team, ...)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "since": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Since",
      "description": "Only news after this time: ISO-8601 or unix seconds. Default: the last `days` days. Clamped to 90 days.",
      "examples": [
        "2026-11-08T12:00:00Z"
      ],
      "default": null
    },
    "days": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1,
          "maximum": 90
        },
        {
          "type": "null"
        }
      ],
      "title": "Days",
      "description": "Lookback when since is omitted, 1-90. Default 7.",
      "default": null
    },
    "impact": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Impact",
      "description": "Impact tags, comma-separated: injury, transaction, role, general.",
      "examples": [
        "injury",
        "injury,transaction"
      ],
      "default": null
    },
    "position": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Position",
      "description": "Positions, comma-separated (QB, RB, WR, TE, K, DST).",
      "examples": [
        "RB",
        "WR,TE"
      ],
      "default": null
    },
    "team": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Team",
      "description": "Only this team's players. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable.",
      "examples": [
        "BUF",
        "KC",
        "PHI"
      ],
      "default": null
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "title": "Limit",
      "description": "Page size, 1-100.",
      "default": 25
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Cursor",
      "description": "next_cursor from the previous page; omit for the first page.",
      "default": null
    }
  },
  "title": "get_latest_newsArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "since": {
      "description": "Start of the window."
    },
    "until": {
      "description": "End of the window."
    },
    "count": {
      "description": "Items returned."
    },
    "filters": {
      "description": "The filters applied."
    },
    "news": {
      "description": "Headlines across all tracked players, newest first, each tagged by impact."
    },
    "next_cursor": {
      "description": "Pass back as cursor for the next page."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "get_latest_newsResult",
  "additionalProperties": true
}
🟢get_ros_projections(position, team, player_id, scoring)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "position": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "QB",
            "RB",
            "WR",
            "TE",
            "K",
            "DST"
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Position",
      "description": "Only this position.",
      "default": null
    },
    "team": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Team",
      "description": "Only this team's players. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable.",
      "examples": [
        "BUF",
        "KC",
        "PHI"
      ],
      "default": null
    },
    "player_id": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Player Id",
      "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.",
      "examples": [
        "Josh Allen#QB",
        "Justin Jefferson#WR",
        "Houston Texans#DST"
      ],
      "default": null
    },
    "scoring": {
      "type": "string",
      "enum": [
        "ppr",
        "half",
        "standard"
      ],
      "title": "Scoring",
      "description": "Fantasy scoring: ppr (full PPR, the default), half (half-PPR) or standard.",
      "default": "ppr"
    }
  },
  "title": "get_ros_projectionsArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "season": {
      "description": "Season."
    },
    "current_week": {
      "description": "The current NFL week."
    },
    "position": {
      "description": "Position filter."
    },
    "team": {
      "description": "Team filter."
    },
    "scoring": {
      "description": "Scoring used."
    },
    "method": {
      "description": "How the totals are built."
    },
    "method_note": {
      "description": "Notes on the method."
    },
    "count": {
      "description": "Rows returned."
    },
    "projections": {
      "description": "Per player: projected points for the rest of the season, games_remaining and points_per_game."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "get_ros_projectionsResult",
  "additionalProperties": true
}
🟢get_schedule(season, week, team)

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).

入力スキーマ

{
  "type": "object",
  "properties": {
    "season": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^(19|20)\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "title": "Season",
      "description": "Season year, 2020 or later. Default: the current season.",
      "examples": [
        "2026",
        "2025"
      ],
      "default": null
    },
    "week": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1,
          "maximum": 18
        },
        {
          "type": "null"
        }
      ],
      "title": "Week",
      "description": "Only this week, 1-18. Default: the whole season.",
      "examples": [
        10
      ],
      "default": null
    },
    "team": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Team",
      "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.",
      "examples": [
        "BUF",
        "KC",
        "PHI"
      ],
      "default": null
    }
  },
  "title": "get_scheduleArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "season": {
      "description": "Season."
    },
    "week": {
      "description": "Week filter."
    },
    "team": {
      "description": "Team filter."
    },
    "bye_week": {
      "description": "The team's bye week (only when team is given)."
    },
    "count": {
      "description": "Games returned."
    },
    "games": {
      "description": "Per game: week, home, away, kickoff (UTC), status, final score, and odds on Pro."
    },
    "updated_at": {
      "description": "When the schedule was last refreshed."
    },
    "source": {
      "description": "Data source."
    },
    "odds": {
      "description": "Below Pro only: a note that betting lines need Pro."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "get_scheduleResult",
  "additionalProperties": true
}
🟢get_byes(season)

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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "season": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^(19|20)\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "title": "Season",
      "description": "Season year, 2020 or later. Default: the current season.",
      "examples": [
        "2026",
        "2025"
      ],
      "default": null
    }
  },
  "title": "get_byesArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "season": {
      "description": "Season."
    },
    "byes": {
      "description": "Team code -> bye week."
    },
    "by_week": {
      "description": "Week -> teams on bye."
    },
    "source": {
      "description": "Data source."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "get_byesResult",
  "additionalProperties": true
}
🟢get_injury_changes(since, position, team, limit)

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).

入力スキーマ

{
  "type": "object",
  "properties": {
    "since": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Since",
      "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.",
      "examples": [
        "2026-11-08T16:00:00Z"
      ],
      "default": null
    },
    "position": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "QB",
            "RB",
            "WR",
            "TE",
            "K",
            "DST"
          ]
        },
        {
          "type": "null"
        }
      ],
      "title": "Position",
      "description": "Only this position.",
      "default": null
    },
    "team": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Team",
      "description": "Only this team. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable.",
      "examples": [
        "BUF",
        "KC",
        "PHI"
      ],
      "default": null
    },
    "limit": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1,
          "maximum": 1000
        },
        {
          "type": "null"
        }
      ],
      "title": "Limit",
      "description": "Maximum changes, 1-1000. Default 500.",
      "default": null
    }
  },
  "title": "get_injury_changesArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "season": {
      "description": "Season."
    },
    "since": {
      "description": "Start of the window."
    },
    "until": {
      "description": "End of the window."
    },
    "count": {
      "description": "Changes returned."
    },
    "changes": {
      "description": "Per change: player, team, previous_status, status and detected_at."
    },
    "next_since": {
      "description": "Pass back as since to get only newer changes."
    },
    "last_checked_at": {
      "description": "When GridIron last checked injury statuses."
    },
    "truncated": {
      "description": "true when more changes exist than limit allowed."
    },
    "note": {
      "description": "Present when since was clamped to the 14-day window."
    },
    "team_freshness": {
      "description": "Per team: when its injury report was last checked and updated."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    }
  },
  "title": "get_injury_changesResult",
  "additionalProperties": true
}
🟢get_player_by_gsis_id(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.

入力スキーマ

{
  "type": "object",
  "properties": {
    "gsis_id": {
      "type": "string",
      "pattern": "^\\d{2}-\\d{7}$",
      "title": "Gsis Id",
      "description": "NFL GSIS id, the key nflverse and NFL data use.",
      "examples": [
        "00-0034857"
      ]
    }
  },
  "required": [
    "gsis_id"
  ],
  "title": "get_player_by_gsis_idArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "description": "GridIron player id (\"First Last#POS\")."
    },
    "player_name": {
      "description": "Player name."
    },
    "position": {
      "description": "Position."
    },
    "team": {
      "description": "Current team code."
    },
    "espn_player_id": {
      "description": "ESPN athlete id."
    },
    "ids": {
      "description": "Other systems' ids (gsis, pfr, pff, nfl, espn, sleeper) from the nflverse crosswalk."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    },
    "note": {
      "description": "A sentence for the user saying which plan is needed."
    }
  },
  "title": "get_player_by_gsis_idResult",
  "additionalProperties": true
}
🟢get_depth_chart(team, position, starters)

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 the slot (1 = starter), a starter flag, and the player's current injury_status and available, so an OUT or IR starter is flagged rather than moved. Use it for "who are the Bears' starting WRs?" or the next man up behind an injured player. Built from ESPN's public depth charts via nflverse, not official team depth charts. Pro plan (Free and Basic keys get 403 pro_required).

入力スキーマ

{
  "type": "object",
  "properties": {
    "team": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Team",
      "description": "Only this team. Default: all 32. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable.",
      "examples": [
        "BUF",
        "KC",
        "PHI"
      ],
      "default": null
    },
    "position": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Position",
      "description": "Depth chart position, e.g. QB, RB, WR, TE, LT, C, PK, LCB, WLB. Groups also work: K, OT, G, OL, and on defense DE, DT, DL, EDGE, LB, CB, S, DB.",
      "examples": [
        "QB",
        "WR",
        "CB"
      ],
      "default": null
    },
    "starters": {
      "type": "boolean",
      "title": "Starters",
      "description": "true = starters only: the first player in each slot (depth 1), e.g. three WRs per team in the base offense. With position=QB, every team's starting QB.",
      "default": false
    }
  },
  "title": "get_depth_chartArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "season": {
      "description": "Season."
    },
    "as_of": {
      "description": "The nflverse snapshot time the depth charts come from."
    },
    "loaded_at": {
      "description": "When GridIron loaded that snapshot."
    },
    "count": {
      "description": "Entries returned."
    },
    "entries": {
      "description": "Per entry: team, player, player_id, espn_id, gsis_id, position, formation, slot, depth (order within the slot, 1 = starter), starter, rank (the source's position-wide rank, not a starter flag), and injury_status and available from GridIron's injury data (null when the player isn't in /players, e.g. most defenders)."
    },
    "note": {
      "description": "Notes about the data."
    },
    "source": {
      "description": "Attribution: nflverse, CC-BY-4.0, built from ESPN's public depth charts."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    }
  },
  "title": "get_depth_chartResult",
  "additionalProperties": true
}
🟢get_inactives(week, team, season)

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).

入力スキーマ

{
  "type": "object",
  "properties": {
    "week": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1,
          "maximum": 22
        },
        {
          "type": "null"
        }
      ],
      "title": "Week",
      "description": "Week 1-22 (19+ are playoffs). Default: the newest week with inactives published.",
      "examples": [
        9
      ],
      "default": null
    },
    "team": {
      "anyOf": [
        {
          "type": "string"
        },
        {
          "type": "null"
        }
      ],
      "title": "Team",
      "description": "Only this team. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable.",
      "examples": [
        "BUF",
        "KC",
        "PHI"
      ],
      "default": null
    },
    "season": {
      "anyOf": [
        {
          "type": "string",
          "pattern": "^(19|20)\\d{2}$"
        },
        {
          "type": "null"
        }
      ],
      "title": "Season",
      "description": "Season year, 2020 or later. Default: the current season.",
      "examples": [
        "2026",
        "2025"
      ],
      "default": null
    }
  },
  "title": "get_inactivesArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "season": {
      "description": "Season."
    },
    "week": {
      "description": "The week returned."
    },
    "team": {
      "description": "Team filter."
    },
    "count": {
      "description": "Inactive players returned."
    },
    "inactives": {
      "description": "Inactive players by team, with gsis, espn, sleeper and pfr ids."
    },
    "teams_published": {
      "description": "Teams with inactives published for the week so far."
    },
    "teams_played": {
      "description": "Teams whose game that week is final; the week is complete when they match."
    },
    "weeks_available": {
      "description": "Weeks with inactives published."
    },
    "loaded_at": {
      "description": "When GridIron last loaded the data."
    },
    "note": {
      "description": "Notes about the data."
    },
    "source": {
      "description": "Attribution: nflverse, CC-BY-4.0."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    }
  },
  "title": "get_inactivesResult",
  "additionalProperties": true
}
🟢get_coverage_splits(player_id)

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 (nflverse has no 2026 coverage file yet). It also returns 2026 season-to-date splits against the blitz and on play action, contested catch rate and drops (FTN charting via nflverse). Splits under 15 targets are flagged small_sample. Use it for "how does he do against man vs zone?". Players with at least 10 targets. No slot/wide alignment data. Basic plan and above.

入力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "type": "string",
      "title": "Player Id",
      "description": "GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first.",
      "examples": [
        "Josh Allen#QB",
        "Justin Jefferson#WR",
        "Houston Texans#DST"
      ]
    }
  },
  "required": [
    "player_id"
  ],
  "title": "get_coverage_splitsArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "description": "GridIron player id (\"First Last#POS\")."
    },
    "player_name": {
      "description": "Player name."
    },
    "position": {
      "description": "Position."
    },
    "team": {
      "description": "Current team code."
    },
    "gsis_id": {
      "description": "NFL GSIS id the charting data is keyed on."
    },
    "coverage": {
      "description": "2025 season: targets_total and per-split lines for man, zone and each coverage shell (e.g. COVER_3): targets, receptions, yards, tds, air_yards, epa, ints, catch_rate, yards_per_target, epa_per_target, share_of_targets, and small_sample (true under 15 targets)."
    },
    "pressure": {
      "description": "2026 season to date: vs_blitz, no_blitz, play_action and no_play_action lines (same fields), contested_catch_rate and drops."
    },
    "as_of": {
      "description": "Snapshot time of the data."
    },
    "note": {
      "description": "Season labels and caveats."
    },
    "source": {
      "description": "Attribution: nflverse, CC-BY-4.0; blitz/play-action charting is FTN data via nflverse."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    }
  },
  "title": "get_coverage_splitsResult",
  "additionalProperties": true
}
🟢get_defense_coverage(team)

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 season-to-date blitz rate, average pass rushers and box count (FTN charting via nflverse). Use it for "does this defense play man or zone?" and "how often does it blitz?". Basic plan and above.

入力スキーマ

{
  "type": "object",
  "properties": {
    "team": {
      "type": "string",
      "title": "Team",
      "description": "Defense team code. Team code, e.g. BUF or KC. LA/LAR, WSH/WAS and JAC/JAX are interchangeable.",
      "examples": [
        "BUF",
        "KC",
        "PHI"
      ]
    }
  },
  "required": [
    "team"
  ],
  "title": "get_defense_coverageArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "team": {
      "description": "Team code."
    },
    "coverage": {
      "description": "2025 season: man_pct and zone_pct (0-100), shell mix, blitz_pct, pressure_pct, avg_box and what the defense allowed vs man and vs zone (targets, yards, EPA)."
    },
    "pressure": {
      "description": "2026 season to date: blitz_pct, avg_pass_rushers, avg_box, play_action_faced_pct."
    },
    "as_of": {
      "description": "Snapshot time of the data."
    },
    "note": {
      "description": "Season labels and caveats."
    },
    "source": {
      "description": "Attribution: nflverse, CC-BY-4.0; blitz charting is FTN data via nflverse."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    }
  },
  "title": "get_defense_coverageResult",
  "additionalProperties": true
}
🟢get_coverage_matchup(player_id, week)

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 it for "how does he match up with the coverage he will see Sunday?". Splits under 15 targets are flagged small_sample. No slot/wide alignment data. Basic plan and above.

入力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "type": "string",
      "title": "Player Id",
      "description": "GridIron player id, \"First Last#POS\", matched case-insensitively. Defenses are \"Team Name#DST\". Unsure of the id? Call search_players first.",
      "examples": [
        "Josh Allen#QB",
        "Justin Jefferson#WR",
        "Houston Texans#DST"
      ]
    },
    "week": {
      "anyOf": [
        {
          "type": "integer",
          "minimum": 1,
          "maximum": 18
        },
        {
          "type": "null"
        }
      ],
      "title": "Week",
      "description": "NFL regular-season week, 1-18. Default: the current week.",
      "examples": [
        10
      ],
      "default": null
    }
  },
  "required": [
    "player_id"
  ],
  "title": "get_coverage_matchupArguments"
}

出力スキーマ

{
  "type": "object",
  "properties": {
    "player_id": {
      "description": "GridIron player id (\"First Last#POS\")."
    },
    "player_name": {
      "description": "Player name."
    },
    "position": {
      "description": "Position."
    },
    "team": {
      "description": "Current team code."
    },
    "opponent": {
      "description": "This week's opponent."
    },
    "week": {
      "description": "Week."
    },
    "player": {
      "description": "His 2025 man/zone lines and 2026 vs_blitz/no_blitz lines."
    },
    "opponent_defense": {
      "description": "The opponent's 2025 man/zone rates, shells and allowed lines, and its 2026 blitz rate."
    },
    "read": {
      "description": "One plain sentence comparing his better split with what the opponent leans on."
    },
    "as_of": {
      "description": "Snapshot time of the data."
    },
    "note": {
      "description": "Season labels and caveats."
    },
    "source": {
      "description": "Attribution: nflverse, CC-BY-4.0; blitz charting is FTN data via nflverse."
    },
    "error": {
      "description": "Present only when the call failed: what went wrong."
    },
    "status": {
      "description": "HTTP status of the failed API call."
    },
    "reason": {
      "description": "Machine-readable failure reason, e.g. basic_required or pro_required."
    },
    "required_plan": {
      "description": "The plan that unlocks this data: basic or pro."
    },
    "upgrade_url": {
      "description": "Where to see the plans."
    }
  },
  "title": "get_coverage_matchupResult",
  "additionalProperties": true
}

コミュニティ

このサーバーを評価する

エビデンス

最近の観測

検証済みバージョンは記録されていませんツール 24 件