Documentation menu

nfl_game_log

Pro tier

Game logs

PREFERRED for weekly game logs and recent-form questions ('last 5 games', 'week-by-week'). Returns per-game stat lines including fantasy points, newest first. Use nfl_player_stats instead for season-level aggregates.

Minimum tier: Pro
Data coverage: 2013 onwards seasons

Parameters

Name	Type	Required	Description
`player`	string	Optional	Player name — full ('Justin Jefferson') or short ('J.Jefferson') both accepted.
`team`	string	Optional	Team abbreviation used only to disambiguate player.
`gsis_id`	string	Optional	Exact GSIS player ID; mutually exclusive with player and gsis_ids.
`gsis_ids`	array	Optional	Up to 100 exact GSIS IDs for recent-form batches.
`season`	integer	Optional	Season year (e.g. 2025).
`season_type`	string	Optional	Season type filter (e.g. REG, POST).
`last_n_games`	integer	Optional	Return only the most recent N games.
`week_from`	integer	Optional	Earliest week (inclusive).
`week_to`	integer	Optional	Latest week (inclusive).

Example request

A Model Context Protocol tools/call over Streamable HTTP. Replace YOUR_API_KEY with a key from your dashboard.

curl -X POST https://mcp.nflmcp.com/mcp \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "nfl_game_log",
    "arguments": {
      "player": "Justin Jefferson",
      "season": 2024
    }
  }
}'

Example response

Excerpt · lists trimmed

{
  "game_log": [
    {
      "gsis_id": "00-0036322",
      "season": 2024,
      "week": 19,
      "season_type": "POST",
      "team": "MIN",
      "opponent_team": "LA",
      "position": "WR",
      "targets": 8,
      "receptions": 5,
      "receiving_yards": 58,
      "receiving_tds": 0,
      "receiving_air_yards": 149,
      "target_share": 0.2,
      "air_yards_share": 0.35,
      "receiving_epa": -3.635,
      "carries": 0,
      "rushing_yards": 0,
      "rushing_tds": 0,
      "fantasy_points": 5.8,
      "fantasy_points_ppr": 10.8,
      "player": "Justin Jefferson"
    },
    {
      "gsis_id": "00-0036322",
      "season": 2024,
      "week": 18,
      "season_type": "REG",
      "team": "MIN",
      "opponent_team": "DET",
      "position": "WR",
      "targets": 9,
      "receptions": 3,
      "receiving_yards": 54,
      "receiving_tds": 0,
      "receiving_air_yards": 56,
      "target_share": 0.24,
      "air_yards_share": 0.2,
      "receiving_epa": -2.805,
      "carries": 0,
      "rushing_yards": 0,
      "rushing_tds": 0,
      "fantasy_points": 5.4,
      "fantasy_points_ppr": 8.4,
      "player": "Justin Jefferson"
    },
    {
      "gsis_id": "00-0036322",
      "season": 2024,
      "week": 17,
      "season_type": "REG",
      "team": "MIN",
      "opponent_team": "GB",
      "position": "WR",
      "targets": 11,
      "receptions": 8,
      "receiving_yards": 92,
      "receiving_tds": 0,
      "receiving_air_yards": 58,
      "target_share": 0.27,
      "air_yards_share": 0.18,
      "receiving_epa": 2.75,
      "carries": 0,
      "rushing_yards": 0,
      "rushing_tds": 0,
      "fantasy_points": 9.2,
      "fantasy_points_ppr": 17.2,
      "player": "Justin Jefferson"
    }
  ],
  "count": 18
}

All tools