Search cards
search_cardSearch graded Pokémon cards by name (Chinese / English / Japanese), community nickname (e.g. "鬼皮"), or set code + card number (e.g. "sv8a 喷火龙", "CEL 4"). 中文用户: 按官方卡名/圈内简称/系列码+卡号查任意宝可梦评级卡, 返回 card_id 供查价/走势/存世量工具使用。Returns up to 10 matching cards with card_id (incl. rarity/variant/species fields) — use card_id with the other tools. Keep artwork descriptions and negative conditions in query (e.g. "alt art", "not 1st Edition"). Read artwork_filter / finish_filter: conflicting or unverified conditions do not permit quoting; not 1st Edition does not by itself mean Unlimited. A bare set code or set name (e.g. "151c", "Celebrations") returns a set-level summary with guidance instead of a truncated card list — follow it to get_set_overview / set_species_summary for whole-set stats. Optional lang filters to one language track (en / ja / zh-cn); tracks are never mixed. Also resolves sealed products that have a fixed card list (theme decks, starter sets) by product name, e.g. "Water Blast theme deck": the result then carries a product block with the card list instead of card candidates. POKEKA has no price for sealed products. Reads POKEKA market data only; server-side request logging is disclosed in the privacy policy; does not modify user data.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search_card"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| lang | No | Optional language track filter. | |
| query | Yes | Card name, nickname/slang, or set code + number. zh/en/ja all accepted. At most 160 characters (counted as Unicode code points); a longer query is rejected, not cut — keep it to the card name, set, number and the conditions that matter. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| hint | No | ||
| lang | No | ||
| note | No | ||
| order | No | headline_price_desc = the listed cards are the most expensive ones, not the ones collectors usually mean | |
| query | No | ||
| sample | No | ||
| by_lang | No | ||
| results | No | ||
| species | No | ||
| guidance | No | ||
| mismatch | No | ||
| set_code | No | ||
| by_rarity | No | ||
| condition | No | "raw" when the user asked for an ungraded card | |
| guess_note | No | ||
| match_kind | No | species | card_name | guess — guess means nothing matched and the results are prefix guesses, never price from them | |
| query_type | No | "set" = the query was a bare set code/name; read guidance and use the set-level tools | |
| set_tracks | No | when the query is a set-level name or a bare set code: every (set_code, lang) it exists on, with card counts. The same release usually has a different set code per language track. | |
| term_scope | No | species = the term is a nickname for a whole Pokémon species (many cards), not for one card | |
| exact_match | No | true only when set, number AND every other entity in the query (character, nickname, language) agree with the results | |
| total_cards | No | ||
| query_intent | No | ||
| related_sets | No | only when unambiguous: the set that carries the same collector name on the requested language track (the same release usually has a different set code per language). Absent when the name covers a whole era or product family rather than one release. | |
| result_count | No | ||
| entity_anchor | No | ||
| finish_filter | No | ||
| rarity_filter | No | ||
| safe_to_price | No | true = results[0] can be priced without asking the user to confirm; false = candidates only | |
| artwork_filter | No | ||
| grading_filter | No | ||
| qualifier_note | No | ||
| unresolved_note | No | ||
| card_count_total | No | how many cards the term matches in total; card_count / result_count is only how many are listed | |
| also_matched_sets | No | ||
| unresolved_tokens | No | words from the question that were NOT used to choose the card | |
| qualifiers_dropped | No | ||
| qualifiers_recognized | No | ||
| query_constraint_note | No |