Tournament catalogue
search_tournamentsFind tennis tournaments by name or tour, returning IDs plus surface, indoor, host city/country, and category for match lookups.
Instructions
Search the tournament catalogue. Its ids are the tournament_id that match objects carry. Returns surface, indoor, host city/country and category where curated. Works on the FREE plan (no card needed).
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_tournaments"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tour | No | Restrict to one tour. | |
| limit | No | Maximum tournaments to return (1-200). | |
| query | No | Full or partial tournament name, e.g. "wimbledon". Omit to list all. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | True when the request succeeded, including when the answer is an empty list. False for a missing or rejected key, a plan that does not include this data, an unknown id, a rate limit or a network error. The message then says what to do. check_api_status is the exception: it is true whenever the API answered, and reports API key problems in the message. | |
| message | Yes | Human-readable summary of the result, safe to relay to the user verbatim. | |
| tournaments | No | Matching tournaments, name order. |