Pokemon TCG Pocket Catalog

Search the Pokémon TCG Pocket card catalog by name, attack, ability, artist, or id, with optional filters for set, energy type, stage, card kind, rarity, Trainer subtype, HP range, weakness, and retreat cost. Returns up to 20 summarized cards plus the total number of matches.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Free text: card name, attack or ability text, artist, or card id.",
      "type": "string"
    },
    "set": {
      "description": "Set id, e.g. 'A1', 'A2b', 'PROMO-A'.",
      "type": "string"
    },
    "energy": {
      "description": "Energy type of the Pokémon.",
      "type": "string",
      "enum": [
        "grass",
        "fire",
        "water",
        "lightning",
        "psychic",
        "fighting",
        "darkness",
        "metal",
        "dragon",
        "colorless"
      ]
    },
    "stage": {
      "type": "string",
      "enum": [
        "basic",
        "stage-1",
        "stage-2"
      ]
    },
    "kind": {
      "type": "string",
      "enum": [
        "pokemon",
        "trainer"
      ]
    },
    "rarity": {
      "description": "Rarity code, e.g. 'diamond-1', 'star-2', 'crown'.",
      "type": "string"
    },
    "trainerType": {
      "description": "Trainer subtype: item, supporter, tool, fossil, or stadium.",
      "type": "string",
      "enum": [
        "item",
        "supporter",
        "tool",
        "fossil",
        "stadium"
      ]
    },
    "hpMin": {
      "description": "Minimum HP (Pokémon only).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "hpMax": {
      "description": "Maximum HP (Pokémon only).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "weakness": {
      "description": "Weakness energy type of the Pokémon.",
      "type": "string",
      "enum": [
        "grass",
        "fire",
        "water",
        "lightning",
        "psychic",
        "fighting",
        "darkness",
        "metal",
        "dragon",
        "colorless"
      ]
    },
    "retreatMax": {
      "description": "Maximum retreat cost (Pokémon only).",
      "type": "integer",
      "minimum": 0,
      "maximum": 9007199254740991
    },
    "page": {
      "description": "1-based page number. Defaults to 1.",
      "type": "integer",
      "minimum": 1,
      "maximum": 1000
    },
    "locale": {
      "description": "Locale for card names, e.g. 'en', 'ja_JP', 'fr_FR'. Defaults to 'en'.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Get one Pokémon TCG Pocket card's available catalog data: HP, attacks with energy costs and damage, abilities, weakness, retreat cost, evolution, artist, rarity, and artwork. Trainer cards return their rules text and subtype instead of attacks. Accepts either a printing id like 'A1-001' or a gameplay card id like 'PK_000010'.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Printing id ('A1-001') or gameplay card id ('PK_000010')."
    },
    "locale": {
      "description": "Locale for names and text. Defaults to 'en'.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List every Pokémon TCG Pocket set with its id and localized name. Use the ids to filter search_cards by set.

{
  "type": "object",
  "properties": {
    "locale": {
      "description": "Locale for set names. Defaults to 'en'.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List every Pokémon TCG Pocket booster pack with its id, parent set id, and localized name. Pack ids identify where a printing can be pulled.

{
  "type": "object",
  "properties": {
    "locale": {
      "description": "Locale for pack names. Defaults to 'en'.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List every locale code the catalog has translations for. Pass one as 'locale' to any other tool for localized card, set, and pack names.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Catalog metadata: game version, schema version, card/printing/set/pack counts, and supported locales. Quote the game version alongside any simulation result so the evidence stays pinned to the data it was computed from.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

List every printing of one card across all sets: printing id, set, collector number, rarity, artist, and canonical page URL. Accepts either a printing id like 'A1-001' or a gameplay card id like 'PK_000010'. get_card only returns the first printing; use this when the question is about reprints, alt arts, or pull sources.

{
  "type": "object",
  "properties": {
    "id": {
      "type": "string",
      "description": "Printing id ('A1-001') or gameplay card id ('PK_000010')."
    },
    "locale": {
      "description": "Locale for names. Defaults to 'en'.",
      "type": "string"
    }
  },
  "required": [
    "id"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Check a 20-card Pokémon TCG Pocket deck against the game's rules (exactly 20 cards, at most 2 copies of a card, at least one Basic Pokémon) and return build advice: missing evolution lines, energy-type spread, Pokémon/Trainer balance, missing staple Trainers, and known card synergies. Takes gameplay card ids, not printing ids.

{
  "type": "object",
  "properties": {
    "cards": {
      "minItems": 1,
      "maxItems": 20,
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "gameplayCardId": {
            "type": "string",
            "description": "Gameplay card id, e.g. 'PK_000360'."
          },
          "count": {
            "type": "integer",
            "minimum": 1,
            "maximum": 20,
            "description": "Copies in the deck."
          }
        },
        "required": [
          "gameplayCardId",
          "count"
        ]
      },
      "description": "The deck list, one entry per distinct card."
    },
    "locale": {
      "description": "Locale for card names in messages.",
      "type": "string"
    }
  },
  "required": [
    "cards"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Build a complete, legal 20-card Pokémon TCG Pocket deck around a chosen card. Returns a named archetype, why it works, limitations, and the full card list with copy counts. Trainer targets produce a legal baseline with an explicit effect-data limitation. Give either a card name to search for or a gameplay card id.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Card name to build around, e.g. 'Charizard ex'.",
      "type": "string"
    },
    "cardId": {
      "description": "Gameplay card id, e.g. 'PK_000960'.",
      "type": "string"
    },
    "locale": {
      "description": "Locale for card names. Defaults to 'en'.",
      "type": "string"
    }
  },
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Run two legal 20-card Pokémon TCG Pocket decks through the Battle Lab rules engine using deterministic heuristic AI. Returns wins, draws, failures, average turns/actions, and a short sample game log. This measures the built-in AI policy, not human skill or competitive win probability.

{
  "type": "object",
  "properties": {
    "deckA": {
      "type": "object",
      "properties": {
        "name": {
          "description": "A short label used in the result.",
          "type": "string",
          "maxLength": 80
        },
        "cards": {
          "minItems": 1,
          "maxItems": 20,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "gameplayCardId": {
                "type": "string",
                "description": "Gameplay card id, e.g. 'PK_000360'."
              },
              "count": {
                "type": "integer",
                "minimum": 1,
                "maximum": 20,
                "description": "Copies in the deck."
              }
            },
            "required": [
              "gameplayCardId",
              "count"
            ]
          },
          "description": "Exactly 20 total cards, with no more than two copies of one gameplay card."
        },
        "energyTypes": {
          "minItems": 1,
          "maxItems": 3,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "grass",
              "fire",
              "water",
              "lightning",
              "psychic",
              "fighting",
              "darkness",
              "metal",
              "dragon",
              "colorless"
            ]
          },
          "description": "Energy Zone types configured for this deck."
        }
      },
      "required": [
        "cards",
        "energyTypes"
      ],
      "description": "First deck to compare."
    },
    "deckB": {
      "type": "object",
      "properties": {
        "name": {
          "description": "A short label used in the result.",
          "type": "string",
          "maxLength": 80
        },
        "cards": {
          "minItems": 1,
          "maxItems": 20,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "gameplayCardId": {
                "type": "string",
                "description": "Gameplay card id, e.g. 'PK_000360'."
              },
              "count": {
                "type": "integer",
                "minimum": 1,
                "maximum": 20,
                "description": "Copies in the deck."
              }
            },
            "required": [
              "gameplayCardId",
              "count"
            ]
          },
          "description": "Exactly 20 total cards, with no more than two copies of one gameplay card."
        },
        "energyTypes": {
          "minItems": 1,
          "maxItems": 3,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "grass",
              "fire",
              "water",
              "lightning",
              "psychic",
              "fighting",
              "darkness",
              "metal",
              "dragon",
              "colorless"
            ]
          },
          "description": "Energy Zone types configured for this deck."
        }
      },
      "required": [
        "cards",
        "energyTypes"
      ],
      "description": "Second deck to compare."
    },
    "games": {
      "description": "Number of simulated games. Defaults to 20; maximum 50.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "seed": {
      "description": "Base random seed. Reusing the same inputs and seed reproduces the result.",
      "type": "integer",
      "minimum": 0,
      "maximum": 2147483647
    },
    "locale": {
      "description": "Locale for card names in the sample log. Defaults to 'en'.",
      "type": "string"
    }
  },
  "required": [
    "deckA",
    "deckB"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Solo-trial one legal 20-card Pokémon TCG Pocket deck: opening-hand consistency (Basics per opener, Trainer density, how often each card shows up across sampled hands) plus mirror self-play with the deck on both seats (closing speed and first-player bias). Use this to tune a single deck; use simulate_matchup to compare two decks. Takes gameplay card ids, not printing ids.

{
  "type": "object",
  "properties": {
    "deck": {
      "type": "object",
      "properties": {
        "name": {
          "description": "A short label used in the result.",
          "type": "string",
          "maxLength": 80
        },
        "cards": {
          "minItems": 1,
          "maxItems": 20,
          "type": "array",
          "items": {
            "type": "object",
            "properties": {
              "gameplayCardId": {
                "type": "string",
                "description": "Gameplay card id, e.g. 'PK_000360'."
              },
              "count": {
                "type": "integer",
                "minimum": 1,
                "maximum": 20,
                "description": "Copies in the deck."
              }
            },
            "required": [
              "gameplayCardId",
              "count"
            ]
          },
          "description": "Exactly 20 total cards, with no more than two copies of one gameplay card."
        },
        "energyTypes": {
          "minItems": 1,
          "maxItems": 3,
          "type": "array",
          "items": {
            "type": "string",
            "enum": [
              "grass",
              "fire",
              "water",
              "lightning",
              "psychic",
              "fighting",
              "darkness",
              "metal",
              "dragon",
              "colorless"
            ]
          },
          "description": "Energy Zone types configured for this deck."
        }
      },
      "required": [
        "cards",
        "energyTypes"
      ],
      "description": "The deck to trial."
    },
    "games": {
      "description": "Mirror self-play games. Defaults to 10; maximum 50.",
      "type": "integer",
      "minimum": 1,
      "maximum": 50
    },
    "hands": {
      "description": "Opening hands to sample. Defaults to 50; maximum 200.",
      "type": "integer",
      "minimum": 1,
      "maximum": 200
    },
    "seed": {
      "description": "Base random seed. Reusing the same inputs and seed reproduces the result.",
      "type": "integer",
      "minimum": 0,
      "maximum": 2147483647
    },
    "locale": {
      "description": "Locale for card names. Defaults to 'en'.",
      "type": "string"
    }
  },
  "required": [
    "deck"
  ],
  "$schema": "http://json-schema.org/draft-07/schema#"
}