Documentation menu

nfl_team_stats

Free tier

Team stats

Use for team-level questions. Returns pre-aggregated offense, defense, and situational stats. Always use this instead of nfl_query for questions like 'how did [team] do', team rankings, or team efficiency.

Minimum tier: Free
Data coverage: Varies by query

Parameters

Name	Type	Required	Description
`team`	string	Required	Team abbreviation (e.g. KC, PHI, BUF, BAL)
`season`	integer	Optional	Season year. Omit for all available seasons.
`side`	string	Optional	Which stats to return (default: both offense + defense + situational)Options: offense, defense, situational, bothDefault: both
`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_team_stats",
    "arguments": {
      "team": "KC",
      "season": 2024
    }
  }
}'

Example response

Excerpt · lists trimmed

{
  "offense": [
    {
      "team": "KC",
      "season_year": 2024,
      "total_plays": 1595,
      "total_yards": 6431,
      "yards_per_play": 4.05,
      "rush_plays": 518,
      "pass_plays": 741,
      "rush_yards": 2024,
      "pass_yards": 4407,
      "yards_per_rush": 3.91,
      "yards_per_pass": 5.95,
      "touchdowns": 51,
      "turnovers": 19,
      "third_down_pct": 43.6,
      "red_zone_td_pct": 13,
      "explosive_plays": 94,
      "avg_epa": 0.048,
      "pass_epa": 0.083,
      "rush_epa": -0.002
    }
  ],
  "defense": [
    {
      "team": "KC",
      "season_year": 2024,
      "plays_against": 1588,
      "yards_allowed": 6508,
      "yards_per_play_allowed": 4.11,
      "sacks": 51,
      "interceptions": 14,
      "turnovers_forced": 20,
      "third_down_stop_pct": 60.5,
      "avg_epa_allowed": 0.011
    }
  ],
  "situational": [
    {
      "team": "KC",
      "season_year": 2024,
      "situation": "3rd & Long",
      "plays": 124,
      "avg_yards": 5.11,
      "touchdowns": 4,
      "conversion_pct": 27.4,
      "avg_epa": 0.012
    },
    {
      "team": "KC",
      "season_year": 2024,
      "situation": "3rd & Short",
      "plays": 87,
      "avg_yards": 2.8,
      "touchdowns": 6,
      "conversion_pct": 56.3,
      "avg_epa": -0.03
    },
    {
      "team": "KC",
      "season_year": 2024,
      "situation": "4th Down",
      "plays": 136,
      "avg_yards": 0.32,
      "touchdowns": 2,
      "conversion_pct": 10.3,
      "avg_epa": 0.123
    }
  ]
}

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