Documentation menu

nfl_separation_opportunity

Pro tier

Separation vs. production

PREFERRED for receiver regression / 'getting open but not producing' questions (2016–present). Joins Next Gen Stats separation and YAC-above-expected to fantasy opportunity per player-season. regression_candidate=true flags receivers creating separation (>2.5 yds) who under-produced (fp_diff_per_game < -1.5, td_luck < -1.0). Default sort is most under-producing first (fp_diff_per_game ASC).

Minimum tier: Pro
Data coverage: 2016 onwards seasons

Parameters

Name	Type	Required	Description
`player`	string	Optional	Player name — full ('Justin Jefferson') or short ('J.Jefferson') both accepted.
`position`	string	Optional	Position filter (e.g. WR, TE).
`team`	string	Optional	Team abbreviation.
`season`	integer	Optional	Exact season year (2016+).
`regression_candidate`	boolean	Optional	If true, only return flagged positive-regression candidates.
`limit`	integer	Optional	Max rows (default 50, max 500).

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_separation_opportunity",
    "arguments": {
      "season": 2024,
      "limit": 10
    }
  }
}'

Example response

Excerpt · lists trimmed

{
  "separation_opportunity": [
    {
      "player_id": "00-0035341",
      "full_name": "Trenton Irwin",
      "position": "WR",
      "team": "CIN",
      "season": 2024,
      "games": 4,
      "fp_diff": -20.23,
      "fp_diff_per_game": -5.057,
      "td_luck": -2.47,
      "catch_luck": -2.7,
      "target_share_pct": 7.1,
      "air_yards_share_pct": 7,
      "avg_separation": 1.331,
      "avg_yac_above_expectation": -0.731,
      "catch_percentage": 16.7,
      "regression_candidate": false
    },
    {
      "player_id": "00-0039810",
      "full_name": "Jermaine Burton",
      "position": "WR",
      "team": "CIN",
      "season": 2024,
      "games": 4,
      "fp_diff": -19.43,
      "fp_diff_per_game": -4.858,
      "td_luck": -2.4,
      "catch_luck": -2.5,
      "target_share_pct": 7.8,
      "air_yards_share_pct": 19.4,
      "avg_separation": 1.029,
      "avg_yac_above_expectation": 0.81,
      "catch_percentage": 20,
      "regression_candidate": false
    },
    {
      "player_id": "00-0036261",
      "full_name": "Brandon Aiyuk",
      "position": "WR",
      "team": "SF",
      "season": 2024,
      "games": 7,
      "fp_diff": -23.92,
      "fp_diff_per_game": -3.417,
      "td_luck": -2.46,
      "catch_luck": -3.86,
      "target_share_pct": 21.8,
      "air_yards_share_pct": 26.5,
      "avg_separation": 2.25,
      "avg_yac_above_expectation": 0.663,
      "catch_percentage": 51.7,
      "regression_candidate": false
    }
  ],
  "count": 10
}

All tools