Join an open war.app game
warapp_join_gameJoin an open war.app (Warzone) game: take an open seat in a game from warapp_list_open_games. The game is re-read from war.app's open games list first; team games, coin entry fees, custom scenarios and mod games are refused unless allowed…
Instructions
Join an open war.app (Warzone) game: take an open seat in a game from warapp_list_open_games. The game is re-read from war.app's open games list first; team games, coin entry fees, custom scenarios and mod games are refused unless allowed (scenario and mod games always), and so is a game you already joined. It joins with your preferred colour, else your secondary, else a free standard colour (or the color you pass); the preview shows which, plus a screen from the lobby's GameFeed settings (does the cheapest neutral cost at most one turn of base income; Light Fog) and policy: whether the lobby keeps the joining policy (no Commerce, mods or custom scenarios; that cheap neutral; at most four seats; a boot time of at least 12 hours; no lottery — lottery, read from the data as warapp_list_open_games does) — advisory, the join is not refused for it. You become a player and are expected to take turns — leaving later means declining or being booted. Works without a browser once a session is linked (warapp_link_session). 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>"
},
"name": "warapp_join_game"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| team | No | In a team game: the team to join (a team number with an open seat; the preview lists the teams offered and the seats on the chosen one). Implies allow_team. Refused outside a team game, with random teams, and for a team that is full or not in the game. | |
| color | No | The colour to play as: a war.app colour index (0–23 are the standard colours; higher ones need an unlock). Default: your preferred colour, else your secondary, else the first standard colour no player in the game has. | |
| game_id | Yes | The war.app game id — the number after GameID= in the game URL (war.app/MultiPlayer?GameID=<n>). | |
| allow_team | No | Allow joining a team game on the first open seat's team (default false). | |
| 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. | |
| accept_entry_fee | No | Allow paying a coin entry fee (default false: only free games). |