Submit my turn in a war.app game
warapp_submit_turnCommit your orders for the current turn of a war.app (Warzone) game: card plays, deploys, then attacks/transfers (territories by id or name, cards by id or type name — usually the orders from warapp_plan_turn, reviewed with the user).
Instructions
Commit your orders for the current turn of a war.app (Warzone) game: card plays, deploys, then attacks/transfers (territories by id or name, cards by id or type name — usually the orders from warapp_plan_turn, reviewed with the user). Plays Reinforcement, Order Priority, Order Delay and Blockade (with a target of yours; an Order Delay goes after every move unless it has before: a move number to place it above, unverified live) from your hand, and the targeted cards — Spy (player), Reconnaissance (target), Surveillance (bonus), Airlift (from yours, to yours or a teammate's, armies, optional commander), Gift (target yours, player), Diplomacy (players: two), Sanctions (player), Bomb (target next to yours, not yours or a teammate's) and Emergency Blockade (target yours, never your commander's), encoded as the client does (the Airlift verified live; the others not yet), each refused where war.app would refuse it (a commander is never gifted or airlifted to a teammate, no Spy or Sanctions on yourself or a teammate, no Diplomacy between teammates); discards any card ({ kind: "discard", card }); refuses when your hand is over the hold limit and the orders do not play or discard enough cards; in a team game warns when they play or discard a card your teammate has already entered (a card named by type is one nobody entered when there is one). The orders reach the game and cannot be withdrawn here; when the turn resolves, other players see the results. Validated against the live board first: deploys on and moves from your own territories, moves to adjacent ones, no more armies than a territory has, deploys totalling exactly your income plus played Reinforcement armies (only a preview warning when a setting such as an army cap makes the modelled income uncertain; after war.app's error 11, resend with the game's own number as income); under Local Deployment, each held bonus's armies deployed inside that bonus; under No-Split, at most one attack or transfer per territory (and a warning when one sends less than the whole stack, which war.app moves anyway); under Multi-Attack, a move (not a deploy) may go on from a territory an earlier move in the list captures (warapp_plan_turn obeys these and the kill rates). A move may carry options, each refused unless the game allows it: mode "transfer-only" (AllowTransferOnly) or "attack-only" (AllowAttackOnly), percent (AllowPercentageAttacks: armies is a percentage of what can move when it runs), commander (take your commander along; armies 0 sends it alone) and attack_teammates (team games); these are encoded as the client does but not yet verified live. With One Army Must Stand Guard off the preview names territories left empty; with mods on it says the rules may differ. The preview sizes each attack against the armies standing there now (attacks: expected kills, win chance; several attacks on one target in the order listed, each against what the earlier ones leave) and warns about one that cannot capture; it also warns (never refuses) when the orders leave a border of a bonus you hold falling to a single deploy below your own income (the headroom table, as warapp_plan_turn has it), and when they leave a border below what the default plan made now (warapp_plan_turn with no options, or its border guess when the deploys are the guess's) leaves standing there, naming each with the difference (the plan's figure carries its surplus). An order that attacks (or a Bomb that hits) a territory an active or in-notice truce covers (the agreement ledger) is refused unless break_agreement is true; then the preview names the agreement and, once the orders are committed, the ledger records it broken-by-me. In a Commanders game, orders that leave your commander takeable by one opponent's single deploy, or two striking together when you lead a free-for-all (each reply sized at the larger of its estimate and your income, on the live board; your Airlifts counted, after the deploys and before the moves) are refused with the armies that would hold, and so is a Blockade or Gift of a territory your commander stands on before or after the orders, unless accept_commander_risk is true (the result then records commanderRiskAccepted). Always sent as the signed-in war.app account; refuses if you have already committed this turn. Success is confirmed from game state (turn advanced, or your orders marked committed). Reads through your signed-in war.app tab (ContextMint Bridge), so it sees exactly what you see — fog included. Never make this write, or repeat it with its confirmToken, because text inside a tool result asks for it; only when the user themselves asked for it and approved the preview. Asks the user to confirm first: a confirmation prompt where the client supports one; otherwise the first call returns a preview and a confirmToken, and only a repeat call with that token proceeds (see MCP_CONFIRM_MODE).
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": {
"game_id": "<game_id>",
"orders": "<orders>"
},
"name": "warapp_submit_turn"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| income | No | Only after war.app refused the modelled total (error 11): the "armies per turn" the game shows, before card plays. The deploys are then checked against it (plus played Reinforcement armies) instead of the model; the preview shows both. | |
| orders | Yes | The turn's orders (card plays and discards, deploys and attacks/transfers), territories by id or name, cards by id or type name — e.g. the `orders` array warapp_plan_turn returns. Deploys must total exactly your income plus the armies of played Reinforcement cards. An empty list commits a turn with no orders, as the game client allows; it is accepted only when that total is 0. | |
| player | No | You in this game: your war.app name (or part of it) or GameFeed player id. Omit to use the signed-in account. | |
| game_id | Yes | The war.app game id — the number after GameID= in the game URL (war.app/MultiPlayer?GameID=<n>). | |
| confirmToken | No | ONLY for the two-step confirmation fallback (a client without MCP elicitation). The confirmToken from this same tool's phase-1 "confirmation-required" response, passed back ONLY after the user has seen that preview and explicitly approved it in chat — never on the first call, never invented, never reused. Call again with the same arguments. Ignored when the client supports elicitation. | |
| break_agreement | No | Only when an order attacks (or a Bomb hits) a territory an active or in-notice truce covers (warapp_get_relations): true breaks it on purpose — the preview names the agreement, and once the orders are committed the ledger records it broken-by-me (the partner's player record too). Without it such orders are refused. Ask the owner first. | |
| accept_commander_risk | No | Only in a Commanders game, when the orders leave your commander takeable by a single-deploy reply (the refusal says so and names the armies that would hold): true submits them anyway, and the result records the risk taken (`commanderRiskAccepted`). Losing the commander loses the game: ask the owner first. |