search_cards
Search Disney Lorcana cards using filters for color, cost, stats, keywords, and more. Get card objects with details for deck building and analysis.
Instructions
Search Lorcana cards with optional filters. Returns card objects (not counts). Color must be one of: ruby, sapphire, emerald, amber, amethyst, steel. Use card_type to filter by card type: Character, Action, Item, Song, or Location. Use min_attack/max_attack and min_defence/max_defence for stat-based queries (e.g. 'characters with 4+ strength'). Use min_cost/max_cost for cost ranges. Use keyword to filter by Lorcana keyword (Bodyguard, Challenger, Evasive, Reckless, Resist, Rush, Shift, Singer, Sing Together, Support, Vanish, Voiceless, Ward, etc.) — matches against the structured ability list, more reliable than substring search. Use body_text to search card ability text — useful for value-specific keyword queries like 'Singer 5' or 'Resist +2', or for non-keyword phrases like 'gain 2 lore'. Use lore/min_lore/max_lore to filter by lore value. Use sort_by to order results (id, name, cost, strength, willpower, lore, rarity, set_code); use sort_order='asc' or 'desc'. Use set_code to filter by set number (e.g. '1' for The First Chapter). Use set_name to filter by set name as a case-insensitive substring (e.g. 'Wilds Unknown', 'frozen', 'Floodborn') — preferred when the user names a set in plain English so you don't have to look up the code first. Use offset to paginate through results (e.g. offset=20 for the next page). Use count_cards instead if you only need a total count. Set response_format='toon' to receive a TOON-encoded string instead of JSON objects (~10% fewer tokens; the printings array is nested so the savings are smaller than a purely flat schema would yield); default is 'json'.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cost | No | ||
| lore | No | ||
| name | No | ||
| color | No | ||
| limit | No | ||
| trait | No | ||
| offset | No | ||
| rarity | No | ||
| inkwell | No | ||
| keyword | No | ||
| sort_by | No | id | |
| max_cost | No | ||
| max_lore | No | ||
| min_cost | No | ||
| min_lore | No | ||
| set_code | No | ||
| set_name | No | ||
| body_text | No | ||
| card_type | No | ||
| max_attack | No | ||
| min_attack | No | ||
| sort_order | No | asc | |
| max_defence | No | ||
| min_defence | No | ||
| response_format | No | json |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |