Stats + aggregation5 credits
get_team_stats
Team totals and per-week lines with EPA, success rate, and situational splits
When to use it
You are profiling one team: season totals across every phase, EPA per play, and the weekly lines to chart trends.
Parameters
| Name | Type | Required | Description |
|---|---|---|---|
| team | string | yes | Team code (e.g. KC, BUF, PHI) |
| season | string | number | no | Season year (e.g. 2025). Defaults to current. |
| 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_team_stats \
-H "Content-Type: application/json" \
-H "x-api-key: YOUR_API_KEY" \
-d '{
"team": "KC",
"season": 2025
}'Over MCP, ask for it in plain English and the client calls get_team_stats itself. Point any MCP client at https://football-mcp-production.up.railway.app/mcp?key=YOUR_API_KEY.
Response
json
{
"team": {
"abbrev": "KC",
"name": "Kansas City Chiefs",
"nick": "Chiefs",
"conference": "AFC",
"division": "AFC West",
"teamId": "2310",
"color": "#E31837",
"color2": "#FFB612",
"color3": "#000000",
"color4": "#e31837",
"logoEspn": "https://a.espncdn.com/i/teamlogos/nfl/500/kc.png",
"logoWikipedia": "https://upload.wikimedia.org/wikipedia/en/thumb/e/e1/Kansas_City_Chiefs_logo.svg/100px-Kansas_City_Chiefs_logo.svg.png",
"logoSquared": "https://github.com/nflverse/nflverse-pbp/raw/master/squared_logos/KC.png",
"wordmark": "https://github.com/nflverse/nflverse-pbp/raw/master/wordmarks/KC.png",
"active": true,
"relocatedTo": null
},
"season": 2025,
"season_type": "REG",
"record": {
"season": 2025,
"team": "KC",
"wins": 6,
"losses": 11,
"ties": 0,
"winPct": 0.3529412,
"pointsFor": 362,
"pointsAgainst": 328,
"pointDiff": 34,
"homeWins": 5,
"homeLosses": 4,
"homeTies": 0,
"awayWins": 1,
"awayLosses": 7,
"awayTies": 0,
"divWins": 1,
"divLosses": 5,
"divTies": 0,
"confWins": 3,
"confLosses": 9,
"confTies": 0,
"streak": "L6",
"gamesPlayed": 17,
"divisionRank": 3,
"conferenceRank": 12,
"divisionTiebreaker": "record",
"conferenceTiebreaker": "record",
"updatedAt": "2026-09-17T23:13:47.596Z"
},
"totals": {
"games": 17,
"completions": 363,
"attempts": 584,
"passing_yards": 3947,
"passing_tds": 23,
"passing_interceptions": 12,
"sacks_suffered": 47,
"sack_yards_lost": -308,
"passing_air_yards": 4533,
"passing_yards_after_catch": 2110,
"passing_first_downs": 189,
"passing_epa": 24.884,
"carries": 430,
"rushing_yards": 1812,
"rushing_tds": 15,
"rushing_fumbles_lost": 2,
"rushing_first_downs": 122,
"rushing_epa": 8.47,
"receptions": 363,
"targets": 549,
"receiving_yards": 3947,
"receiving_tds": 23,
"receiving_epa": 109.251,
"def_tackles_solo": 608,
"def_tackles_with_assist": 18,
"def_tackles_for_loss": 74,
"def_fumbles_forced": 8,
"def_sacks": 33,
"def_qb_hits": 103,
"def_interceptions": 10,
"def_pass_defended": 60,
"def_tds": 0,
"penalties": 119,
"penalty_yards": 951,
"fumbles_total": 17,
"fumbles_lost_total": 3,
"fg_made": 33,
"fg_att": 38,
"pat_made": 31,
"pat_att": 35,
"punt_returns": 32,
"punt_return_yards": 259,
"kickoff_returns": 66,
"kickoff_return_yards": 1727,
"passing_epa_per_play": 0.039,
"rushing_epa_per_play": 0.02,
"yards_per_attempt": 6.76,
"yards_per_carry": 4.21
},
"weeks": [
{
"season": 2025,
"week": 1,
"team": "KC",
"seasonType": "REG",
"gameId": "2025_01_KC_LAC",
"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": 17,
"rushingYards": 98,
"rushingTds": 1,
"rushingFumbles": 0,
"rushingFumblesLost": 0,
"rushingFirstDowns": 8,
"rushingEpa": 8.906441,
"rushing2ptConversions": 0,
"rushing10": 5,
"rushing12": 1,
"rushing20": 0,
"rushing40": 0,
"receptions": 24,
"targets": 38,
"receivingYards": 258,
"receivingTds": 1,
"receivingFumbles": 0,
"receivingFumblesLost": 0,
"receivingAirYards": 271,
"receivingYardsAfterCatch": 116,
"receivingFirstDowns": 9,
"receivingEpa": 5.5701094,
"receiving2ptConversions": 0,
"receiving10": 9,
"receiving16": 4,
"receiving20": 3,
"receiving40": 1,
"specialTeamsTds": 0,
"defTacklesSolo": 40,
"defTacklesWithAssist": 2,
"defTackleAssists": 18,
"defTacklesForLoss": 6,
"defTacklesForLossYards": 17,
"defFumblesForced": 1,
"defSacks": 3,
"defSackYards": 14,
"defQbHits": 4,
"defInterceptions": 0,
"defInterceptionYards": 0,
"defPassDefended": 2,
"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": 10,
"penaltyYards": 71,
"fumblesForcedByOpp": 0,
"fumblesNotForced": 1,
"fumblesOutOfBounds": 0,
"fumblesTotal": 1,
"fumblesLostTotal": 0,
"puntReturns": 2,
"puntReturnYards": 7,
"kickoffReturns": 5,
"kickoffReturnYards": 147,
"fgMade": 3,
"fgAtt": 3,
"fgMissed": 0,
"fgBlocked": 0,
"fgLong": 59,
"fgPct": 1,
"fgMade019": 0,
"fgMade2029": 1,
"fgMade3039": 1,
"fgMade4049": 0,
"fgMade5059": 1,
"fgMade60": 0,
"fgMissed019": 0,
"fgMissed2029": 0,
"fgMissed3039": 0,
"fgMissed4049": 0,
"fgMissed5059": 0,
"fgMissed60": 0,
"fgMadeList": "35;59;27",
"fgMissedList": null,
"fgBlockedList": null,
"fgMadeDistance": 121,
"fgMissedDistance": 0,
"fgBlockedDistance": 0,
"patMade": 0,
"patAtt": 1,
"patMissed": 1,
"patBlocked": 0,
"patPct": 0,
"gwfgMade": 0,
"gwfgAtt": 0,
"gwfgMissed": 0,
"gwfgBlocked": 0,
"gwfgDistance": 0,
"ptAtt": 3,
"ptBlocked": 0,
"ptLong": 40,
"ptYards": 116,
"ptInside20": 1,
"ptOutOfBounds": 1,
"ptDowned": 1,
"ptTouchback": 0,
"ptFairCaught": 1,
"ptReturned": 0,
"ptReturnYards": 0,
"ptReturnTds": 0,
"ptNetYards": 116,
"timeouts": 6
},
{
"season": 2025,
"week": 2,
"team": "KC",
"seasonType": "REG",
"gameId": "2025_02_PHI_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": 26,
"rushingYards": 121,
"rushingTds": 1,
"rushingFumbles": 1,
"rushingFumblesLost": 0,
"rushingFirstDowns": 9,
"rushingEpa": -0.5581932,
"rushing2ptConversions": 0,
"rushing10": 4,
"rushing12": 2,
"rushing20": 1,
"rushing40": 0,
"receptions": 16,
"targets": 29,
"receivingYards": 187,
"receivingTds": 1,
"receivingFumbles": 0,
"receivingFumblesLost": 0,
"receivingAirYards": 309,
"receivingYardsAfterCatch": 68,
"receivingFirstDowns": 7,
"receivingEpa": -3.5375352,
"receiving2ptConversions": 0,
"receiving10": 8,
"receiving16": 5,
"receiving20": 3,
"receiving40": 1,
"specialTeamsTds": 0,
"defTacklesSolo": 37,
"defTacklesWithAssist": 0,
"defTackleAssists": 30,
"defTacklesForLoss": 5,
"defTacklesForLossYards": 11,
"defFumblesForced": 0,
"defSacks": 1,
"defSackYards": 4,
"defQbHits": 3,
"defInterceptions": 0,
"defInterceptionYards": 0,
"defPassDefended": 4,
"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": 6,
"penaltyYards": 45,
"fumblesForcedByOpp": 1,
"fumblesNotForced": 0,
"fumblesOutOfBounds": 0,
"fumblesTotal": 1,
"fumblesLostTotal": 0,
"puntReturns": 2,
"puntReturnYards": 42,
"kickoffReturns": 4,
"kickoffReturnYards": 95,
"fgMade": 1,
"fgAtt": 2,
"fgMissed": 1,
"fgBlocked": 0,
"fgLong": 56,
"fgPct": 0.5,
"fgMade019": 0,
"fgMade2029": 0,
"fgMade3039": 0,
"fgMade4049": 0,
"fgMade5059": 1,
"fgMade60": 0,
"fgMissed019": 0,
"fgMissed2029": 0,
"fgMissed3039": 0,
"fgMissed4049": 0,
"fgMissed5059": 1,
"fgMissed60": 0,
"fgMadeList": "56",
"fgMissedList": "58",
"fgBlockedList": null,
"fgMadeDistance": 56,
"fgMissedDistance": 58,
"fgBlockedDistance": 0,
"patMade": 2,
"patAtt": 2,
"patMissed": 0,
"patBlocked": 0,
"patPct": 1,
"gwfgMade": 0,
"gwfgAtt": 0,
"gwfgMissed": 0,
"gwfgBlocked": 0,
"gwfgDistance": 0,
"ptAtt": 3,
"ptBlocked": 0,
"ptLong": 69,
"ptYards": 178,
"ptInside20": 2,
"ptOutOfBounds": 0,
"ptDowned": 0,
"ptTouchback": 0,
"ptFairCaught": 2,
"ptReturned": 1,
"ptReturnYards": 14,
"ptReturnTds": 0,
"ptNetYards": 164,
"timeouts": 4
},
{
"season": 2025,
"week": 3,
"team": "KC",
"seasonType": "REG",
"gameId": "2025_03_KC_NYG",
"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": 28,
"rushingYards": 105,
"rushingTds": 1,
"rushingFumbles": 0,
"rushingFumblesLost": 0,
"rushingFirstDowns": 6,
"rushingEpa": 0.2622928,
"rushing2ptConversions": 0,
"rushing10": 2,
"rushing12": 0,
"rushing20": 0,
"rushing40": 0,
"receptions": 22,
"targets": 35,
"receivingYards": 224,
"receivingTds": 1,
"receivingFumbles": 0,
"receivingFumblesLost": 0,
"receivingAirYards": 319,
"receivingYardsAfterCatch": 112,
"receivingFirstDowns": 13,
"receivingEpa": 10.824478,
"receiving2ptConversions": 0,
"receiving10": 10,
"receiving16": 5,
"receiving20": 3,
"receiving40": 0,
"specialTeamsTds": 0,
"defTacklesSolo": 34,
"defTacklesWithAssist": 3,
"defTackleAssists": 35,
"defTacklesForLoss": 6,
"defTacklesForLossYards": 14,
"defFumblesForced": 0,
"defSacks": 2,
"defSackYards": 9,
"defQbHits": 9,
"defInterceptions": 2,
"defInterceptionYards": 23,
"defPassDefended": 6,
"defTds": 0,
"defFumbles": 0,
"defSafeties": 0,
"defPuntBlocks": 0,
"defPatBlocks": 1,
"defFgBlocks": 0,
"def2ptAtts": 0,
"def2ptMade": 0,
"miscYards": 0,
"fumbleRecoveryOwn": 2,
"fumbleRecoveryYardsOwn": 0,
"fumbleRecoveryOpp": 0,
"fumbleRecoveryYardsOpp": 0,
"fumbleRecoveryTds": 0,
"penalties": 8,
"penaltyYards": 85,
"fumblesForcedByOpp": 1,
"fumblesNotForced": 1,
"fumblesOutOfBounds": 0,
"fumblesTotal": 2,
"fumblesLostTotal": 0,
"puntReturns": 1,
"puntReturnYards": 4,
"kickoffReturns": 3,
"kickoffReturnYards": 63,
"fgMade": 3,
"fgAtt": 4,
"fgMissed": 1,
"fgBlocked": 0,
"fgLong": 54,
"fgPct": 0.75,
"fgMade019": 0,
"fgMade2029": 1,
"fgMade3039": 0,
"fgMade4049": 1,
"fgMade5059": 1,
"fgMade60": 0,
"fgMissed019": 0,
"fgMissed2029": 0,
"fgMissed3039": 0,
"fgMissed4049": 1,
"fgMissed5059": 0,
"fgMissed60": 0,
"fgMadeList": "54;48;28",
"fgMissedList": "40",
"fgBlockedList": null,
"fgMadeDistance": 130,
"fgMissedDistance": 40,
"fgBlockedDistance": 0,
"patMade": 1,
"patAtt": 2,
"patMissed": 1,
"patBlocked": 0,
"patPct": 0.5,
"gwfgMade": 0,
"gwfgAtt": 0,
"gwfgMissed": 0,
"gwfgBlocked": 0,
"gwfgDistance": 0,
"ptAtt": 3,
"ptBlocked": 0,
"ptLong": 53,
"ptYards": 139,
"ptInside20": 0,
"ptOutOfBounds": 0,
"ptDowned": 1,
"ptTouchback": 0,
"ptFairCaught": 0,
"ptReturned": 2,
"ptReturnYards": 17,
"ptReturnTds": 0,
"ptNetYards": 122,
"timeouts": 3
}
],
"count": 17
}Response fields
| Field | Type | Description |
|---|---|---|
| team | object | |
| team.abbrev | string | |
| team.name | string | |
| team.nick | string | |
| team.conference | string | |
| team.division | string | |
| team.teamId | string | |
| team.color | string | |
| team.color2 | string | |
| team.color3 | string | |
| team.color4 | string | |
| team.logoEspn | string | |
| team.logoWikipedia | string | |
| team.logoSquared | string | |
| team.wordmark | string | |
| team.active | boolean | |
| team.relocatedTo | null | |
| season | number | |
| season_type | string | |
| record | object | |
| record.season | number | |
| record.team | string | |
| record.wins | number | |
| record.losses | number | |
| record.ties | number | |
| record.winPct | number | |
| record.pointsFor | number | |
| record.pointsAgainst | number | |
| record.pointDiff | number | |
| record.homeWins | number | |
| record.homeLosses | number | |
| record.homeTies | number | |
| record.awayWins | number | |
| record.awayLosses | number | |
| record.awayTies | number | |
| record.divWins | number | |
| record.divLosses | number | |
| record.divTies | number | |
| record.confWins | number | |
| record.confLosses | number |
Related endpoints
list_teams1 cr
Returns the team this one takes.
All 32 teams with conference, division, colours, and logos
get_depth_chart2 cr
Takes the team this one returns.
Team depth chart by week
get_game_detail10 cr
Returns the team this one takes.
Full game detail with team stats, starting QBs, odds, weather, and officials
get_schedule2 cr
Takes the team this one returns.
Upcoming games by week or for the next N days
Try it
500 credits free on signup — 100 calls to get_team_stats — and no card.