Tools: Cards
The Cards tools your agent sees through Elixir MCP: what each one answers, what it takes, and which capability it needs.
Cards
2 of the 55 tools in the registry. Generated from what tools/list returns, so this is exactly what your agent sees.
Card catalog cards_catalog
Current card and tower-troop catalog: ids, names, rarities, elixir cost, icons, max levels and forms. Use it to resolve card ids instead of guessing; ids or query narrow it to the cards you mean, and verbosity compact keeps id, name, rarity, cost and forms. maxLevel is the in-game 1-16 scale like every recorded-data tool; maxLevelRarityScale is the API's rarity-relative cap for anyone joining to raw live_fetch payloads.
Read-only ·
requires cr:read
| Argument | Type | Required | Notes |
|---|---|---|---|
ids |
array | no | Only these card ids. |
query |
string | no | Case-insensitive substring of a card name. |
verbosity |
string | no | compact: id, name, rarity, elixirCost and forms_available per card; no icons, levels or counts. (full · compact) |
Card synergy cards_synergy
What a card is played WITH, for a segment (the corpus by default) and window (default: the current season to date; season selects another): partner cards ranked by co-occurrence in decided head-to-head decks that contain the anchor, with co_occurrence_rate, distinct players per pair, the partner's baseline usage and lift = co_occurrence_rate / baseline (near 1 = rides along with everything). Anchor by card_id or exact name, never fuzzy; forms merge for the anchor by default while partners stay split by form.
Read-only ·
requires cr:read
| Argument | Type | Required | Notes |
|---|---|---|---|
card_id |
integer | no | Anchor card id (preferred). |
card |
string | no | Anchor card by EXACT name (case-insensitive); ambiguous names are refused with candidates. |
segment |
object | no | Scope: exactly one of player_tag, clan_tag (current members) or collection (a player collection's slug, e.g. 'pros'). OMIT the whole object for the entire recorded corpus. |
from |
string | no | Start of the window, inclusive: an ISO instant, or YYYY-MM-DD resolving to local midnight in your timezone. |
to |
string | no | End of the window, exclusive: an ISO instant as given; YYYY-MM-DD covers that WHOLE local day. Omit for up to now. |
days |
integer | no | Last N days, ending now: sugar for from. Or use from/to. |
weeks |
integer | no | Last N weeks, ending now: sugar for from. Or use from/to. |
timezone |
string | no | IANA zone (e.g. Europe/Paris) for this call's date-only bounds and local labels. Default: the account's timezone. Agents serving people in several zones pass the asker's. |
season |
string | integer | no | Bound the window to one season: 'current' (to date), 'previous', the month the API names it by (2026-08), or the river race season number (135). from/to/days/weeks given win over it. |
mode |
string | no | Mode group: ladder (Trophy Road), ranked (Path of Legends), war, casual, challenge, tournament. Omit for every mode. (casual · challenge · ladder · ranked · tournament · war) |
merge_forms |
boolean | no | Treat the anchor's base, Evolution and Hero forms as one card (default); false anchors on one form, chosen with anchor_form. |
anchor_form |
string | no | With merge_forms false: which form of the anchor. (base · evolution · hero) |
min_pair_battles |
integer | no | Decided decks a pair needs to be listed. |
limit |
integer | no |