Tools: War
The War tools your agent sees through Elixir MCP: what each one answers, what it takes, and which capability it needs.
War
4 of the 55 tools in the registry. Generated from what tools/list returns, so this is exactly what your agent sees.
Current war war_current
The current (latest recorded) river race for a clan, yours by default: standings across the five clans with banked fame and current-day period_points, per-member points and decks used, the war day and attendance so far. On a war day decks_today names who is untouched, partial and finished (the nudge list); off one it is null with decks_today_reason. verbosity compact keeps standings, the period, the counts and the nudge lists (name + tag) and drops the participants array. live: true asks for a read of ANY clan, recorded or not: served if in hand, otherwise queued while the record answers with live_status pending.
Read-only ·
requires cr:read · reaches the live Clash Royale API, outside the recorded corpus
| Argument | Type | Required | Notes |
|---|---|---|---|
clan_tag |
string | no | Clan tag like #J2RGCRVG. Omit to mean your recorded clan. |
verbosity |
string | no | compact: drops the participants array and attendance history; keeps standings, period, counts, members_not_in_race and the decks_today lists. (full · compact) |
live |
boolean | no | Ask for a read of this clan's race no older than two minutes; works for a clan nobody records. Served if in hand, otherwise queued while the record answers with live_status pending. |
What comes back (declared outputSchema; fields marked required are always present):
| Field | Type | Required | Notes |
|---|---|---|---|
clan_tag |
string | yes | Clash Royale tag, e.g. #20JJJ2CCRU. |
season_id |
integer | yes | |
section_index |
integer | yes | |
is_colosseum |
boolean | no | |
day_kind |
string | null | yes | |
war_day |
integer | null | yes | |
next_war_day_opens_at |
string | null | no | |
applied |
object | no | |
standings |
array | yes | |
participants |
array | no | |
participants_count |
integer | yes | |
member_count |
integer | yes | |
members_not_in_race |
array | yes | |
period |
object | no | |
race_finished_at |
string | null | no | |
decks_today |
object | null | yes | |
decks_today_reason |
string | no | (period_unknown · war_day_over · training_day) |
attendance_by_war_day |
array | no | |
notes |
array | yes | One-sentence caveats to repeat when quoting the numbers. |
docs |
string | yes | page or page#section for elixir_docs / elixir://docs. |
meta |
object | yes | The envelope (docs: responses). |
Game clock game_clock
What time it is in Clash Royale, for nobody in particular: current season, week within the season, whether today is a training day or war day, when this day ends, and the next boundaries of each kind (war_day_closes_at, next_war_day_opens_at, next_training_starts_at, week_ends_at, season_ends_at) so a routine can schedule itself. Needs no player and no clan. Use it to decide WHEN to look before deciding who to look at; war_current is the tool for what a specific clan is doing inside this day.
Read-only ·
requires cr:read
| Argument | Type | Required | Notes |
|---|---|---|---|
at |
string | no | ISO 8601 instant to describe instead of now, e.g. to learn what day a recorded battle fell on. |
Scouting Report war_rivals
The Scouting Report: observed war history for rival clans. Every recorded river race captures all five bracket clans, so rivals accumulate fingerprints across every race they shared with a recorded clan. Defaults to your clan's current bracket. Pure aggregation of stored observations: races seen, fame record, zero-fame races, seasons spanned.
Read-only ·
requires cr:read
| Argument | Type | Required | Notes |
|---|---|---|---|
clan_tag |
string | no | Your clan (the anchor whose bracket is meant). Omit for your recorded clan. |
rival_tags |
array | no | Specific rival clans; omit for the current bracket. |
War history war_history
Recorded war weeks for a clan, yours by default: final ranks and boat fame. With player_tag (or on_behalf_of), returns one member's per-week points, decks and war days battled. With season_id and section_index together, returns that exact week plus every recorded participant in member_weeks. seasons says how far back otherwise; from/to are not needed here.
Read-only ·
requires cr:read
| Argument | Type | Required | Notes |
|---|---|---|---|
clan_tag |
string | no | Clan tag like #J2RGCRVG. Omit to mean your recorded clan. |
player_tag |
string | no | Focus one member's participation (member_weeks). |
on_behalf_of |
string | no | Agent connections: the end user's id on your surface (e.g. discord:1234), mapped once with elixir_identify. Ignored on a personal connection. |
seasons |
integer | no | How many seasons back. |
season_id |
integer | no | Exact season to read; supply section_index too. Returns every recorded participant for that week unless player_tag focuses one. |
section_index |
integer | no | Exact section (week) within season_id; supply season_id too. |