Static reference1 credit

list_teams

All 32 teams with conference, division, colours, and logos

When to use it

You need team codes for other endpoints, or conference/division groupings, colours and logo URLs for a UI.

Parameters

Name	Type	Required	Description
conference	enum: AFC \| NFC	no	Filter by conference
division	string	no	Filter by division, e.g. 'AFC East' or 'NFC West'

Request

bash

curl -X POST https://football-mcp-production.up.railway.app/v1/list_teams \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "division": "AFC West"
}'

Over MCP, ask for it in plain English and the client calls list_teams itself. Point any MCP client at https://football-mcp-production.up.railway.app/mcp?key=YOUR_API_KEY.

Response

json

{
  "teams": [
    {
      "abbrev": "DEN",
      "name": "Denver Broncos",
      "nick": "Broncos",
      "conference": "AFC",
      "division": "AFC West",
      "color": "#002244",
      "color2": "#FB4F14",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/den.png",
      "wordmark": "https://github.com/nflverse/nflverse-pbp/raw/master/wordmarks/DEN.png"
    },
    {
      "abbrev": "KC",
      "name": "Kansas City Chiefs",
      "nick": "Chiefs",
      "conference": "AFC",
      "division": "AFC West",
      "color": "#E31837",
      "color2": "#FFB612",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/kc.png",
      "wordmark": "https://github.com/nflverse/nflverse-pbp/raw/master/wordmarks/KC.png"
    },
    {
      "abbrev": "LV",
      "name": "Las Vegas Raiders",
      "nick": "Raiders",
      "conference": "AFC",
      "division": "AFC West",
      "color": "#000000",
      "color2": "#A5ACAF",
      "logo": "https://a.espncdn.com/i/teamlogos/nfl/500/lv.png",
      "wordmark": "https://github.com/nflverse/nflverse-pbp/raw/master/wordmarks/LV.png"
    }
  ],
  "count": 4
}

Response fields

Field	Type	Description
teams[]	array	List of objects
teams[].abbrev	string
teams[].name	string
teams[].nick	string
teams[].conference	string
teams[].division	string
teams[].color	string
teams[].color2	string
teams[].logo	string
teams[].wordmark	string
count	number