Documentation menu

nfl_player_dossier

Pro tier

Player dossier

One-call player card. Stitches identity, season stat line, role / snap share, injury status, recent games, fantasy opportunity, rankings, TD-regression, and usage momentum into one bounded payload. PREFERRED when you need a broad overview rather than one specific metric. Depth chart and schedule are opt-in sections; season defaults to the player's most recent.

Minimum tier: Pro
Data coverage: Varies by query

Parameters

Name	Type	Required	Description
`player`	string	Optional	Player name — full ('Justin Jefferson') or short ('J.Jefferson') both accepted.
`team`	string	Optional	Team abbreviation to disambiguate the player.
`gsis_id`	string	Optional	Exact GSIS id to disambiguate the player.
`season`	integer	Optional	Season year; defaults to the player's most recent.
`season_type`	string	Optional	Regular season or playoffs (default REG).Options: REG, POST
`sections`	array	Optional	Bounded dossier sections. depth_chart, schedule and rankings_history are opt-in.
`last_n_games`	integer	Optional	Recent-game and opt-in schedule window size.Default: 5

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_player_dossier",
    "arguments": {
      "player": "Justin Jefferson",
      "season": 2024
    }
  }
}'

Example response

Excerpt · lists trimmed

{
  "player": "Justin Jefferson",
  "gsis_id": "00-0036322",
  "team": "MIN",
  "position": "WR",
  "season": 2024,
  "omitted_sections": [
    "rankings_history",
    "depth_chart",
    "schedule"
  ],
  "stats": [
    {
      "season": 2024,
      "season_type": "REG",
      "targets": 154,
      "receptions": 103,
      "yards": 1533,
      "avg_yac": 4.7,
      "touchdowns": 10,
      "avg_epa": 0.417,
      "explosive_plays": 28
    }
  ],
  "recent_games": [
    {
      "gsis_id": "00-0036322",
      "season": 2024,
      "week": 18,
      "season_type": "REG",
      "team": "MIN",
      "opponent_team": "DET",
      "position": "WR",
      "completions": 0,
      "attempts": 0,
      "passing_yards": 0,
      "passing_tds": 0,
      "carries": 0,
      "rushing_yards": 0,
      "rushing_tds": 0,
      "targets": 9,
      "receptions": 3,
      "receiving_yards": 54,
      "receiving_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",
      "completions": 0,
      "attempts": 0,
      "passing_yards": 0,
      "passing_tds": 0,
      "carries": 0,
      "rushing_yards": 0,
      "rushing_tds": 0,
      "targets": 11,
      "receptions": 8,
      "receiving_yards": 92,
      "receiving_tds": 0,
      "fantasy_points": 9.2,
      "fantasy_points_ppr": 17.2,
      "player": "Justin Jefferson"
    },
    {
      "gsis_id": "00-0036322",
      "season": 2024,
      "week": 16,
      "season_type": "REG",
      "team": "MIN",
      "opponent_team": "SEA",
      "position": "WR",
      "completions": 0,
      "attempts": 0,
      "passing_yards": 0,
      "passing_tds": 0,
      "carries": 0,
      "rushing_yards": 0,
      "rushing_tds": 0,
      "targets": 13,
      "receptions": 10,
      "receiving_yards": 144,
      "receiving_tds": 2,
      "fantasy_points": 26.4,
      "fantasy_points_ppr": 36.4,
      "player": "Justin Jefferson"
    }
  ],
  "role": [
    {
      "player": "Justin Jefferson",
      "position": "WR",
      "team": "MIN",
      "opponent": "NYG",
      "season": 2024,
      "week": 1,
      "game_type": "REG",
      "offense_snaps": 46,
      "offense_pct": 0.8,
      "defense_snaps": 0,
      "defense_pct": 0,
      "st_snaps": 0,
      "st_pct": 0
    },
    {
      "player": "Justin Jefferson",
      "position": "WR",
      "team": "MIN",
      "opponent": "SF",
      "season": 2024,
      "week": 2,
      "game_type": "REG",
      "offense_snaps": 38,
      "offense_pct": 0.7,
      "defense_snaps": 0,
      "defense_pct": 0,
      "st_snaps": 0,
      "st_pct": 0
    },
    {
      "player": "Justin Jefferson",
      "position": "WR",
      "team": "MIN",
      "opponent": "HOU",
      "season": 2024,
      "week": 3,
      "game_type": "REG",
      "offense_snaps": 57,
      "offense_pct": 0.9,
      "defense_snaps": 0,
      "defense_pct": 0,
      "st_snaps": 0,
      "st_pct": 0
    }
  ],
  "injury": [
    {
      "player": "Justin Jefferson",
      "position": "WR",
      "team": "MIN",
      "gsis_id": "00-0036322",
      "season": 2024,
      "week": 3,
      "report_primary_injury": null,
      "report_secondary_injury": null,
      "report_status": null,
      "practice_primary_injury": "Quadricep",
      "practice_secondary_injury": null,
      "practice_status": "Full Participation in Practice"
    }
  ],
  "opportunity": [
    {
      "season": "2024",
      "week": 19,
      "team": "MIN",
      "player": "Justin Jefferson",
      "position": "WR",
      "gsis_id": "00-0036322",
      "rec_attempt": 8,
      "rush_attempt": 0,
      "rec_air_yards": 149,
      "receptions": 5,
      "receptions_exp": 4.52,
      "rec_yards_gained": 58,
      "rush_yards_gained": 0,
      "rec_touchdown": 0,
      "rush_touchdown": 0,
      "total_fantasy_points": 10.8,
      "total_fantasy_points_exp": 15,
      "total_fantasy_points_diff": -4.2,
      "rec_attempt_team": 40,
      "rush_attempt_team": 22
    },
    {
      "season": "2024",
      "week": 18,
      "team": "MIN",
      "player": "Justin Jefferson",
      "position": "WR",
      "gsis_id": "00-0036322",
      "rec_attempt": 9,
      "rush_attempt": 0,
      "rec_air_yards": 56,
      "receptions": 3,
      "receptions_exp": 5.62,
      "rec_yards_gained": 54,
      "rush_yards_gained": 0,
      "rec_touchdown": 0,
      "rush_touchdown": 0,
      "total_fantasy_points": 8.4,
      "total_fantasy_points_exp": 21.76,
      "total_fantasy_points_diff": -13.36,
      "rec_attempt_team": 41,
      "rush_attempt_team": 19
    },
    {
      "season": "2024",
      "week": 17,
      "team": "MIN",
      "player": "Justin Jefferson",
      "position": "WR",
      "gsis_id": "00-0036322",
      "rec_attempt": 11,
      "rush_attempt": 0,
      "rec_air_yards": 58,
      "receptions": 8,
      "receptions_exp": 8.3,
      "rec_yards_gained": 92,
      "rush_yards_gained": 0,
      "rec_touchdown": 0,
      "rush_touchdown": 0,
      "total_fantasy_points": 17.2,
      "total_fantasy_points_exp": 20.09,
      "total_fantasy_points_diff": -2.89,
      "rec_attempt_team": 43,
      "rush_attempt_team": 26
    }
  ],
  "rankings": {
    "ppr-wr": [
      {
        "player": "Justin Jefferson",
        "position": "WR",
        "team": "MIN",
        "rank": 20,
        "ecr": 20.67,
        "sd": 1.72,
        "best": 17,
        "worst": 25,
        "pos_rank": "WR20",
        "opponent": "vs. DET",
        "bye": 6,
        "start_sit_grade": "A-",
        "note": null,
        "ranking_set": "ppr-wr",
        "scrape_date": "2025-12-30",
        "as_of_date": "2025-12-30",
        "fantasypros_id": 19236,
        "gsis_id": "00-0036322"
      }
    ]
  },
  "regression": [
    {
      "player_id": "00-0036322",
      "full_name": "Justin Jefferson",
      "position": "WR",
      "team": "MIN",
      "season": 2024,
      "rec_td": 10,
      "rec_td_exp": 11.04,
      "rec_td_luck": -1.04,
      "rush_td": 0,
      "rush_td_exp": 0.01,
      "rush_td_luck": -0.01,
      "total_td_luck_score": -1.05
    }
  ],
  "momentum": [
    {
      "gsis_id": "00-0036322",
      "player": "Justin Jefferson",
      "position": "WR",
      "team": "MIN",
      "season": 2024,
      "week": 3,
      "snap_pct": 90,
      "target_share_pct": 28.6,
      "carry_share_pct": 0,
      "air_yards_share_pct": 40.8,
      "snap_pct_3wk": 81.3,
      "target_share_pct_3wk": 26.8,
      "carry_share_pct_3wk": 0,
      "air_yards_share_pct_3wk": 47.1,
      "snap_pct_delta": 8.7,
      "target_share_pct_delta": 1.7,
      "carry_share_pct_delta": 0,
      "air_yards_share_pct_delta": -6.2,
      "heat": "Hot",
      "heat_score": 58.4,
      "heat_confidence": "high"
    }
  ]
}

All tools