Stats + aggregation5 credits

get_player_stats

Weekly and season stat lines for one player: passing, rushing, receiving, defense, kicking, fantasy

When to use it

You are building a player page or projection input: bio, season totals, and every weekly line in one call.

Parameters

Name	Type	Required	Description
player_id	string	yes	GSIS player id from search_players (e.g. 00-0033873)
season	string \| number	no	Season year. Defaults to the player's latest season.
season_type	enum: REG \| POST	no	Regular season (default) or postseason

Request

bash

curl -X POST https://football-mcp-production.up.railway.app/v1/get_player_stats \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "player_id": "00-0033873",
  "season": 2025
}'

Over MCP, ask for it in plain English and the client calls get_player_stats itself. Point any MCP client at https://football-mcp-production.up.railway.app/mcp?key=YOUR_API_KEY.

Response

json

{
  "player": {
    "gsisId": "00-0033873",
    "displayName": "Patrick Mahomes",
    "firstName": "Patrick",
    "lastName": "Mahomes",
    "footballName": "Patrick",
    "suffix": null,
    "position": "QB",
    "positionGroup": "QB",
    "ngsPosition": "QB",
    "height": 74,
    "weight": 225,
    "birthDate": "1995-09-17",
    "college": "Texas Tech",
    "collegeConference": "Big Twelve Conference",
    "jerseyNumber": "15",
    "rookieSeason": 2017,
    "lastSeason": 2026,
    "latestTeam": "KC",
    "status": "ACT",
    "yearsOfExperience": 10,
    "draftYear": 2017,
    "draftRound": 1,
    "draftPick": 10,
    "draftTeam": "KC",
    "headshot": "https://static.www.nfl.com/image/upload/f_auto,q_auto/league/wdckwtob1lybvkmxnf7p",
    "esbId": "MAH401939",
    "nflId": "44822",
    "pfrId": "MahoPa00",
    "pffId": "11765",
    "otcId": "5594",
    "espnId": "3139477",
    "smartId": "32004d41-4840-1939-e4c1-bb89191b4e71",
    "sleeperId": null,
    "active": true,
    "team_name": "Kansas City Chiefs"
  },
  "season": 2025,
  "season_type": "REG",
  "season_totals": {
    "games": 14,
    "completions": 315,
    "attempts": 502,
    "passing_yards": 3587,
    "passing_tds": 22,
    "passing_interceptions": 11,
    "sacks_suffered": 34,
    "sack_yards_lost": -193,
    "sack_fumbles": 3,
    "passing_air_yards": 4050,
    "passing_yards_after_catch": 1895,
    "passing_first_downs": 173,
    "passing_epa": 68.247,
    "passing_2pt_conversions": 2,
    "passing_10": 146,
    "passing_16": 72,
    "passing_20": 49,
    "passing_40": 8,
    "carries": 64,
    "rushing_yards": 422,
    "rushing_tds": 5,
    "rushing_first_downs": 27,
    "rushing_epa": 29.164,
    "rushing_10": 18,
    "rushing_12": 10,
    "rushing_20": 1,
    "receptions": 1,
    "targets": 1,
    "receiving_yards": -10,
    "receiving_air_yards": -8,
    "receiving_yards_after_catch": -2,
    "receiving_epa": -2.539,
    "def_tackles_solo": 1,
    "fumble_recovery_own": 3,
    "penalties": 3,
    "penalty_yards": 25,
    "fumbles_forced_by_opp": 2,
    "fumbles_not_forced": 1,
    "fumbles_total": 3,
    "fantasy_points": 284.68,
    "fantasy_points_ppr": 285.68
  },
  "weeks": [
    {
      "position": "QB",
      "positionGroup": "QB",
      "season": 2025,
      "week": 1,
      "seasonType": "REG",
      "gameId": "2025_01_KC_LAC",
      "team": "KC",
      "opponentTeam": "LAC",
      "completions": 24,
      "attempts": 39,
      "passingYards": 258,
      "passingTds": 1,
      "passingInterceptions": 0,
      "sacksSuffered": 2,
      "sackYardsLost": -9,
      "sackFumbles": 0,
      "sackFumblesLost": 0,
      "passingAirYards": 271,
      "passingYardsAfterCatch": 116,
      "passingFirstDowns": 9,
      "passingEpa": 3.4485526,
      "passingCpoe": -5.9927764,
      "passing2ptConversions": 0,
      "passing10": 9,
      "passing16": 4,
      "passing20": 3,
      "passing40": 1,
      "carries": 6,
      "rushingYards": 57,
      "rushingTds": 1,
      "rushingFumbles": 0,
      "rushingFumblesLost": 0,
      "rushingFirstDowns": 5,
      "rushingEpa": 7.2114673,
      "rushing2ptConversions": 0,
      "rushing10": 4,
      "rushing12": 1,
      "rushing20": 0,
      "rushing40": 0,
      "receptions": 0,
      "targets": 0,
      "receivingYards": 0,
      "receivingTds": 0,
      "receivingFumbles": 0,
      "receivingFumblesLost": 0,
      "receivingAirYards": 0,
      "receivingYardsAfterCatch": 0,
      "receivingFirstDowns": 0,
      "receivingEpa": null,
      "receiving2ptConversions": 0,
      "receiving10": 0,
      "receiving16": 0,
      "receiving20": 0,
      "receiving40": 0,
      "specialTeamsTds": 0,
      "defTacklesSolo": 0,
      "defTacklesWithAssist": 0,
      "defTackleAssists": 0,
      "defTacklesForLoss": 0,
      "defTacklesForLossYards": 0,
      "defFumblesForced": 0,
      "defSacks": 0,
      "defSackYards": 0,
      "defQbHits": 0,
      "defInterceptions": 0,
      "defInterceptionYards": 0,
      "defPassDefended": 0,
      "defTds": 0,
      "defFumbles": 0,
      "defSafeties": 0,
      "defPuntBlocks": 0,
      "defPatBlocks": 0,
      "defFgBlocks": 0,
      "def2ptAtts": 0,
      "def2ptMade": 0,
      "miscYards": 0,
      "fumbleRecoveryOwn": 1,
      "fumbleRecoveryYardsOwn": 0,
      "fumbleRecoveryOpp": 0,
      "fumbleRecoveryYardsOpp": 0,
      "fumbleRecoveryTds": 0,
      "penalties": 0,
      "penaltyYards": 0,
      "fumblesForcedByOpp": 0,
      "fumblesNotForced": 0,
      "fumblesOutOfBounds": 0,
      "fumblesTotal": 0,
      "fumblesLostTotal": 0,
      "puntReturns": 0,
      "puntReturnYards": 0,
      "kickoffReturns": 0,
      "kickoffReturnYards": 0,
      "fgMade": 0,
      "fgAtt": 0,
      "fgMissed": 0,
      "fgBlocked": 0,
      "fgLong": null,
      "fgPct": null,
      "fgMade019": 0,
      "fgMade2029": 0,
      "fgMade3039": 0,
      "fgMade4049": 0,
      "fgMade5059": 0,
      "fgMade60": 0,
      "fgMissed019": 0,
      "fgMissed2029": 0,
      "fgMissed3039": 0,
      "fgMissed4049": 0,
      "fgMissed5059": 0,
      "fgMissed60": 0,
      "fgMadeList": null,
      "fgMissedList": null,
      "fgBlockedList": null,
      "fgMadeDistance": 0,
      "fgMissedDistance": 0,
      "fgBlockedDistance": 0,
      "patMade": 0,
      "patAtt": 0,
      "patMissed": 0,
      "patBlocked": 0,
      "patPct": null,
      "gwfgMade": 0,
      "gwfgAtt": 0,
      "gwfgMissed": 0,
      "gwfgBlocked": 0,
      "gwfgDistance": 0,
      "ptAtt": 0,
      "ptBlocked": 0,
      "ptLong": null,
      "ptYards": 0,
      "ptInside20": 0,
      "ptOutOfBounds": 0,
      "ptDowned": 0,
      "ptTouchback": 0,
      "ptFairCaught": 0,
      "ptReturned": 0,
      "ptReturnYards": 0,
      "ptReturnTds": 0,
      "ptNetYards": 0,
      "pacr": 0.9520295,
      "racr": null,
      "targetShare": 0,
      "airYardsShare": 0,
      "wopr": 0,
      "fantasyPoints": 26.02,
      "fantasyPointsPpr": 26.02
    },
    {
      "position": "QB",
      "positionGroup": "QB",
      "season": 2025,
      "week": 2,
      "seasonType": "REG",
      "gameId": "2025_02_PHI_KC",
      "team": "KC",
      "opponentTeam": "PHI",
      "completions": 16,
      "attempts": 29,
      "passingYards": 187,
      "passingTds": 1,
      "passingInterceptions": 1,
      "sacksSuffered": 2,
      "sackYardsLost": -14,
      "sackFumbles": 0,
      "sackFumblesLost": 0,
      "passingAirYards": 309,
      "passingYardsAfterCatch": 68,
      "passingFirstDowns": 7,
      "passingEpa": -7.1535654,
      "passingCpoe": -5.841068,
      "passing2ptConversions": 0,
      "passing10": 8,
      "passing16": 5,
      "passing20": 3,
      "passing40": 1,
      "carries": 7,
      "rushingYards": 66,
      "rushingTds": 1,
      "rushingFumbles": 0,
      "rushingFumblesLost": 0,
      "rushingFirstDowns": 5,
      "rushingEpa": 6.408957,
      "rushing2ptConversions": 0,
      "rushing10": 3,
      "rushing12": 2,
      "rushing20": 1,
      "rushing40": 0,
      "receptions": 0,
      "targets": 0,
      "receivingYards": 0,
      "receivingTds": 0,
      "receivingFumbles": 0,
      "receivingFumblesLost": 0,
      "receivingAirYards": 0,
      "receivingYardsAfterCatch": 0,
      "receivingFirstDowns": 0,
      "receivingEpa": null,
      "receiving2ptConversions": 0,
      "receiving10": 0,
      "receiving16": 0,
      "receiving20": 0,
      "receiving40": 0,
      "specialTeamsTds": 0,
      "defTacklesSolo": 0,
      "defTacklesWithAssist": 0,
      "defTackleAssists": 0,
      "defTacklesForLoss": 0,
      "defTacklesForLossYards": 0,
      "defFumblesForced": 0,
      "defSacks": 0,
      "defSackYards": 0,
      "defQbHits": 0,
      "defInterceptions": 0,
      "defInterceptionYards": 0,
      "defPassDefended": 0,
      "defTds": 0,
      "defFumbles": 0,
      "defSafeties": 0,
      "defPuntBlocks": 0,
      "defPatBlocks": 0,
      "defFgBlocks": 0,
      "def2ptAtts": 0,
      "def2ptMade": 0,
      "miscYards": 0,
      "fumbleRecoveryOwn": 0,
      "fumbleRecoveryYardsOwn": 0,
      "fumbleRecoveryOpp": 0,
      "fumbleRecoveryYardsOpp": 0,
      "fumbleRecoveryTds": 0,
      "penalties": 0,
      "penaltyYards": 0,
      "fumblesForcedByOpp": 0,
      "fumblesNotForced": 0,
      "fumblesOutOfBounds": 0,
      "fumblesTotal": 0,
      "fumblesLostTotal": 0,
      "puntReturns": 0,
      "puntReturnYards": 0,
      "kickoffReturns": 0,
      "kickoffReturnYards": 0,
      "fgMade": 0,
      "fgAtt": 0,
      "fgMissed": 0,
      "fgBlocked": 0,
      "fgLong": null,
      "fgPct": null,
      "fgMade019": 0,
      "fgMade2029": 0,
      "fgMade3039": 0,
      "fgMade4049": 0,
      "fgMade5059": 0,
      "fgMade60": 0,
      "fgMissed019": 0,
      "fgMissed2029": 0,
      "fgMissed3039": 0,
      "fgMissed4049": 0,
      "fgMissed5059": 0,
      "fgMissed60": 0,
      "fgMadeList": null,
      "fgMissedList": null,
      "fgBlockedList": null,
      "fgMadeDistance": 0,
      "fgMissedDistance": 0,
      "fgBlockedDistance": 0,
      "patMade": 0,
      "patAtt": 0,
      "patMissed": 0,
      "patBlocked": 0,
      "patPct": null,
      "gwfgMade": 0,
      "gwfgAtt": 0,
      "gwfgMissed": 0,
      "gwfgBlocked": 0,
      "gwfgDistance": 0,
      "ptAtt": 0,
      "ptBlocked": 0,
      "ptLong": null,
      "ptYards": 0,
      "ptInside20": 0,
      "ptOutOfBounds": 0,
      "ptDowned": 0,
      "ptTouchback": 0,
      "ptFairCaught": 0,
      "ptReturned": 0,
      "ptReturnYards": 0,
      "ptReturnTds": 0,
      "ptNetYards": 0,
      "pacr": 0.605178,
      "racr": null,
      "targetShare": 0,
      "airYardsShare": 0,
      "wopr": 0,
      "fantasyPoints": 22.08,
      "fantasyPointsPpr": 22.08
    },
    {
      "position": "QB",
      "positionGroup": "QB",
      "season": 2025,
      "week": 3,
      "seasonType": "REG",
      "gameId": "2025_03_KC_NYG",
      "team": "KC",
      "opponentTeam": "NYG",
      "completions": 22,
      "attempts": 37,
      "passingYards": 224,
      "passingTds": 1,
      "passingInterceptions": 0,
      "sacksSuffered": 2,
      "sackYardsLost": -23,
      "sackFumbles": 2,
      "sackFumblesLost": 0,
      "passingAirYards": 319,
      "passingYardsAfterCatch": 112,
      "passingFirstDowns": 13,
      "passingEpa": 8.230807,
      "passingCpoe": -1.4937389,
      "passing2ptConversions": 0,
      "passing10": 10,
      "passing16": 5,
      "passing20": 3,
      "passing40": 0,
      "carries": 5,
      "rushingYards": 2,
      "rushingTds": 0,
      "rushingFumbles": 0,
      "rushingFumblesLost": 0,
      "rushingFirstDowns": 0,
      "rushingEpa": -1.5214161,
      "rushing2ptConversions": 0,
      "rushing10": 0,
      "rushing12": 0,
      "rushing20": 0,
      "rushing40": 0,
      "receptions": 0,
      "targets": 0,
      "receivingYards": 0,
      "receivingTds": 0,
      "receivingFumbles": 0,
      "receivingFumblesLost": 0,
      "receivingAirYards": 0,
      "receivingYardsAfterCatch": 0,
      "receivingFirstDowns": 0,
      "receivingEpa": null,
      "receiving2ptConversions": 0,
      "receiving10": 0,
      "receiving16": 0,
      "receiving20": 0,
      "receiving40": 0,
      "specialTeamsTds": 0,
      "defTacklesSolo": 0,
      "defTacklesWithAssist": 0,
      "defTackleAssists": 0,
      "defTacklesForLoss": 0,
      "defTacklesForLossYards": 0,
      "defFumblesForced": 0,
      "defSacks": 0,
      "defSackYards": 0,
      "defQbHits": 0,
      "defInterceptions": 0,
      "defInterceptionYards": 0,
      "defPassDefended": 0,
      "defTds": 0,
      "defFumbles": 0,
      "defSafeties": 0,
      "defPuntBlocks": 0,
      "defPatBlocks": 0,
      "defFgBlocks": 0,
      "def2ptAtts": 0,
      "def2ptMade": 0,
      "miscYards": 0,
      "fumbleRecoveryOwn": 1,
      "fumbleRecoveryYardsOwn": 0,
      "fumbleRecoveryOpp": 0,
      "fumbleRecoveryYardsOpp": 0,
      "fumbleRecoveryTds": 0,
      "penalties": 0,
      "penaltyYards": 0,
      "fumblesForcedByOpp": 1,
      "fumblesNotForced": 1,
      "fumblesOutOfBounds": 0,
      "fumblesTotal": 2,
      "fumblesLostTotal": 0,
      "puntReturns": 0,
      "puntReturnYards": 0,
      "kickoffReturns": 0,
      "kickoffReturnYards": 0,
      "fgMade": 0,
      "fgAtt": 0,
      "fgMissed": 0,
      "fgBlocked": 0,
      "fgLong": null,
      "fgPct": null,
      "fgMade019": 0,
      "fgMade2029": 0,
      "fgMade3039": 0,
      "fgMade4049": 0,
      "fgMade5059": 0,
      "fgMade60": 0,
      "fgMissed019": 0,
      "fgMissed2029": 0,
      "fgMissed3039": 0,
      "fgMissed4049": 0,
      "fgMissed5059": 0,
      "fgMissed60": 0,
      "fgMadeList": null,
      "fgMissedList": null,
      "fgBlockedList": null,
      "fgMadeDistance": 0,
      "fgMissedDistance": 0,
      "fgBlockedDistance": 0,
      "patMade": 0,
      "patAtt": 0,
      "patMissed": 0,
      "patBlocked": 0,
      "patPct": null,
      "gwfgMade": 0,
      "gwfgAtt": 0,
      "gwfgMissed": 0,
      "gwfgBlocked": 0,
      "gwfgDistance": 0,
      "ptAtt": 0,
      "ptBlocked": 0,
      "ptLong": null,
      "ptYards": 0,
      "ptInside20": 0,
      "ptOutOfBounds": 0,
      "ptDowned": 0,
      "ptTouchback": 0,
      "ptFairCaught": 0,
      "ptReturned": 0,
      "ptReturnYards": 0,
      "ptReturnTds": 0,
      "ptNetYards": 0,
      "pacr": 0.70219433,
      "racr": null,
      "targetShare": 0,
      "airYardsShare": 0,
      "wopr": 0,
      "fantasyPoints": 13.16,
      "fantasyPointsPpr": 13.16
    }
  ],
  "seasons": [
    {
      "season": 2026,
      "games": 1,
      "team": "KC"
    },
    {
      "season": 2025,
      "games": 14,
      "team": "KC"
    },
    {
      "season": 2024,
      "games": 16,
      "team": "KC"
    }
  ],
  "count": 14
}

Response fields

Field	Type	Description
player	object
player.gsisId	string
player.displayName	string
player.firstName	string
player.lastName	string
player.footballName	string
player.suffix	null
player.position	string
player.positionGroup	string
player.ngsPosition	string
player.height	number
player.weight	number
player.birthDate	string
player.college	string
player.collegeConference	string
player.jerseyNumber	string
player.rookieSeason	number
player.lastSeason	number
player.latestTeam	string
player.status	string
player.yearsOfExperience	number
player.draftYear	number
player.draftRound	number
player.draftPick	number
player.draftTeam	string
player.headshot	string
player.esbId	string
player.nflId	string
player.pfrId	string
player.pffId	string
player.otcId	string
player.espnId	string
player.smartId	string
player.sleeperId	null
player.active	boolean
player.team_name	string
season	number
season_type	string
season_totals	object
season_totals.games	number