Create a battle
create_battleCreates a battle in setup and returns its token. With nobody named it starts a draft with only you at the table, reusing your untouched draft with the same mission pack, and returns joinUrl: anyone with an account who opens it joins the open place, and the draft becomes a battle once every place is filled and every army chosen. opponentId seats one opponent from list_my_opponents for a duel; opponentIds seats one or two, and allyId seats a friend on your side, for a 2v1 or doubles. bothSides: true starts a duel you play alone instead: you hold both places and choose both armies from your own rosters, and it stays out of your record and the leaderboard. limit is the battle size in points (1000, 2000, 3000, or 600 for King of the Colosseum); omit it to take the size from the rosters, as a draft always does. missionPackId is a mission pack id from list_reference. casual: true plays it outside a tournament both players are entered in. manual: true tracks by hand without mission cards, stratagems or CP automation. groupToken counts it for a group both players are in, and fixture names that group's league fixture. Then set it up with submit_battle_action, following get_my_battle's next. Requires mcp:write.
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": "create_battle"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| allyId | No | ||
| casual | No | ||
| manual | No | ||
| fixture | No | ||
| bothSides | No | Play every side yourself, choosing every army from your own rosters. | |
| 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. | |
| groupToken | No | ||
| opponentId | No | ||
| opponentIds | No | ||
| missionPackId | No | ||
| 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. |