Tools: Cards
The Cards tools your agent sees through Elixir MCP: what each one answers, what it takes, and which capability it needs.
Cards
3 of the 47 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, types, 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) |
What comes back (declared outputSchema; fields marked required are always present):
| Field | Type | Required | Notes |
|---|---|---|---|
applied |
object | yes | |
as_of |
string | null | yes | |
cards |
array | yes | |
docs |
string | yes | page or page#section for elixir_docs / elixir://docs. |
fetched_at |
string | null | yes | |
meta |
object | yes | The envelope (docs: responses). |
notes |
array | yes | One-sentence caveats to repeat when quoting the numbers. |
tower_troops |
array | yes |
Deck archetype, by name or by cards cards_archetype
What a deck name means, or what to call a deck. name: a family (bridge spam), a composed label (Royal Hogs bridge spam) or a community name (LavaLoon, Log Bait, 2.6 Hog) to its family, win conditions, the aliases for that shape. cards: eight cards (ids or names; 'Evo '/'Hero ' prefixes set the form) to their archetype - from catalog and vocabulary facts, without a population. Neither: the vocabulary (families, win conditions with tiers, aliases, the version in force). A label is a noun, never a verdict.
Read-only ·
requires cr:read
| Argument | Type | Required | Notes |
|---|---|---|---|
name |
string | no | A deck name to resolve: a family, a '<card(s)> <family>' label, or a community name. Refused with the vocabulary in the hint when it is nothing. |
cards |
array | no | The cards of a deck to name: catalog ids or names ('P.E.K.K.A' or 'pekka'); 'Evo ' or 'Hero ' before a name sets its form. Tower troops are ignored. |
verbosity |
string | no | This tool has one size: compact is accepted and changes nothing (the response says so in a note). (full · compact) |
What comes back (declared outputSchema; fields marked required are always present):
| Field | Type | Required | Notes |
|---|---|---|---|
applied |
object | no | |
resolved |
object | no | |
archetype |
object | no | |
version |
object | no | |
docs |
string | yes | page or page#section for elixir_docs / elixir://docs. |
meta |
object | yes | The envelope (docs: responses). |
notes |
array | yes | One-sentence caveats to repeat when quoting the numbers. |
One card, everything recorded cards_card
One card's catalog facts and earliest recorded play in a named player or clan's history. A clan read also lists current members who played it in the requested window and who hold it, with recorded levels and forms. No corpus statistics, partners, popularity, scores or recommendations. Anchor by card_id or exact name. The window defaults to the current season; first_played spans the selected history.
Read-only ·
requires cr:read
| Argument | Type | Required | Notes |
|---|---|---|---|
card_id |
integer | no | The card id. |
card |
string | no | An exact catalog name, case-insensitive. |
segment |
yes | The recorded player or clan to read: 'mine' (your clan) or an object naming exactly one of player_tag or clan_tag (current members). Required; corpus access has retired. | |
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 to 14,000), ranked (Path of Legends), war, casual (clanmate battles even when tagged), challenge, event (any other battle with an event tag, including the seasonal Trophy Road past 14,000), tournament. Omit for every mode. (casual · challenge · event · ladder · ranked · tournament · war) |
verbosity |
string | no | compact: keeps card facts; drops clan member lists. (full · compact) |
What comes back (declared outputSchema; fields marked required are always present):
| Field | Type | Required | Notes |
|---|---|---|---|
applied |
object | yes | |
card |
object | yes | |
members |
object | no | |
docs |
string | yes | page or page#section for elixir_docs / elixir://docs. |
meta |
object | yes | The envelope (docs: responses). |
notes |
array | yes | One-sentence caveats to repeat when quoting the numbers. |