list_teams

1 creditStatic referencePOST /v1/list_teams

Team ids for international sides and franchises, men's and women's

Use it when you need team ids, for one competition or season, or by part of a name.

Parameters

competitionstringoptional: Competition key from list_competitions (ipl, bbl, psl, blast, hundred, county, test, odi, t20i, ...).
seasonstringoptional: Season: a year (2024) or a split season (2024/25); a year also finds the split season that starts in it.
genderenum: male | femaleoptional
searchstringoptional: Part of the team name.
leagueenum: cricket | test | odi | t20i | ipl | bbl | psl | cpl | blast | hundred | sa20 | ilt20 | county | wbbl | wpl | hundred_womenoptional: League. Defaults to cricket. One of: cricket, test, odi, t20i, ipl, bbl, psl, cpl, blast, hundred, sa20, ilt20, county, wbbl, wpl, hundred_women.

Notes

Over MCP, ask for it in plain English and the client calls list_teams itself. Point any MCP client at https://mcp.yorkerapi.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.yorkerapi.com/v1/list_teams \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "competition": "ipl",
  "season": "2025"
}'

Response

json

{
  "teams": [
    {
      "team_id": "punjab-kings",
      "name": "Punjab Kings",
      "gender": "male",
      "team_type": "club",
      "now_plays_as": null,
      "matches": 18,
      "last_match": "2025-06-03"
    },
    {
      "team_id": "mumbai-indians",
      "name": "Mumbai Indians",
      "gender": "male",
      "team_type": "club",
      "now_plays_as": null,
      "matches": 16,
      "last_match": "2025-06-01"
    },
    {
      "team_id": "delhi-capitals",
      "name": "Delhi Capitals",
      "gender": "male",
      "team_type": "club",
      "now_plays_as": null,
      "matches": 15,
      "last_match": "2025-05-24"
    }
  ],
  "count": 10
}