Documentation menu

nfl_fantasy_opportunity

Pro tier

Fantasy opportunity

Use for fantasy football opportunity questions. Look up target share, air yards share, carry share, and opportunity scores per player per week. Requires ff_opportunity dataset. Available 2006–present. Filter by player, team, season, week, or position.

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.
`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 one roster-level query.
`team`	string	Optional	Team abbreviation (e.g. KC, PHI)
`season`	integer	Optional	Season year. Omit for all seasons.
`week`	integer	Optional	Week number (1–22). Omit for full season.
`position`	string	Optional	Position filter (e.g. WR, RB, TE).
`limit`	integer	Optional	Max rows per page (default 100, max 500).
`offset`	integer	Optional	Row offset for pagination; pass the returned next_offset for the next page.
`plan_id`	string	Optional	Optional analysis correlation ID returned by nfl_plan. Pass the same plan_id to every tool call that belongs to that analysis.

Example request

A Model Context Protocol tools/call over Streamable HTTP. Replace YOUR_API_KEY with a key from your dashboard. This is a low-level request example; MCP clients manage protocol initialization and browser OAuth for you.

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

Example response

Excerpt · lists trimmed

{
  "fantasy_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
    }
  ],
  "count": 18
}

Saved reference output, not a live production result. Query your authenticated connection for current data and read its coverage, freshness, and missing-result hints. Understand the limitations.

All tools