Get Pokémon cards by id
ptcg_get_cardsFetch Pokémon TCG cards by ID (set code + collector number) in one call. Returns only found cards, omitting any invalid or missing IDs.
Instructions
Fetch one or many cards by id, in a single call. Ids are the printed coordinate — set code, dash, collector number, e.g. "bs-4" — and the alternate legacy id ("base1-4") resolves on the same route. Ids that do not exist are omitted from the result; compare requested against found. Card game text is present since 2026-09-03, in English, and unevenly: attacks on 33% of the catalogue, subtypes on 38%, weaknesses on 31%, flavor_text on 20%, abilities on 8%, rules on 6%. It sits on the 20,725 Western printings, so read against those alone attacks is on 83% of them, while Japanese and Chinese printings carry none. Check the field on the card in hand rather than assuming: a null attacks means we do not hold it, never that the card has no attack. Still empty for every card: level, and legalities — deck legality is a question this API cannot answer, so say so rather than inferring it.
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": {
"ids": "<ids>"
},
"name": "ptcg_get_cards"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ids | Yes | Card ids, 1 to 100. | |
| lang | No | ||
| include_prices | No | Attach the full price list to each card. |