search_cards

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.

Parameters13

query	string	optional	Free text: card name, attack or ability text, artist, or card id.
set	string	optional	Set id, e.g. 'A1', 'A2b', 'PROMO-A'.
energy	string	optional	Energy type of the Pokémon.
stage	string	optional
kind	string	optional
rarity	string	optional	Rarity code, e.g. 'diamond-1', 'star-2', 'crown'.
trainerType	string	optional	Trainer subtype: item, supporter, tool, fossil, or stadium.
hpMin	integer	optional	Minimum HP (Pokémon only).
hpMax	integer	optional	Maximum HP (Pokémon only).
weakness	string	optional	Weakness energy type of the Pokémon.
retreatMax	integer	optional	Maximum retreat cost (Pokémon only).
page	integer	optional	1-based page number. Defaults to 1.
locale	string	optional	Locale for card names, e.g. 'en', 'ja_JP', 'fr_FR'. Defaults to 'en'.

Raw schema

{
  "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_card

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'.

Parameters2

id	string	required	Printing id ('A1-001') or gameplay card id ('PK_000010').
locale	string	optional	Locale for names and text. Defaults to 'en'.

Raw schema

{
  "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_sets

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

Parameters1

locale

string

optional

Locale for set names. Defaults to 'en'.

Raw schema

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

list_packs

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.

Parameters1

locale

string

optional

Locale for pack names. Defaults to 'en'.

Raw schema

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

list_locales

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

Parameters

No parameters.

Raw schema

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

catalog_info

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.

Parameters

No parameters.

Raw schema

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

list_printings

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.

Parameters2

id	string	required	Printing id ('A1-001') or gameplay card id ('PK_000010').
locale	string	optional	Locale for names. Defaults to 'en'.

Raw schema

{
  "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#"
}

evaluate_deck

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.

Parameters2

cards	array	required	The deck list, one entry per distinct card.
locale	string	optional	Locale for card names in messages.

Raw schema

{
  "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#"
}

suggest_deck

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.

Parameters3

query	string	optional	Card name to build around, e.g. 'Charizard ex'.
cardId	string	optional	Gameplay card id, e.g. 'PK_000960'.
locale	string	optional	Locale for card names. Defaults to 'en'.

Raw schema

{
  "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#"
}

simulate_matchup

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.

Parameters5

deckA	object	required	First deck to compare.
deckB	object	required	Second deck to compare.
games	integer	optional	Number of simulated games. Defaults to 20; maximum 50.
seed	integer	optional	Base random seed. Reusing the same inputs and seed reproduces the result.
locale	string	optional	Locale for card names in the sample log. Defaults to 'en'.

Raw schema

{
  "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#"
}

trial_deck

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.

Parameters5

deck	object	required	The deck to trial.
games	integer	optional	Mirror self-play games. Defaults to 10; maximum 50.
hands	integer	optional	Opening hands to sample. Defaults to 50; maximum 200.
seed	integer	optional	Base random seed. Reusing the same inputs and seed reproduces the result.
locale	string	optional	Locale for card names. Defaults to 'en'.

Raw schema

{
  "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#"
}

Pokemon TCG Pocket Catalog

app.hologallery.pocket/pokemon-tcg-pocket-catalog MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

⚠️ Limitations

search_cards

get_card

list_sets

list_packs

list_locales

catalog_info

list_printings

evaluate_deck

suggest_deck

simulate_matchup

trial_deck

Install

Remote endpoint

Related servers