search_players

1 creditStatic referencePOST /v1/search_players

Find players by name or country

Use it when you have a name and need the player id for the other endpoints. Accents are optional.

Parameters

namestringoptional: Part of the player's name, e.g. "sinner".
countrystringoptional: Three-letter country code, e.g. ESP.
limitintegeroptional: Max players (default 20).

Notes

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

Response

json

{
  "tour": "ATP",
  "players": [
    {
      "player_id": "3623",
      "name": "Jannik Sinner",
      "country": "ITA",
      "date_of_birth": "2001-08-16",
      "matches": 459,
      "last_match": "2026-07-12",
      "current_rank": 1,
      "plays": "right"
    }
  ],
  "count": 1
}