Documentation menu

nfl_role_trend

Pro tier

Usage trends

Use for usage-trend / breakout / fade questions. Returns weekly snap %, target share, carry share, and air-yards share with a trailing 3-week average and the current-week delta vs that average. Use for 'whose role is trending up' or 'is player X's snap share rising'. Default sort is biggest snap-share gain first (snap_pct_delta DESC).

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 a roster-level trend query.
`position`	string	Optional	Position filter (e.g. WR, RB).
`team`	string	Optional	Team abbreviation.
`season`	integer	Optional	Exact season year.
`week`	integer	Optional	Week number.
`min_snap_pct`	number	Optional	Minimum snap % (0–100) for the week.
`limit`	integer	Optional	Max rows (default 50, max 500).
`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_role_trend",
    "arguments": {
      "team": "KC",
      "season": 2024,
      "week": 1,
      "limit": 10
    }
  }
}'

Example response

Excerpt · lists trimmed

{
  "role_trend": [
    {
      "gsis_id": "00-0039067",
      "player": "Rashee Rice",
      "position": "WR",
      "team": "KC",
      "season": 2024,
      "week": 1,
      "snap_pct": 78,
      "target_share_pct": 32.1,
      "carry_share_pct": 0,
      "air_yards_share_pct": 29.1,
      "snap_pct_3wk": 78,
      "target_share_pct_3wk": 32.1,
      "carry_share_pct_3wk": 0,
      "air_yards_share_pct_3wk": 29.1,
      "snap_pct_delta": 0,
      "target_share_pct_delta": 0,
      "carry_share_pct_delta": 0,
      "air_yards_share_pct_delta": 0,
      "heat": "Cold",
      "heat_score": 50,
      "heat_confidence": "high"
    },
    {
      "gsis_id": "00-0030506",
      "player": "Travis Kelce",
      "position": "TE",
      "team": "KC",
      "season": 2024,
      "week": 1,
      "snap_pct": 89,
      "target_share_pct": 14.3,
      "carry_share_pct": 0,
      "air_yards_share_pct": 16.4,
      "snap_pct_3wk": 89,
      "target_share_pct_3wk": 14.3,
      "carry_share_pct_3wk": 0,
      "air_yards_share_pct_3wk": 16.4,
      "snap_pct_delta": 0,
      "target_share_pct_delta": 0,
      "carry_share_pct_delta": 0,
      "air_yards_share_pct_delta": 0,
      "heat": "Cold",
      "heat_score": 50,
      "heat_confidence": "high"
    },
    {
      "gsis_id": "00-0039894",
      "player": "Xavier Worthy",
      "position": "WR",
      "team": "KC",
      "season": 2024,
      "week": 1,
      "snap_pct": 63,
      "target_share_pct": 10.7,
      "carry_share_pct": 5,
      "air_yards_share_pct": 22.4,
      "snap_pct_3wk": 63,
      "target_share_pct_3wk": 10.7,
      "carry_share_pct_3wk": 5,
      "air_yards_share_pct_3wk": 22.4,
      "snap_pct_delta": 0,
      "target_share_pct_delta": 0,
      "carry_share_pct_delta": 0,
      "air_yards_share_pct_delta": 0,
      "heat": "Cold",
      "heat_score": 50,
      "heat_confidence": "high"
    }
  ],
  "count": 10
}

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