list_teams

1 creditStatic referencePOST /v1/list_teams

Team ids, abbreviations and colours for a season

Use it when you need team ids and abbreviations for a season. Every other endpoint takes a team as either.

Parameters

seasonnumber | stringoptional: Season (a year, e.g. 2025; default: the latest).

Notes

Over MCP, ask for it in plain English and the client calls list_teams itself. Point any MCP client at https://mcp.fastballapi.com/mcp?key=YOUR_API_KEY.
Each call costs 1 credit, taken before it runs and refunded if the server errors.
Not the call you need? Find the right call by what you are trying to answer.

Request

curl -X POST https://mcp.fastballapi.com/v1/list_teams \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "season": 2024
}'

Response

json

{
  "season": 2024,
  "teams": [
    {
      "team_id": "29",
      "abbrev": "ARI",
      "name": "Diamondbacks",
      "display_name": "Arizona Diamondbacks",
      "location": "Arizona",
      "color": "aa182c",
      "logo": "https://a.espncdn.com/i/teamlogos/mlb/500/ari.png"
    },
    {
      "team_id": "11",
      "abbrev": "ATH",
      "name": "Athletics",
      "display_name": "Athletics",
      "location": "Athletics",
      "color": "003831",
      "logo": "https://a.espncdn.com/i/teamlogos/mlb/500/ath.png"
    },
    {
      "team_id": "15",
      "abbrev": "ATL",
      "name": "Braves",
      "display_name": "Atlanta Braves",
      "location": "Atlanta",
      "color": "0c2340",
      "logo": "https://a.espncdn.com/i/teamlogos/mlb/500/atl.png"
    }
  ],
  "count": 30
}