Documentation menu

nfl_snap_counts

Free tier

Snap counts

Use for snap count questions. Look up how many offensive, defensive, and special teams snaps a player or team unit played. Filter by player, team, season, week, or position.

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.
`team`	string	Optional	Team abbreviation (e.g. KC, PHI)
`season`	integer	Optional	Season year. Omit for all seasons.
`week`	integer	Optional	Week number (1–22).
`position`	string	Optional	Position filter (e.g. TE, WR, CB).
`limit`	integer	Optional	Max rows per page (default 100, max 500).
`offset`	integer	Optional	Row offset for pagination; pass the returned next_offset for the next page.
`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_snap_counts",
    "arguments": {
      "player": "Isiah Pacheco",
      "season": 2024,
      "week": 1
    }
  }
}'

Example response

{
  "snap_counts": [
    {
      "player": "Isiah Pacheco",
      "position": "RB",
      "team": "KC",
      "opponent": "BAL",
      "season": 2024,
      "week": 1,
      "game_type": "REG",
      "offense_snaps": 43,
      "offense_pct": 0.8,
      "defense_snaps": 0,
      "defense_pct": 0,
      "st_snaps": 0,
      "st_pct": 0
    }
  ],
  "count": 1
}

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