List tournament-winning lists
list_winning_listsLists a faction's top-four tournament placings from 40k Stats and Mini Headquarters whose lists import cleanly and are legal under today's army data, newest first; pass includeNoLongerLegal for lists a points or rules change has made illegal too, such as to read the meta from before a points rise. A faction counts its whole family, so a list imported under an earlier rules version still counts. of is how many lists matched and events the date range of their events; a small of is a small sample. latestUpdate is the date of the faction's newest points or datasheet update and sinceLatestUpdate how many lists come from events since; lists from before it were built for other points, so weigh them less or pass since. detachments counts how many lists took each detachment. battleSizes counts the faction's lists at each size: when it has none at the size being built, say so, and read other sizes' lists as which units the faction favours rather than as a shape to copy. datasheets names every datasheet those lists field with how many of them field it, most first, and the unit sizes taken, most common first. Each list gives its placing, record, event, detachments, Force disposition, points under today's data and as the player reported them, whether it is legal today, and units with every copy's model count; pass its id to get_winning_list for the full list as a draft. A placing reflects the player and the field as much as the list: learn the shapes and staples these lists share rather than copying one. While checking is true the first import is still running and every count is partial; say so.
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": {
"faction": "<faction>"
},
"name": "list_winning_lists"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| count | No | How many of the newest matching lists to return in full. | |
| since | No | Only placings from events on or after this date (YYYY-MM-DD), such as the latestUpdate an earlier call returned. | |
| faction | Yes | Faction id, URL slug, or display name from list_reference or list_units. | |
| llm_model | No | The model identifier you are running as, for example "claude-opus-4-8" or "gpt-5.2". Pass "unknown" if you are not certain. Recorded for the server developer's analytics. | |
| battleSize | No | Only placings at this battle size in points, such as 2000. | |
| detachment | No | Detachment id, slug, or name from list_units, to list only placings that took it. | |
| conversation_id | No | The conversation_id this server returned earlier in this conversation, unchanged, including after later user messages. Omit it if you have none. Recorded for the server developer's analytics. | |
| includeNoLongerLegal | No | Also list placings that import cleanly but break today’s points or rules, marked legalToday false. |