Documentation menu

nfl_player_stats

Free tier

Player stats

PREFERRED for season-level player stats (passing, rushing, or receiving aggregates by season). Does NOT return weekly game logs (use nfl_game_log), fantasy points, defensive players, or kickers. stat_type defaults to passing — set stat_type='rushing' or 'receiving' for non-QBs. Identify the player by name or by gsis_id alone (ids returned by other tools can be passed straight through). If the player name is ambiguous, retry this same call with team or gsis_id from the error candidates.

Minimum tier: Free
Data coverage: 2013 onwards seasons

Parameters

Name	Type	Required	Description
`player`	string	Optional	Player name — full ('Justin Jefferson') or short ('J.Jefferson') both accepted. Optional when gsis_id is supplied.
`team`	string	Optional	Optional current/recent team abbreviation (for example BUF) to disambiguate identical names.
`gsis_id`	string	Optional	Exact NFL GSIS player id (for example 00-0034857); the preferred stable selector. Sufficient on its own — no player name required.
`season`	integer	Optional	Exact season year. Omit for all seasons.
`season_from`	integer	Optional	Start of season range (inclusive), e.g. 2020 for 'since 2020'
`season_to`	integer	Optional	End of season range (inclusive)
`season_type`	string	Optional	Filter by season type: REG (regular season) or POST (playoffs)Options: REG, POST
`stat_type`	string	Optional	Type of stats to return (default: passing)Options: passing, rushing, receivingDefault: passing

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_stats",
    "arguments": {
      "player": "Patrick Mahomes",
      "season": 2024,
      "stat_type": "passing"
    }
  }
}'

Example response

{
  "player": "Patrick Mahomes",
  "gsis_id": "00-0033873",
  "team": "KC",
  "position": "QB",
  "stat_type": "passing",
  "seasons": [
    {
      "season": 2024,
      "season_type": "POST",
      "attempts": 97,
      "completions": 55,
      "comp_pct": 56.7,
      "yards": 679,
      "touchdowns": 5,
      "interceptions": 2,
      "avg_epa": 0.014,
      "avg_cpoe": 0.486,
      "air_yards": 588,
      "avg_air_yards": 7.1
    },
    {
      "season": 2024,
      "season_type": "REG",
      "attempts": 617,
      "completions": 392,
      "comp_pct": 63.5,
      "yards": 3928,
      "touchdowns": 26,
      "interceptions": 11,
      "avg_epa": 0.109,
      "avg_cpoe": 2.563,
      "air_yards": 3682,
      "avg_air_yards": 6.4
    }
  ],
  "_units": {
    "comp_pct": "percent (0-100)",
    "avg_cpoe": "percentage points over expected",
    "avg_epa": "expected points added per play"
  }
}

All tools