Find a card in the packs
search_cardsRead-onlyIdempotent
Finds Rare and Epic cards sitting in any pack's pool right now by name words and/or minimum value (e.g. 'charizard psa 10'), up to 25, most valuable first, with the pack each is in and the chance per pack of pulling that exact card. Use it when the user asks whether a card can be pulled or which pack holds the best cards; use get_card for one result's full detail (pass its nft) and list_recent_pulls for cards already pulled. Read-only; pools are rescanned every few minutes, Commons and Uncommons aren't indexed.
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 |
|---|---|---|---|
| query | No | Words that must all appear in the card name, any order, e.g. 'umbreon vmax' or 'psa 10 rookie'. | |
| category | No | Only packs of this category. 'Others' covers Lorcana, Riftbound, Dragon Ball and anime. Leave out for all packs. | |
| min_value | No | Only cards worth at least this many US$, e.g. 500. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| note | No | ||
| cards | Yes |