search_cards
Search the full Disney Lorcana card pool by ink color, type, rarity, cost, keyword, ability text, set, or subtype to find cards matching criteria. Returns paginated Markdown tables.
Instructions
Search the full Lorcana card pool (all sets, every printed card) by any combination of filters — not your collection. This is a discovery tool for "what cards fit X criteria", independent of what you own or have priced.
All filters are optional and ANDed together, except colors: a card matches if it has ANY of the given colors, so dual-ink cards surface for either half. Calling with no filters at all returns the entire card pool, paginated.
Behavior: always fetches from a live, in-process-cached copy of
LorcanaJSON (see the "Card data APIs" reference) — never reads a local CSV,
so results always include the newest released set. A card that has no
Strength/Willpower/Lore (Action, Item, Location) shows "—" for those
stats rather than being excluded. Results are grouped and displayed by ink
color, then returned as one or more Markdown tables; when more results
exist than limit, the response tells you the exact offset to pass next
— call again with that offset rather than guessing pages.
Usage guidelines: use this to browse/filter by criteria (e.g. "every
Evasive Sapphire character costing 3 or less") — if you already have a
specific (possibly misspelled or subtitle-less) card name in mind, use
resolve_card or lookup_card instead, they're cheaper and more precise
for a single known card. Results carry no ownership or price information;
to check what you already own, cross-reference the card names against an
enriched collection CSV yourself, or use what_am_i_missing /
find_song_synergies's collection_csv param for tools that do that
automatically. To narrow to a specific play format's legal pool, combine
with set_name, or post-filter the result against filter_collection's
format logic.
Args: colors: Comma-separated ink color(s), e.g. "Amber,Steel". Case-insensitive. card_type: "Character", "Action", "Item", "Location", or "Song" (Action cards with the Song subtype). rarity: "Common", "Uncommon", "Rare", "Super Rare", "Legendary", "Enchanted", "Epic", "Iconic", or "Special". set_name: Set name substring, e.g. "Wilds Unknown". cost_min: Minimum ink cost, inclusive. Pass -1 (default) for no minimum. cost_max: Maximum ink cost, inclusive. Pass -1 (default) for no maximum. keyword: Keyword ability name, e.g. "Evasive", "Rush", "Bodyguard", "Shift". ability_text: Substring to search for in full ability text (case-insensitive). subtype: Subtype/classification, e.g. "Toy", "Hero", "Villain", "Princess". offset: Pagination offset, 0-based. limit: Max results in this page (default 25, capped at 200).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| colors | No | ||
| offset | No | ||
| rarity | No | ||
| keyword | No | ||
| subtype | No | ||
| cost_max | No | ||
| cost_min | No | ||
| set_name | No | ||
| card_type | No | ||
| ability_text | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |