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).
leagueenum: mlb | ncaabaseoptional- League. Defaults to mlb. One of: mlb, ncaabase.
Notes
- Over MCP, ask for it in plain English and the client calls
list_teamsitself. Point any MCP client athttps://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": 2025
}'Response
json
{
"season": 2025,
"teams": [
{
"team_id": "29",
"abbrev": "ARI",
"name": "Diamondbacks",
"display_name": "Arizona Diamondbacks",
"location": "Arizona",
"color": "aa182c",
"logo": "https://fastballapi.com/logos/eL2kvdGVhbWxvZ29zL21sYi81MDAvYXJpLnBuZw.png"
},
{
"team_id": "11",
"abbrev": "ATH",
"name": "Athletics",
"display_name": "Athletics",
"location": "Athletics",
"color": "003831",
"logo": "https://fastballapi.com/logos/eL2kvdGVhbWxvZ29zL21sYi81MDAvYXRoLnBuZw.png"
},
{
"team_id": "15",
"abbrev": "ATL",
"name": "Braves",
"display_name": "Atlanta Braves",
"location": "Atlanta",
"color": "0c2340",
"logo": "https://fastballapi.com/logos/eL2kvdGVhbWxvZ29zL21sYi81MDAvYXRsLnBuZw.png"
}
],
"count": 30
}Response fields
seasonnumberteams[]array- List of objects
teams[].team_idstringteams[].abbrevstringteams[].namestringteams[].display_namestringteams[].locationstringteams[].colorstringteams[].logostringcountnumber
Related endpoints
get_games2 cr
Takes the team this one returns.
Games with runs, hits and errors by season, date, range or team
get_schedule2 cr
Takes the team this one returns.
Upcoming games with the median line across sportsbooks
search_players1 cr
Filters by the same league.
Find players by name
get_pitch_mix5 cr
Filters by the same season.
A pitcher's arsenal: usage, velocity, whiff rate per pitch type
Try it
500 free credits every month: 500 calls to list_teams, and no card.