search_cards
Use this for any question about which trading card printing in Pokémon (English and Japanese), Magic: The Gathering, Yu-Gi-Oh!, One Piece, and Riftbound matches a name, set, or collector number. Filters are applied before the cap; pass number for 4/102, H9, or TG06 and omit set_name unless the user named the set, because H9 matches a stored H09 and a name ending in (H9); the response includes total, truncated, next_cursor, language, rarity, release_date, and set_id. For nicknames or mixed free text such as "Moonbreon" or "Example Set Example Card", prefer find_card. Free, limited to 60 per minute and 1000 per key per UTC day, shared with the other free catalog calls.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_cards"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| game | No | Optional game slug. | |
| name | No | Card name, for example Example Card. Sample: name=Example Card, number=001/100, set_name=Example Set. 4/102 also matches 004/102; that rule is about number shape, not a specific card. | |
| limit | No | Page size, default 20, max 50. | |
| cursor | No | Offset cursor from the previous next_cursor. | |
| number | No | Collector number, for example 4/102, H9, or TG06. 4/102 matches 004/102. H9 matches H09/H32 and a name ending in (H9). 4 does not match 4/102. | |
| language | No | Optional. en or ja. Omit to search both. | |
| set_name | No | Set name only when the user named the set. Family match: Base Set also returns Base Set (Shadowless) and Base Set (1st Edition), but not Base Set 2. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| cards | No | ||
| total | No | ||
| truncated | No | ||
| next_cursor | No |