Documentation menu

nfl_roster

Free tier

Rosters

Use for roster questions. Look up who was on a team's roster in a given season. Returns name, position, jersey number, experience, college, height, and weight. Filter by team, season, and/or position.

Minimum tier: Free
Data coverage: Varies by query

Parameters

Name	Type	Required	Description
`team`	string	Optional	Team abbreviation (e.g. KC, PHI, BUF)
`season`	integer	Optional	Season year (e.g. 2024). Omit for all seasons.
`position`	string	Optional	Position filter (e.g. QB, WR, LB). Partial match supported.
`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_roster",
    "arguments": {
      "team": "KC",
      "season": 2024,
      "position": "QB"
    }
  }
}'

Example response

{
  "players": [
    {
      "full_name": "Carson Wentz",
      "position": "QB",
      "depth_chart_position": "QB",
      "team": "KC",
      "season": 2024,
      "jersey_number": "11",
      "status": "ACT",
      "years_exp": 8,
      "college": "North Dakota State",
      "height": 77,
      "weight": 237
    },
    {
      "full_name": "Chris Oladokun",
      "position": "QB",
      "depth_chart_position": "QB",
      "team": "KC",
      "season": 2024,
      "jersey_number": "19",
      "status": "DEV",
      "years_exp": 2,
      "college": "South Dakota State",
      "height": 73,
      "weight": 195
    },
    {
      "full_name": "Patrick Mahomes",
      "position": "QB",
      "depth_chart_position": "QB",
      "team": "KC",
      "season": 2024,
      "jersey_number": "15",
      "status": "ACT",
      "years_exp": 7,
      "college": "Texas Tech",
      "height": 74,
      "weight": 230
    }
  ],
  "count": 3
}

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