Get a public ladder
get_public_ladderStandings of one public ladder, by id or ladder link: each named player's Lichess and chess.com rating, change and games in one time control, sorted as on the ladder page, plus this week's awards and recent results. Comes in pages; use offset for the next page. Private and link-only ladders are never returned.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"id": "<id>"
},
"name": "get_public_ladder"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| id | Yes | The ladder id, the part after /l/ in its link (for example demo-club), or the whole link. | |
| limit | No | Players per page. Default 20. | |
| offset | No | Players to skip, for the next page. Default 0. | |
| period | No | Days to measure change over: 7 (default) or 30, or season for a ladder with seasons. | |
| time_control | No | Time control to rank by. Default: the one most of the club plays. | |
| results_limit | No | How many recent weekly awards and challenge results to include. Default 5. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| shown | Yes | ||
| ladder | Yes | ||
| period | No | ||
| sorted_by | No | ||
| standings | Yes | ||
| this_week | No | ||
| next_offset | No | ||
| time_control | No | ||
| recent_awards | No | ||
| time_controls | No | ||
| challenge_results | No |