search_players

1 creditStatic referencePOST /v1/search_players

Find a player's id by name, or list a team's players

Use it when you have a name and need the player id. Cricsheet's short form ("V Kohli") and the full name both match.

Parameters

namestringoptional: Part of the name, e.g. "kohli".
team_idstringoptional: Team id from list_teams.
limitintegeroptional
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 search_players 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/search_players \
  -H "Content-Type: application/json" \
  -H "x-api-key: YOUR_API_KEY" \
  -d '{
  "name": "kohli"
}'

Response

json

{
  "players": [
    {
      "player_id": "ba607b88",
      "name": "V Kohli",
      "full_name": "Virat Kohli",
      "matches": 837,
      "last_match": "2026-10-03",
      "last_team": "India"
    },
    {
      "player_id": "eb9082b2",
      "name": "A Kohli",
      "full_name": null,
      "matches": 41,
      "last_match": "2026-08-30",
      "last_team": "Germany"
    },
    {
      "player_id": "40caa465",
      "name": "T Kohli",
      "full_name": "Taruwar Kohli",
      "matches": 30,
      "last_match": "2022-10-20",
      "last_team": "Mizoram"
    }
  ],
  "count": 6
}