search_cards
Search for Hearthstone cards by name, text, class, mana cost, type, rarity, set, keyword, or race. Returns a summary list of matching cards.
Instructions
Search for Hearthstone cards by name, text, class, mana cost, type, rarity, set, or keyword. Use this when you need to find cards matching specific criteria. Returns a summary list — use get_card for full details on a specific card.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Free-text search across card name and text (uses FTS5) | |
| player_class | No | Filter by class (e.g. MAGE, WARRIOR, NEUTRAL) | |
| mana_cost | No | Filter by mana cost (combine with cost_op for range queries) | |
| cost_op | No | Cost comparison operator: eq, lt, lte, gt, gte (default: eq) | eq |
| type | No | Filter by card type: MINION, SPELL, WEAPON, HERO, LOCATION | |
| rarity | No | Filter by rarity: FREE, COMMON, RARE, EPIC, LEGENDARY | |
| card_set | No | Filter by set code (e.g. CORE, CLASSIC, LOE) | |
| keyword | No | Filter by keyword in keywords JSON (e.g. BATTLECRY, TAUNT, CHARGE) | |
| race | No | Filter by minion race/tribe (e.g. BEAST, DRAGON, MURLOC) | |
| collectible_only | No | Only return collectible cards (default: true) | |
| limit | No | Max results to return, 1-50 (default: 25) |