List compact faction units for roster planning
list_unitsReturns every pickable unit in one bounded response with unit-size costs, composition, attachment relationships, roster limits, roles, keywords, and links. Without a detachment it also lists every detachment the faction can take, with its detachment points, Force dispositions, rule names and enhancement costs, so you can compare them before choosing. Include a detachment, including one a chapter takes from its codex, to list only the units it allows and receive its rules, enhancements, upgrades, and stratagems by name, cost, and timing without opening every unit page. Their rules text is at each record’s textSources. A unit’s points is what its smallest size costs in this battle size and detachment, including any wargear or enhancement the detachment makes it take; costs is the Munitorum Field Manual table for every size. Legends and Crucible datasheets are left out unless nonMatchedPlay is true. A large faction such as a Space Marine chapter can exceed what an assistant reads at once, so pass query to list only the units whose name or keywords contain it; a query nothing contains lists the units whose names are close to it, so a misspelt name still finds its unit. To see which units and detachments the faction’s top-four tournament lists take, call list_winning_lists rather than relying on memory.
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_units"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | List only units whose name or keywords contain this text, such as Terminator or Character, or else units whose names are close to it. | |
| faction | Yes | Faction id, URL slug, or display name from list_reference. | |
| 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 | Battle size in points for size-dependent limits. | |
| detachment | No | Detachment id, slug, or display name. Omit it to compare every detachment the faction can take. | |
| nonMatchedPlay | No | Also list Legends and Crucible datasheets, which matched play does not allow. | |
| 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. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | ||
| units | Yes | ||
| faction | Yes | ||
| revisions | Yes | ||
| battleSize | Yes | ||
| detachment | Yes | ||
| detachments | Yes | ||
| nonMatchedPlay | Yes |