list_leagues
List soccer leagues available to your API key, with filters for continent and specialized leagues. Each result includes an ID for use in list_picks queries.
Instructions
List the soccer leagues the Statos engine tracks (filtered to what the API-key holder's plan permits). Each league carries an id you can pass to list_picks for filtering, plus name, country, continent, and an is_specialized flag indicating leagues the engine biases toward. Useful for discovery: 'which European leagues can I see?' or 'show me the specialized leagues only'.
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": "list_leagues"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | Maximum leagues to return (default 200, max 500). | |
| continent | No | Filter to one continent. Omit for all leagues the API key can see. | |
| specialized_only | No | If true, return only is_specialized=true leagues — the curated set the suggestion engine biases toward. |