Documentation menu

nfl_depth_chart

Pro tier

Depth charts

Team depth chart by position group. Defaults to the most recent published snapshot when week is omitted (depth charts update through the week). Coverage 2013-2026. Params: team (required), season, week, position_group.

Minimum tier: Pro
Data coverage: 2013 onwards seasons

Parameters

Name	Type	Required	Description
`team`	string	Required	Team abbreviation (e.g. KC, PHI).
`season`	integer	Optional	Season year.
`week`	integer	Optional	Week number. Omit for latest snapshot.
`position_group`	string	Optional	Optional position group filter (partial match).
`limit`	integer	Optional	Max rows (default 100, max 500).
`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_depth_chart",
    "arguments": {
      "team": "KC",
      "season": 2024,
      "position_group": "QB"
    }
  }
}'

Example response

{
  "team": "KC",
  "depth_chart": [],
  "count": 0,
  "hint": "no rows matched these filters: team=KC, season=2024"
}

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