Documentation menu

nfl_heat

Pro tier

Heat signal

PREFERRED for 'who's heating up' / momentum questions. A board of players whose usage is trending up before the box score catches up, each labeled Cold / Warming / Hot / Surging with a 0–100 heat_score and a confidence tier. Built on weekly snap, target, carry, and air-yards deltas. Filter to one band with `heat`; default sort is hottest first.

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.
`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 momentum 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.
`heat`	string	Optional	Only return players in this momentum band.Options: surging, hot, warming, cold
`min_snap_pct`	number	Optional	Minimum snap % (0–100), default 20 to cut noise.
`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_heat",
    "arguments": {
      "season": 2024,
      "week": 8,
      "limit": 10
    }
  }
}'

Example response

Excerpt · lists trimmed

{
  "heat": [
    {
      "gsis_id": "00-0039150",
      "player": "Bryce Young",
      "position": "QB",
      "team": "CAR",
      "season": 2024,
      "week": 8,
      "snap_pct": 100,
      "target_share_pct": 0,
      "carry_share_pct": 15,
      "air_yards_share_pct": 0,
      "snap_pct_delta": 59.3,
      "target_share_pct_delta": 0,
      "carry_share_pct_delta": 8.2,
      "air_yards_share_pct_delta": 0,
      "heat": "Surging",
      "heat_score": 100,
      "heat_confidence": "high"
    },
    {
      "gsis_id": "00-0031503",
      "player": "Jameis Winston",
      "position": "QB",
      "team": "CLE",
      "season": 2024,
      "week": 8,
      "snap_pct": 100,
      "target_share_pct": 0,
      "carry_share_pct": 8.7,
      "air_yards_share_pct": 0,
      "snap_pct_delta": 59,
      "target_share_pct_delta": 0,
      "carry_share_pct_delta": 4.3,
      "air_yards_share_pct_delta": 0,
      "heat": "Surging",
      "heat_score": 100,
      "heat_confidence": "high"
    },
    {
      "gsis_id": "00-0039363",
      "player": "Isaac Guerendo",
      "position": "RB",
      "team": "SF",
      "season": 2024,
      "week": 8,
      "snap_pct": 63,
      "target_share_pct": 15.4,
      "carry_share_pct": 38.9,
      "air_yards_share_pct": 3.1,
      "snap_pct_delta": 30.7,
      "target_share_pct_delta": 9.2,
      "carry_share_pct_delta": 14.4,
      "air_yards_share_pct_delta": 2,
      "heat": "Surging",
      "heat_score": 95.3,
      "heat_confidence": "high"
    }
  ],
  "count": 10
}

All tools