Skip to main content
Glama

tcgdata.dev — European TCG Prices

Search Japanese source cards

search_catalogue_cards
Read-only

Search the price-independent Japanese Pokémon source catalogue, including cards with no price-variant match. cat_ identifies a source card; catv_ identifies a source variant. Use pricing.price_variants[].id (tcg_) for prices, never guess a bridge. One admitted API call consumes one shared account request, including admitted errors. No automatic retries.

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_catalogue_cards"
  }
}

Input Schema

NameRequiredDescriptionDefault
setNoExact set ID from a catalogue response.
viewNocompact
afterNoCopy next_cursor unchanged. Stop when next_cursor is null.
limitNo
queryNoCase-insensitive card name match; empty browses the catalogue.
release_statusNoreleased

Output Schema

NameRequiredDescriptionDefault
okYes
apiYes
requestYes
http_statusYes
next_actionYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed1 schema field changed
    • changedOutput schema / properties / api / anyOf
      Previous value: -[
      -  {
      -    "additionalProperties": {},
      -    "properties": {
      -      "data": {
      -        "items": {
      -          "additionalProperties": {},
      -          "properties": {
      -            "canonical_membership": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": {},
      -                  "description": "The narrowly reviewed SoulSilver/HeartGold shared energy-card membership. Other cores return null. It does not assert an edition, foil finish or a new price variant.",
      -                  "properties": {
      -                    "alias_set_id": {
      -                      "const": "l1ss_ja",
      -                      "description": "Retained SoulSilver source-set membership. Both source records can exist; catalogue counts do not count unique physical printings.",
      -                      "type": "string"
      -                    },
      -                    "canonical_card_id": {
      -                      "description": "Existing HeartGold source-card record to which this reviewed membership points.",
      -                      "pattern": "^cat_[a-f0-9]{64}$",
      -                      "type": "string"
      -                    },
      -                    "canonical_set_id": {
      -                      "const": "l1hg_ja",
      -                      "description": "Canonical HeartGold source-set membership in this reviewed relation.",
      -                      "type": "string"
      -                    }
      -                  },
      -                  "required": [
      -                    "canonical_card_id",
      -                    "canonical_set_id",
      -                    "alias_set_id"
      -                  ],
      -                  "type": "object"
      -                },
      -                {
      -                  "description": "The narrowly reviewed SoulSilver/HeartGold shared energy-card membership. Other cores return null. It does not assert an edition, foil finish or a new price variant.",
      -                  "type": "null"
      -                }
      -              ],
      -              "description": "The narrowly reviewed SoulSilver/HeartGold shared energy-card membership. Other cores return null. It does not assert an edition, foil finish or a new price variant."
      -            },
      -            "catalogue_language": {
      -              "description": "Readable-address fields can be null for source cards without a verified price-variant route. Use the cat_ ID for source-card details.",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "data_provenance": {
      -              "description": "Structured source facts, a physically checked minimum or a retained source record, respectively. These labels do not promise equal metadata completeness or certify every field.",
      -              "enum": [
      -                "structured_source",
      -                "physical_minimum",
      -                "source_record"
      -              ],
      -              "type": "string"
      -            },
      -            "finish_details": {
      -              "additionalProperties": {},
      -              "description": "A source-card core does not choose a price guide bucket; guide_finish is null. Physical source-variant facts remain separate.",
      -              "properties": {
      -                "guide_finish": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "physical_finish": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "possible_physical_finishes": {
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": "array"
      -                }
      -              },
      -              "required": [
      -                "guide_finish",
      -                "physical_finish",
      -                "possible_physical_finishes"
      -              ],
      -              "type": "object"
      -            },
      -            "game": {
      -              "const": "pokemon_jp",
      -              "description": "The independent source-card catalogue currently supports Japanese Pokémon only. Stored tcg_ variants have a separate six-game catalogue.",
      -              "type": "string"
      -            },
      -            "id": {
      -              "description": "Stable Japanese source-card identity. It is not a tcg_ price-variant ID or a readable slug.",
      -              "pattern": "^cat_[a-f0-9]{64}$",
      -              "type": "string"
      -            },
      -            "images": {
      -              "additionalProperties": {},
      -              "description": "Nullable authenticated image paths for this cat_ card. A verified source image is independent of current price availability.",
      -              "properties": {
      -                "base": {
      -                  "type": "null"
      -                },
      -                "large": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                },
      -                "small": {
      -                  "type": [
      -                    "string",
      -                    "null"
      -                  ]
      -                }
      -              },
      -              "required": [
      -                "base",
      -                "small",
      -                "large"
      -              ],
      -              "type": "object"
      -            },
      -            "language": {
      -              "description": "Physical source-card locale, such as ja. It does not filter Cardmarket prices or certify the language of every metadata text field.",
      -              "type": "string"
      -            },
      -            "locale": {
      -              "description": "Physical source-card locale, such as ja. It does not filter Cardmarket prices or certify the language of every metadata text field.",
      -              "type": "string"
      -            },
      -            "metadata": {
      -              "anyOf": [
      -                {
      -                  "additionalProperties": {},
      -                  "description": "Validated Pokémon metadata. Its field meanings are in the Japanese game reference; source-card data remains available without a current price.",
      -                  "properties": {},
      -                  "type": "object"
      -                },
      -                {
      -                  "description": "Validated Pokémon metadata. Its field meanings are in the Japanese game reference; source-card data remains available without a current price.",
      -                  "type": "null"
      -                }
      -              ],
      -              "description": "Validated Pokémon metadata. Its field meanings are in the Japanese game reference; source-card data remains available without a current price."
      -            },
      -            "metadata_quality": {
      -              "additionalProperties": {},
      -              "description": "Availability, supported applicability and inferred text-language diagnostics for the core metadata. The nested source variants have their own diagnostics.",
      -              "properties": {
      -                "known_empty_fields": {
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": "array"
      -                },
      -                "not_applicable_fields": {
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": "array"
      -                },
      -                "scope": {
      -                  "const": "emitted_fields",
      -                  "type": "string"
      -                },
      -                "state": {
      -                  "enum": [
      -                    "complete",
      -                    "partial",
      -                    "unavailable"
      -                  ],
      -                  "type": "string"
      -                },
      -                "unknown_fields": {
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": "array"
      -                },
      -                "unverified_empty_fields": {
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": "array"
      -                }
      -              },
      -              "required": [
      -                "state",
      -                "scope",
      -                "unknown_fields",
      -                "not_applicable_fields",
      -                "known_empty_fields",
      -                "unverified_empty_fields"
      -              ],
      -              "type": "object"
      -            },
      -            "metadata_status": {
      -              "additionalProperties": {},
      -              "description": "Availability, supported applicability and inferred text-language diagnostics for the core metadata. The nested source variants have their own diagnostics.",
      -              "properties": {
      -                "state": {
      -                  "enum": [
      -                    "available",
      -                    "unavailable"
      -                  ],
      -                  "type": "string"
      -                },
      -                "unknown_fields": {
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": "array"
      -                },
      -                "unverified_empty_fields": {
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": "array"
      -                }
      -              },
      -              "required": [
      -                "state",
      -                "unknown_fields",
      -                "unverified_empty_fields"
      -              ],
      -              "type": "object"
      -            },
      -            "metadata_text": {
      -              "additionalProperties": {},
      -              "description": "Availability, supported applicability and inferred text-language diagnostics for the core metadata. The nested source variants have their own diagnostics.",
      -              "properties": {
      -                "fields": {
      -                  "items": {
      -                    "additionalProperties": {},
      -                    "properties": {
      -                      "evidence": {
      -                        "enum": [
      -                          "inferred",
      -                          "unknown"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      "languages": {
      -                        "items": {
      -                          "type": "string"
      -                        },
      -                        "type": "array"
      -                      },
      -                      "path": {
      -                        "description": "JSON Pointer relative to the metadata object.",
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "path",
      -                      "languages",
      -                      "evidence"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "languages": {
      -                  "items": {
      -                    "type": "string"
      -                  },
      -                  "type": "array"
      -                },
      -                "state": {
      -                  "enum": [
      -                    "mixed",
      -                    "single_language",
      -                    "unknown",
      -                    "unavailable"
      -                  ],
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "state",
      -                "languages",
      -                "fields"
      -              ],
      -              "type": "object"
      -            },
      -            "name": {
      -              "description": "Source-card name. A name change does not create a new catalogue ID.",
      -              "type": "string"
      -            },
      -            "number": {
      -              "description": "Source catalogue number. Preserve prefixes and leading zeroes; a catalogue ordinal is not necessarily printed on the card.",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "pricing": {
      -              "additionalProperties": {},
      -              "properties": {
      -                "price_variants": {
      -                  "description": "Exact approved, fresh and meaningful guide references. Follow each tcg_ ID to prices or history; the list can be empty while metadata stays readable.",
      -                  "items": {
      -                    "additionalProperties": {},
      -                    "properties": {
      -                      "catalogue_variant_id": {
      -                        "description": "Present only when a reviewed bridge explicitly links the price to a verified released source variant. Match it to variants[].id. Its absence means the reference is not attributed to one source-variant assertion.",
      -                        "type": "string"
      -                      },
      -                      "condition_scope": {
      -                        "const": "unfiltered",
      -                        "description": "Guide prices are not filtered by physical language, edition or condition. Catalogue ja locale or edition evidence does not change that market scope.",
      -                        "type": "string"
      -                      },
      -                      "currency": {
      -                        "const": "EUR",
      -                        "description": "Currency of the linked guide measurement.",
      -                        "type": "string"
      -                      },
      -                      "edition_scope": {
      -                        "const": "unfiltered",
      -                        "description": "Guide prices are not filtered by physical language, edition or condition. Catalogue ja locale or edition evidence does not change that market scope.",
      -                        "type": "string"
      -                      },
      -                      "guide_finish": {
      -                        "description": "Price-provider bucket, normally normal or foil. Use this for readable finish filters, regardless of the asserted physical finish.",
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "id": {
      -                        "description": "Permanent price-variant key. Use it on /v1/cards/{id}/prices or independent stored-variant history; a cat_ or catv_ ID is not a substitute.",
      -                        "type": "string"
      -                      },
      -                      "language_scope": {
      -                        "const": "unfiltered",
      -                        "description": "Guide prices are not filtered by physical language, edition or condition. Catalogue ja locale or edition evidence does not change that market scope.",
      -                        "type": "string"
      -                      },
      -                      "observed_at": {
      -                        "description": "Source observation time of the linked price; distinct from the catalogue snapshot build time.",
      -                        "format": "date-time",
      -                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      -                        "type": "string"
      -                      },
      -                      "quote_scope": {
      -                        "const": "product_guide",
      -                        "description": "General measurement of the approved product and guide bucket, not an individual listing or sale.",
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "id",
      -                      "guide_finish",
      -                      "currency",
      -                      "observed_at"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "type": "array"
      -                },
      -                "status": {
      -                  "description": "Core price availability: available, unmapped, unpriced, stale, unapproved, identity_conflict or unreleased. A safe available bridge can remain visible while a separate conflicting bridge is withheld.",
      -                  "enum": [
      -                    "available",
      -                    "unmapped",
      -                    "unpriced",
      -                    "stale",
      -                    "unapproved",
      -                    "identity_conflict",
      -                    "unreleased"
      -                  ],
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "status",
      -                "price_variants"
      -              ],
      -              "type": "object"
      -            },
      -            "printed_number": {
      -              "description": "Verified printed Pokémon collector notation, or null. Never derived from catalogue counts or ordinals.",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "release_status": {
      -              "description": "Core release classification. Lists default to released; all or an explicit state includes other cores. A detail lookup can retain an approved published core with another state.",
      -              "enum": [
      -                "released",
      -                "unreleased",
      -                "unknown"
      -              ],
      -              "type": "string"
      -            },
      -            "set_id": {
      -              "description": "Source-set identifier, or null when unavailable. This is a catalogue membership, not proof of a unique physical printing.",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "set_name": {
      -              "description": "Available source-set display name, or null.",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "slug": {
      -              "description": "Readable-address fields can be null for source cards without a verified price-variant route. Use the cat_ ID for source-card details.",
      -              "type": [
      -                "string",
      -                "null"
      -              ]
      -            },
      -            "snapshot_built_at": {
      -              "description": "Build time of this catalogue snapshot. It is distinct from pricing.price_variants[].observed_at and is not a price-freshness indicator.",
      -              "format": "date-time",
      -              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      -              "type": "string"
      -            },
      -            "variants": {
      -              "description": "Source variant assertions with catv_ IDs. Default output includes released verified/source_asserted variants; variant_release_status=all includes other labelled assertions. A source variant does not inherit a price from the core.",
      -              "items": {
      -                "additionalProperties": {},
      -                "properties": {
      -                  "edition": {
      -                    "description": "Supplied physical edition assertion, when known. It never makes an unfiltered guide quote edition-specific.",
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "evidence_status": {
      -                    "description": "Verified means reviewed evidence establishes the variant; source_asserted identifies a reviewed vendor assertion; uncertain is unresolved. Source assertions never become physical facts by guessing.",
      -                    "enum": [
      -                      "verified",
      -                      "source_asserted",
      -                      "uncertain"
      -                    ],
      -                    "type": "string"
      -                  },
      -                  "finish": {
      -                    "description": "Supplied physical finish assertion. Its reliability is described by evidence_status; it does not define the price-guide finish filter.",
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "id": {
      -                    "description": "Stable source-variant identity inside the parent cat_ record. There is no separate catv_ detail endpoint; tcg_ IDs identify price variants.",
      -                    "pattern": "^catv_[a-f0-9]{64}$",
      -                    "type": "string"
      -                  },
      -                  "images": {
      -                    "additionalProperties": {},
      -                    "description": "Verified released variant artwork only. Other assertions keep null images. catv_ paths include catalogue_card_id for the parent; preserve that parameter when downloading.",
      -                    "properties": {
      -                      "base": {
      -                        "type": "null"
      -                      },
      -                      "large": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      },
      -                      "small": {
      -                        "type": [
      -                          "string",
      -                          "null"
      -                        ]
      -                      }
      -                    },
      -                    "required": [
      -                      "base",
      -                      "small",
      -                      "large"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "label": {
      -                    "description": "Source-variant display label. It is not a guide bucket or a permanent identity.",
      -                    "type": "string"
      -                  },
      -                  "metadata": {
      -                    "anyOf": [
      -                      {
      -                        "additionalProperties": {},
      -                        "description": "The source variant's own Pokémon metadata. It can differ from or be unavailable independently of the core metadata.",
      -                        "properties": {},
      -                        "type": "object"
      -                      },
      -                      {
      -                        "description": "The source variant's own Pokémon metadata. It can differ from or be unavailable independently of the core metadata.",
      -                        "type": "null"
      -                      }
      -                    ],
      -                    "description": "The source variant's own Pokémon metadata. It can differ from or be unavailable independently of the core metadata."
      -                  },
      -                  "metadata_quality": {
      -                    "additionalProperties": {},
      -                    "description": "Diagnostics for this source variant's metadata, not the core record's quality or translation evidence.",
      -                    "properties": {
      -                      "known_empty_fields": {
      -                        "items": {
      -                          "type": "string"
      -                        },
      -                        "type": "array"
      -                      },
      -                      "not_applicable_fields": {
      -                        "items": {
      -                          "type": "string"
      -                        },
      -                        "type": "array"
      -                      },
      -                      "scope": {
      -                        "const": "emitted_fields",
      -                        "type": "string"
      -                      },
      -                      "state": {
      -                        "enum": [
      -                          "complete",
      -                          "partial",
      -                          "unavailable"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      "unknown_fields": {
      -                        "items": {
      -                          "type": "string"
      -                        },
      -                        "type": "array"
      -                      },
      -                      "unverified_empty_fields": {
      -                        "items": {
      -                          "type": "string"
      -                        },
      -                        "type": "array"
      -                      }
      -                    },
      -                    "required": [
      -                      "state",
      -                      "scope",
      -                      "unknown_fields",
      -                      "not_applicable_fields",
      -                      "known_empty_fields",
      -                      "unverified_empty_fields"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "metadata_status": {
      -                    "additionalProperties": {},
      -                    "description": "Diagnostics for this source variant's metadata, not the core record's quality or translation evidence.",
      -                    "properties": {
      -                      "state": {
      -                        "enum": [
      -                          "available",
      -                          "unavailable"
      -                        ],
      -                        "type": "string"
      -                      },
      -                      "unknown_fields": {
      -                        "items": {
      -                          "type": "string"
      -                        },
      -                        "type": "array"
      -                      },
      -                      "unverified_empty_fields": {
      -                        "items": {
      -                          "type": "string"
      -                        },
      -                        "type": "array"
      -                      }
      -                    },
      -                    "required": [
      -                      "state",
      -                      "unknown_fields",
      -                      "unverified_empty_fields"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "metadata_text": {
      -                    "additionalProperties": {},
      -                    "description": "Diagnostics for this source variant's metadata, not the core record's quality or translation evidence.",
      -                    "properties": {
      -                      "fields": {
      -                        "items": {
      -                          "additionalProperties": {},
      -                          "properties": {
      -                            "evidence": {
      -                              "enum": [
      -                                "inferred",
      -                                "unknown"
      -                              ],
      -                              "type": "string"
      -                            },
      -                            "languages": {
      -                              "items": {
      -                                "type": "string"
      -                              },
      -                              "type": "array"
      -                            },
      -                            "path": {
      -                              "description": "JSON Pointer relative to the metadata object.",
      -                              "type": "string"
      -                            }
      -                          },
      -                          "required": [
      -                            "path",
      -                            "languages",
      -                            "evidence"
      -                          ],
      -                          "type": "object"
      -                        },
      -                        "type": "array"
      -                      },
      -                      "languages": {
      -                        "items": {
      -                          "type": "string"
      -                        },
      -                        "type": "array"
      -                      },
      -                      "state": {
      -                        "enum": [
      -                          "mixed",
      -                          "single_language",
      -                          "unknown",
      -                          "unavailable"
      -                        ],
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "state",
      -                      "languages",
      -                      "fields"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "number": {
      -                    "description": "Source-variant catalogue number, kept separate from verified printed_number.",
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "pricing": {
      -                    "additionalProperties": {},
      -                    "description": "This assertion's own pricing status and exact price references. Only an explicit verified released variant bridge can attach a quote here.",
      -                    "properties": {
      -                      "price_variants": {
      -                        "description": "Exact approved, fresh and meaningful guide references. Follow each tcg_ ID to prices or history; the list can be empty while metadata stays readable.",
      -                        "items": {
      -                          "additionalProperties": {},
      -                          "properties": {
      -                            "catalogue_variant_id": {
      -                              "description": "Present only when a reviewed bridge explicitly links the price to a verified released source variant. Match it to variants[].id. Its absence means the reference is not attributed to one source-variant assertion.",
      -                              "type": "string"
      -                            },
      -                            "condition_scope": {
      -                              "const": "unfiltered",
      -                              "description": "Guide prices are not filtered by physical language, edition or condition. Catalogue ja locale or edition evidence does not change that market scope.",
      -                              "type": "string"
      -                            },
      -                            "currency": {
      -                              "const": "EUR",
      -                              "description": "Currency of the linked guide measurement.",
      -                              "type": "string"
      -                            },
      -                            "edition_scope": {
      -                              "const": "unfiltered",
      -                              "description": "Guide prices are not filtered by physical language, edition or condition. Catalogue ja locale or edition evidence does not change that market scope.",
      -                              "type": "string"
      -                            },
      -                            "guide_finish": {
      -                              "description": "Price-provider bucket, normally normal or foil. Use this for readable finish filters, regardless of the asserted physical finish.",
      -                              "type": [
      -                                "string",
      -                                "null"
      -                              ]
      -                            },
      -                            "id": {
      -                              "description": "Permanent price-variant key. Use it on /v1/cards/{id}/prices or independent stored-variant history; a cat_ or catv_ ID is not a substitute.",
      -                              "type": "string"
      -                            },
      -                            "language_scope": {
      -                              "const": "unfiltered",
      -                              "description": "Guide prices are not filtered by physical language, edition or condition. Catalogue ja locale or edition evidence does not change that market scope.",
      -                              "type": "string"
      -                            },
      -                            "observed_at": {
      -                              "description": "Source observation time of the linked price; distinct from the catalogue snapshot build time.",
      -                              "format": "date-time",
      -                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      -                              "type": "string"
      -                            },
      -                            "quote_scope": {
      -                              "const": "product_guide",
      -                              "description": "General measurement of the approved product and guide bucket, not an individual listing or sale.",
      -                              "type": "string"
      -                            }
      -                          },
      -                          "required": [
      -                            "id",
      -                            "guide_finish",
      -                            "currency",
      -                            "observed_at"
      -                          ],
      -                          "type": "object"
      -                        },
      -                        "type": "array"
      -                      },
      -                      "status": {
      -                        "description": "Core price availability: available, unmapped, unpriced, stale, unapproved, identity_conflict or unreleased. A safe available bridge can remain visible while a separate conflicting bridge is withheld.",
      -                        "enum": [
      -                          "available",
      -                          "unmapped",
      -                          "unpriced",
      -                          "stale",
      -                          "unapproved",
      -                          "identity_conflict",
      -                          "unreleased"
      -                        ],
      -                        "type": "string"
      -                      }
      -                    },
      -                    "required": [
      -                      "status",
      -                      "price_variants"
      -                    ],
      -                    "type": "object"
      -                  },
      -                  "printed_number": {
      -                    "description": "Printed notation supplied in the variant's own validated metadata, or null.",
      -                    "type": [
      -                      "string",
      -                      "null"
      -                    ]
      -                  },
      -                  "release_status": {
      -                    "description": "Release classification of the assertion, separate from the core release_status. The variant_release_status filter controls which assertions are returned.",
      -                    "enum": [
      -                      "released",
      -                      "unreleased",
      -                      "unknown"
      -                    ],
      -                    "type": "string"
      -                  }
      -                },
      -                "type": "object"
      -              },
      -              "type": "array"
      -            }
      -          },
      -          "required": [
      -            "id"
      -          ],
      -          "type": "object"
      -        },
      -        "type": "array"
      -      },
      -      "next_cursor": {
      -        "type": [
      -          "string",
      -          "null"
      -        ]
      -      }
      -    },
      -    "required": [
      -      "data",
      -      "next_cursor"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "additionalProperties": {},
      -    "description": "REST error. Stable field validation and recovery: https://tcgdata.dev/docs/agents/errors.md.",
      -    "properties": {
      -      "error": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "code": {
      -            "type": "string"
      -          },
      -          "details": {
      -            "items": {},
      -            "type": "array"
      -          },
      -          "message": {
      -            "type": "string"
      -          },
      -          "request_id": {
      -            "type": "string"
      -          },
      -          "validation": {
      -            "items": {
      -              "additionalProperties": false,
      -              "properties": {
      -                "code": {
      -                  "enum": [
      -                    "invalid_type",
      -                    "too_small",
      -                    "too_large",
      -                    "invalid_format",
      -                    "invalid_value",
      -                    "unknown_field"
      -                  ],
      -                  "type": "string"
      -                },
      -                "constraints": {
      -                  "additionalProperties": false,
      -                  "properties": {
      -                    "allowed_values": {
      -                      "items": {
      -                        "type": [
      -                          "string",
      -                          "number",
      -                          "boolean",
      -                          "null"
      -                        ]
      -                      },
      -                      "type": "array"
      -                    },
      -                    "expected_type": {
      -                      "type": "string"
      -                    },
      -                    "format": {
      -                      "type": "string"
      -                    },
      -                    "inclusive": {
      -                      "type": "boolean"
      -                    },
      -                    "maximum": {
      -                      "type": "number"
      -                    },
      -                    "maximum_date": {
      -                      "format": "date",
      -                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
      -                      "type": "string"
      -                    },
      -                    "minimum": {
      -                      "type": "number"
      -                    },
      -                    "minimum_date": {
      -                      "format": "date",
      -                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
      -                      "type": "string"
      -                    },
      -                    "unit": {
      -                      "enum": [
      -                        "value",
      -                        "characters",
      -                        "items"
      -                      ],
      -                      "type": "string"
      -                    }
      -                  },
      -                  "type": "object"
      -                },
      -                "field": {
      -                  "type": "string"
      -                },
      -                "message": {
      -                  "type": "string"
      -                }
      -              },
      -              "required": [
      -                "field",
      -                "code",
      -                "message"
      -              ],
      -              "type": "object"
      -            },
      -            "type": "array"
      -          }
      -        },
      -        "required": [
      -          "code",
      -          "message"
      -        ],
      -        "type": "object"
      -      },
      -      "upgrade": {
      -        "additionalProperties": {},
      -        "properties": {
      -          "activation": {
      -            "enum": [
      -              "payment",
      -              "manual"
      -            ],
      -            "type": "string"
      -          },
      -          "current_plan": {
      -            "type": [
      -              "string",
      -              "null"
      -            ]
      -          },
      -          "message": {
      -            "type": "string"
      -          },
      -          "reason": {
      -            "enum": [
      -              "monthly_request_limit",
      -              "daily_request_limit",
      -              "rate_limited",
      -              "trial_expired"
      -            ],
      -            "type": "string"
      -          },
      -          "recommended_plan": {
      -            "anyOf": [
      -              {
      -                "additionalProperties": {},
      -                "properties": {
      -                  "batch_size": {
      -                    "maximum": 200,
      -                    "minimum": 1,
      -                    "type": "integer"
      -                  },
      -                  "currency": {
      -                    "const": "EUR",
      -                    "type": "string"
      -                  },
      -                  "daily_requests": {
      -                    "maximum": 9007199254740991,
      -                    "minimum": 1,
      -                    "type": "integer"
      -                  },
      -                  "id": {
      -                    "type": "string"
      -                  },
      -                  "monthly_eur": {
      -                    "minimum": 0,
      -                    "type": "number"
      -                  },
      -                  "monthly_requests": {
      -                    "maximum": 9007199254740991,
      -                    "minimum": 1,
      -                    "type": "integer"
      -                  },
      -                  "name": {
      -                    "type": "string"
      -                  },
      -                  "requests_per_minute": {
      -                    "maximum": 9007199254740991,
      -                    "minimum": 1,
      -                    "type": "integer"
      -                  }
      -                },
      -                "required": [
      -                  "id",
      -                  "name",
      -                  "monthly_eur",
      -                  "currency",
      -                  "monthly_requests",
      -                  "daily_requests",
      -                  "requests_per_minute",
      -                  "batch_size"
      -                ],
      -                "type": "object"
      -              },
      -              {
      -                "type": "null"
      -              }
      -            ]
      -          },
      -          "request_url": {
      -            "type": "string"
      -          },
      -          "resets_at": {
      -            "format": "date-time",
      -            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      -            "type": "string"
      -          }
      -        },
      -        "required": [
      -          "activation",
      -          "reason",
      -          "message",
      -          "current_plan",
      -          "recommended_plan",
      -          "request_url",
      -          "resets_at"
      -        ],
      -        "type": "object"
      -      }
      -    },
      -    "required": [
      -      "error"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "additionalProperties": {},
      +    "properties": {
      +      "data": {
      +        "items": {
      +          "additionalProperties": {},
      +          "properties": {
      +            "canonical_membership": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": {},
      +                  "description": "The narrowly reviewed SoulSilver/HeartGold shared energy-card membership. Other cores return null. It does not assert an edition, foil finish or a new price variant.",
      +                  "properties": {
      +                    "alias_set_id": {
      +                      "const": "l1ss_ja",
      +                      "description": "Retained SoulSilver source-set membership. Both source records can exist; catalogue counts do not count unique physical printings.",
      +                      "type": "string"
      +                    },
      +                    "canonical_card_id": {
      +                      "description": "Existing HeartGold source-card record to which this reviewed membership points.",
      +                      "pattern": "^cat_[a-f0-9]{64}$",
      +                      "type": "string"
      +                    },
      +                    "canonical_set_id": {
      +                      "const": "l1hg_ja",
      +                      "description": "Canonical HeartGold source-set membership in this reviewed relation.",
      +                      "type": "string"
      +                    }
      +                  },
      +                  "required": [
      +                    "canonical_card_id",
      +                    "canonical_set_id",
      +                    "alias_set_id"
      +                  ],
      +                  "type": "object"
      +                },
      +                {
      +                  "description": "The narrowly reviewed SoulSilver/HeartGold shared energy-card membership. Other cores return null. It does not assert an edition, foil finish or a new price variant.",
      +                  "type": "null"
      +                }
      +              ],
      +              "description": "The narrowly reviewed SoulSilver/HeartGold shared energy-card membership. Other cores return null. It does not assert an edition, foil finish or a new price variant."
      +            },
      +            "catalogue_language": {
      +              "description": "Readable-address fields can be null for source cards without a verified price-variant route. Use the cat_ ID for source-card details.",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "data_provenance": {
      +              "description": "Structured source facts, a physically checked minimum or a retained source record, respectively. These labels do not promise equal metadata completeness or certify every field.",
      +              "enum": [
      +                "structured_source",
      +                "physical_minimum",
      +                "source_record"
      +              ],
      +              "type": "string"
      +            },
      +            "finish_details": {
      +              "additionalProperties": {},
      +              "description": "A source-card core does not choose a price guide bucket; guide_finish is null. Physical source-variant facts remain separate.",
      +              "properties": {
      +                "guide_finish": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "physical_finish": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "possible_physical_finishes": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                }
      +              },
      +              "required": [
      +                "guide_finish",
      +                "physical_finish",
      +                "possible_physical_finishes"
      +              ],
      +              "type": "object"
      +            },
      +            "game": {
      +              "const": "pokemon_jp",
      +              "description": "The independent source-card catalogue currently supports Japanese Pokémon only. Stored tcg_ variants have a separate five-game catalogue.",
      +              "type": "string"
      +            },
      +            "id": {
      +              "description": "Stable Japanese source-card identity. It is not a tcg_ price-variant ID or a readable slug.",
      +              "pattern": "^cat_[a-f0-9]{64}$",
      +              "type": "string"
      +            },
      +            "images": {
      +              "additionalProperties": {},
      +              "description": "Nullable authenticated image paths for this cat_ card. A verified source image is independent of current price availability.",
      +              "properties": {
      +                "base": {
      +                  "type": "null"
      +                },
      +                "large": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                },
      +                "small": {
      +                  "type": [
      +                    "string",
      +                    "null"
      +                  ]
      +                }
      +              },
      +              "required": [
      +                "base",
      +                "small",
      +                "large"
      +              ],
      +              "type": "object"
      +            },
      +            "language": {
      +              "description": "Physical source-card locale, such as ja. It does not filter Cardmarket prices or certify the language of every metadata text field.",
      +              "type": "string"
      +            },
      +            "locale": {
      +              "description": "Physical source-card locale, such as ja. It does not filter Cardmarket prices or certify the language of every metadata text field.",
      +              "type": "string"
      +            },
      +            "metadata": {
      +              "anyOf": [
      +                {
      +                  "additionalProperties": {},
      +                  "description": "Validated Pokémon metadata. Its field meanings are in the Japanese game reference; source-card data remains available without a current price.",
      +                  "properties": {},
      +                  "type": "object"
      +                },
      +                {
      +                  "description": "Validated Pokémon metadata. Its field meanings are in the Japanese game reference; source-card data remains available without a current price.",
      +                  "type": "null"
      +                }
      +              ],
      +              "description": "Validated Pokémon metadata. Its field meanings are in the Japanese game reference; source-card data remains available without a current price."
      +            },
      +            "metadata_quality": {
      +              "additionalProperties": {},
      +              "description": "Availability, supported applicability and inferred text-language diagnostics for the core metadata. The nested source variants have their own diagnostics.",
      +              "properties": {
      +                "known_empty_fields": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                "not_applicable_fields": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                "scope": {
      +                  "const": "emitted_fields",
      +                  "type": "string"
      +                },
      +                "state": {
      +                  "enum": [
      +                    "complete",
      +                    "partial",
      +                    "unavailable"
      +                  ],
      +                  "type": "string"
      +                },
      +                "unknown_fields": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                "unverified_empty_fields": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                }
      +              },
      +              "required": [
      +                "state",
      +                "scope",
      +                "unknown_fields",
      +                "not_applicable_fields",
      +                "known_empty_fields",
      +                "unverified_empty_fields"
      +              ],
      +              "type": "object"
      +            },
      +            "metadata_status": {
      +              "additionalProperties": {},
      +              "description": "Availability, supported applicability and inferred text-language diagnostics for the core metadata. The nested source variants have their own diagnostics.",
      +              "properties": {
      +                "state": {
      +                  "enum": [
      +                    "available",
      +                    "unavailable"
      +                  ],
      +                  "type": "string"
      +                },
      +                "unknown_fields": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                "unverified_empty_fields": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                }
      +              },
      +              "required": [
      +                "state",
      +                "unknown_fields",
      +                "unverified_empty_fields"
      +              ],
      +              "type": "object"
      +            },
      +            "metadata_text": {
      +              "additionalProperties": {},
      +              "description": "Availability, supported applicability and inferred text-language diagnostics for the core metadata. The nested source variants have their own diagnostics.",
      +              "properties": {
      +                "fields": {
      +                  "items": {
      +                    "additionalProperties": {},
      +                    "properties": {
      +                      "evidence": {
      +                        "enum": [
      +                          "inferred",
      +                          "unknown"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      "languages": {
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "path": {
      +                        "description": "JSON Pointer relative to the metadata object.",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "path",
      +                      "languages",
      +                      "evidence"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "languages": {
      +                  "items": {
      +                    "type": "string"
      +                  },
      +                  "type": "array"
      +                },
      +                "state": {
      +                  "enum": [
      +                    "mixed",
      +                    "single_language",
      +                    "unknown",
      +                    "unavailable"
      +                  ],
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "state",
      +                "languages",
      +                "fields"
      +              ],
      +              "type": "object"
      +            },
      +            "name": {
      +              "description": "Source-card name. A name change does not create a new catalogue ID.",
      +              "type": "string"
      +            },
      +            "number": {
      +              "description": "Source catalogue number. Preserve prefixes and leading zeroes; a catalogue ordinal is not necessarily printed on the card.",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "pricing": {
      +              "additionalProperties": {},
      +              "properties": {
      +                "price_variants": {
      +                  "description": "Exact approved, fresh and meaningful guide references. Follow each tcg_ ID to prices or history; the list can be empty while metadata stays readable.",
      +                  "items": {
      +                    "additionalProperties": {},
      +                    "properties": {
      +                      "catalogue_variant_id": {
      +                        "description": "Present only when a reviewed bridge explicitly links the price to a verified released source variant. Match it to variants[].id. Its absence means the reference is not attributed to one source-variant assertion.",
      +                        "type": "string"
      +                      },
      +                      "condition_scope": {
      +                        "const": "unfiltered",
      +                        "description": "Guide prices are not filtered by physical language, edition or condition. Catalogue ja locale or edition evidence does not change that market scope.",
      +                        "type": "string"
      +                      },
      +                      "currency": {
      +                        "const": "EUR",
      +                        "description": "Currency of the linked guide measurement.",
      +                        "type": "string"
      +                      },
      +                      "edition_scope": {
      +                        "const": "unfiltered",
      +                        "description": "Guide prices are not filtered by physical language, edition or condition. Catalogue ja locale or edition evidence does not change that market scope.",
      +                        "type": "string"
      +                      },
      +                      "guide_finish": {
      +                        "description": "Price-provider bucket, normally normal or foil. Use this for readable finish filters, regardless of the asserted physical finish.",
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "id": {
      +                        "description": "Permanent price-variant key. Use it on /v1/cards/{id}/prices or independent stored-variant history; a cat_ or catv_ ID is not a substitute.",
      +                        "type": "string"
      +                      },
      +                      "language_scope": {
      +                        "const": "unfiltered",
      +                        "description": "Guide prices are not filtered by physical language, edition or condition. Catalogue ja locale or edition evidence does not change that market scope.",
      +                        "type": "string"
      +                      },
      +                      "observed_at": {
      +                        "description": "Source observation time of the linked price; distinct from the catalogue snapshot build time.",
      +                        "format": "date-time",
      +                        "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      +                        "type": "string"
      +                      },
      +                      "quote_scope": {
      +                        "const": "product_guide",
      +                        "description": "General measurement of the approved product and guide bucket, not an individual listing or sale.",
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "id",
      +                      "guide_finish",
      +                      "currency",
      +                      "observed_at"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "type": "array"
      +                },
      +                "status": {
      +                  "description": "Core price availability: available, unmapped, unpriced, stale, unapproved, identity_conflict or unreleased. A safe available bridge can remain visible while a separate conflicting bridge is withheld.",
      +                  "enum": [
      +                    "available",
      +                    "unmapped",
      +                    "unpriced",
      +                    "stale",
      +                    "unapproved",
      +                    "identity_conflict",
      +                    "unreleased"
      +                  ],
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "status",
      +                "price_variants"
      +              ],
      +              "type": "object"
      +            },
      +            "printed_number": {
      +              "description": "Verified printed Pokémon collector notation, or null. Never derived from catalogue counts or ordinals.",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "release_status": {
      +              "description": "Core release classification. Lists default to released; all or an explicit state includes other cores. A detail lookup can retain an approved published core with another state.",
      +              "enum": [
      +                "released",
      +                "unreleased",
      +                "unknown"
      +              ],
      +              "type": "string"
      +            },
      +            "set_id": {
      +              "description": "Source-set identifier, or null when unavailable. This is a catalogue membership, not proof of a unique physical printing.",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "set_name": {
      +              "description": "Available source-set display name, or null.",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "slug": {
      +              "description": "Readable-address fields can be null for source cards without a verified price-variant route. Use the cat_ ID for source-card details.",
      +              "type": [
      +                "string",
      +                "null"
      +              ]
      +            },
      +            "snapshot_built_at": {
      +              "description": "Build time of this catalogue snapshot. It is distinct from pricing.price_variants[].observed_at and is not a price-freshness indicator.",
      +              "format": "date-time",
      +              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      +              "type": "string"
      +            },
      +            "variants": {
      +              "description": "Source variant assertions with catv_ IDs. Default output includes released verified/source_asserted variants; variant_release_status=all includes other labelled assertions. A source variant does not inherit a price from the core.",
      +              "items": {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "edition": {
      +                    "description": "Supplied physical edition assertion, when known. It never makes an unfiltered guide quote edition-specific.",
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "evidence_status": {
      +                    "description": "Verified means reviewed evidence establishes the variant; source_asserted identifies a reviewed vendor assertion; uncertain is unresolved. Source assertions never become physical facts by guessing.",
      +                    "enum": [
      +                      "verified",
      +                      "source_asserted",
      +                      "uncertain"
      +                    ],
      +                    "type": "string"
      +                  },
      +                  "finish": {
      +                    "description": "Supplied physical finish assertion. Its reliability is described by evidence_status; it does not define the price-guide finish filter.",
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "id": {
      +                    "description": "Stable source-variant identity inside the parent cat_ record. There is no separate catv_ detail endpoint; tcg_ IDs identify price variants.",
      +                    "pattern": "^catv_[a-f0-9]{64}$",
      +                    "type": "string"
      +                  },
      +                  "images": {
      +                    "additionalProperties": {},
      +                    "description": "Verified released variant artwork only. Other assertions keep null images. catv_ paths include catalogue_card_id for the parent; preserve that parameter when downloading.",
      +                    "properties": {
      +                      "base": {
      +                        "type": "null"
      +                      },
      +                      "large": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      },
      +                      "small": {
      +                        "type": [
      +                          "string",
      +                          "null"
      +                        ]
      +                      }
      +                    },
      +                    "required": [
      +                      "base",
      +                      "small",
      +                      "large"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "label": {
      +                    "description": "Source-variant display label. It is not a guide bucket or a permanent identity.",
      +                    "type": "string"
      +                  },
      +                  "metadata": {
      +                    "anyOf": [
      +                      {
      +                        "additionalProperties": {},
      +                        "description": "The source variant's own Pokémon metadata. It can differ from or be unavailable independently of the core metadata.",
      +                        "properties": {},
      +                        "type": "object"
      +                      },
      +                      {
      +                        "description": "The source variant's own Pokémon metadata. It can differ from or be unavailable independently of the core metadata.",
      +                        "type": "null"
      +                      }
      +                    ],
      +                    "description": "The source variant's own Pokémon metadata. It can differ from or be unavailable independently of the core metadata."
      +                  },
      +                  "metadata_quality": {
      +                    "additionalProperties": {},
      +                    "description": "Diagnostics for this source variant's metadata, not the core record's quality or translation evidence.",
      +                    "properties": {
      +                      "known_empty_fields": {
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "not_applicable_fields": {
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "scope": {
      +                        "const": "emitted_fields",
      +                        "type": "string"
      +                      },
      +                      "state": {
      +                        "enum": [
      +                          "complete",
      +                          "partial",
      +                          "unavailable"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      "unknown_fields": {
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "unverified_empty_fields": {
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      }
      +                    },
      +                    "required": [
      +                      "state",
      +                      "scope",
      +                      "unknown_fields",
      +                      "not_applicable_fields",
      +                      "known_empty_fields",
      +                      "unverified_empty_fields"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "metadata_status": {
      +                    "additionalProperties": {},
      +                    "description": "Diagnostics for this source variant's metadata, not the core record's quality or translation evidence.",
      +                    "properties": {
      +                      "state": {
      +                        "enum": [
      +                          "available",
      +                          "unavailable"
      +                        ],
      +                        "type": "string"
      +                      },
      +                      "unknown_fields": {
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "unverified_empty_fields": {
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      }
      +                    },
      +                    "required": [
      +                      "state",
      +                      "unknown_fields",
      +                      "unverified_empty_fields"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "metadata_text": {
      +                    "additionalProperties": {},
      +                    "description": "Diagnostics for this source variant's metadata, not the core record's quality or translation evidence.",
      +                    "properties": {
      +                      "fields": {
      +                        "items": {
      +                          "additionalProperties": {},
      +                          "properties": {
      +                            "evidence": {
      +                              "enum": [
      +                                "inferred",
      +                                "unknown"
      +                              ],
      +                              "type": "string"
      +                            },
      +                            "languages": {
      +                              "items": {
      +                                "type": "string"
      +                              },
      +                              "type": "array"
      +                            },
      +                            "path": {
      +                              "description": "JSON Pointer relative to the metadata object.",
      +                              "type": "string"
      +                            }
      +                          },
      +                          "required": [
      +                            "path",
      +                            "languages",
      +                            "evidence"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "languages": {
      +                        "items": {
      +                          "type": "string"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "state": {
      +                        "enum": [
      +                          "mixed",
      +                          "single_language",
      +                          "unknown",
      +                          "unavailable"
      +                        ],
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "state",
      +                      "languages",
      +                      "fields"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "number": {
      +                    "description": "Source-variant catalogue number, kept separate from verified printed_number.",
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "pricing": {
      +                    "additionalProperties": {},
      +                    "description": "This assertion's own pricing status and exact price references. Only an explicit verified released variant bridge can attach a quote here.",
      +                    "properties": {
      +                      "price_variants": {
      +                        "description": "Exact approved, fresh and meaningful guide references. Follow each tcg_ ID to prices or history; the list can be empty while metadata stays readable.",
      +                        "items": {
      +                          "additionalProperties": {},
      +                          "properties": {
      +                            "catalogue_variant_id": {
      +                              "description": "Present only when a reviewed bridge explicitly links the price to a verified released source variant. Match it to variants[].id. Its absence means the reference is not attributed to one source-variant assertion.",
      +                              "type": "string"
      +                            },
      +                            "condition_scope": {
      +                              "const": "unfiltered",
      +                              "description": "Guide prices are not filtered by physical language, edition or condition. Catalogue ja locale or edition evidence does not change that market scope.",
      +                              "type": "string"
      +                            },
      +                            "currency": {
      +                              "const": "EUR",
      +                              "description": "Currency of the linked guide measurement.",
      +                              "type": "string"
      +                            },
      +                            "edition_scope": {
      +                              "const": "unfiltered",
      +                              "description": "Guide prices are not filtered by physical language, edition or condition. Catalogue ja locale or edition evidence does not change that market scope.",
      +                              "type": "string"
      +                            },
      +                            "guide_finish": {
      +                              "description": "Price-provider bucket, normally normal or foil. Use this for readable finish filters, regardless of the asserted physical finish.",
      +                              "type": [
      +                                "string",
      +                                "null"
      +                              ]
      +                            },
      +                            "id": {
      +                              "description": "Permanent price-variant key. Use it on /v1/cards/{id}/prices or independent stored-variant history; a cat_ or catv_ ID is not a substitute.",
      +                              "type": "string"
      +                            },
      +                            "language_scope": {
      +                              "const": "unfiltered",
      +                              "description": "Guide prices are not filtered by physical language, edition or condition. Catalogue ja locale or edition evidence does not change that market scope.",
      +                              "type": "string"
      +                            },
      +                            "observed_at": {
      +                              "description": "Source observation time of the linked price; distinct from the catalogue snapshot build time.",
      +                              "format": "date-time",
      +                              "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      +                              "type": "string"
      +                            },
      +                            "quote_scope": {
      +                              "const": "product_guide",
      +                              "description": "General measurement of the approved product and guide bucket, not an individual listing or sale.",
      +                              "type": "string"
      +                            }
      +                          },
      +                          "required": [
      +                            "id",
      +                            "guide_finish",
      +                            "currency",
      +                            "observed_at"
      +                          ],
      +                          "type": "object"
      +                        },
      +                        "type": "array"
      +                      },
      +                      "status": {
      +                        "description": "Core price availability: available, unmapped, unpriced, stale, unapproved, identity_conflict or unreleased. A safe available bridge can remain visible while a separate conflicting bridge is withheld.",
      +                        "enum": [
      +                          "available",
      +                          "unmapped",
      +                          "unpriced",
      +                          "stale",
      +                          "unapproved",
      +                          "identity_conflict",
      +                          "unreleased"
      +                        ],
      +                        "type": "string"
      +                      }
      +                    },
      +                    "required": [
      +                      "status",
      +                      "price_variants"
      +                    ],
      +                    "type": "object"
      +                  },
      +                  "printed_number": {
      +                    "description": "Printed notation supplied in the variant's own validated metadata, or null.",
      +                    "type": [
      +                      "string",
      +                      "null"
      +                    ]
      +                  },
      +                  "release_status": {
      +                    "description": "Release classification of the assertion, separate from the core release_status. The variant_release_status filter controls which assertions are returned.",
      +                    "enum": [
      +                      "released",
      +                      "unreleased",
      +                      "unknown"
      +                    ],
      +                    "type": "string"
      +                  }
      +                },
      +                "type": "object"
      +              },
      +              "type": "array"
      +            }
      +          },
      +          "required": [
      +            "id"
      +          ],
      +          "type": "object"
      +        },
      +        "type": "array"
      +      },
      +      "next_cursor": {
      +        "type": [
      +          "string",
      +          "null"
      +        ]
      +      }
      +    },
      +    "required": [
      +      "data",
      +      "next_cursor"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "additionalProperties": {},
      +    "description": "REST error. Stable field validation and recovery: https://tcgdata.dev/docs/agents/errors.md.",
      +    "properties": {
      +      "error": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "code": {
      +            "type": "string"
      +          },
      +          "details": {
      +            "items": {},
      +            "type": "array"
      +          },
      +          "message": {
      +            "type": "string"
      +          },
      +          "request_id": {
      +            "type": "string"
      +          },
      +          "validation": {
      +            "items": {
      +              "additionalProperties": false,
      +              "properties": {
      +                "code": {
      +                  "enum": [
      +                    "invalid_type",
      +                    "too_small",
      +                    "too_large",
      +                    "invalid_format",
      +                    "invalid_value",
      +                    "unknown_field"
      +                  ],
      +                  "type": "string"
      +                },
      +                "constraints": {
      +                  "additionalProperties": false,
      +                  "properties": {
      +                    "allowed_values": {
      +                      "items": {
      +                        "type": [
      +                          "string",
      +                          "number",
      +                          "boolean",
      +                          "null"
      +                        ]
      +                      },
      +                      "type": "array"
      +                    },
      +                    "expected_type": {
      +                      "type": "string"
      +                    },
      +                    "format": {
      +                      "type": "string"
      +                    },
      +                    "inclusive": {
      +                      "type": "boolean"
      +                    },
      +                    "maximum": {
      +                      "type": "number"
      +                    },
      +                    "maximum_date": {
      +                      "format": "date",
      +                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
      +                      "type": "string"
      +                    },
      +                    "minimum": {
      +                      "type": "number"
      +                    },
      +                    "minimum_date": {
      +                      "format": "date",
      +                      "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))$",
      +                      "type": "string"
      +                    },
      +                    "unit": {
      +                      "enum": [
      +                        "value",
      +                        "characters",
      +                        "items"
      +                      ],
      +                      "type": "string"
      +                    }
      +                  },
      +                  "type": "object"
      +                },
      +                "field": {
      +                  "type": "string"
      +                },
      +                "message": {
      +                  "type": "string"
      +                }
      +              },
      +              "required": [
      +                "field",
      +                "code",
      +                "message"
      +              ],
      +              "type": "object"
      +            },
      +            "type": "array"
      +          }
      +        },
      +        "required": [
      +          "code",
      +          "message"
      +        ],
      +        "type": "object"
      +      },
      +      "upgrade": {
      +        "additionalProperties": {},
      +        "properties": {
      +          "activation": {
      +            "enum": [
      +              "payment",
      +              "manual"
      +            ],
      +            "type": "string"
      +          },
      +          "current_plan": {
      +            "type": [
      +              "string",
      +              "null"
      +            ]
      +          },
      +          "message": {
      +            "type": "string"
      +          },
      +          "reason": {
      +            "enum": [
      +              "monthly_request_limit",
      +              "daily_request_limit",
      +              "rate_limited",
      +              "trial_expired"
      +            ],
      +            "type": "string"
      +          },
      +          "recommended_plan": {
      +            "anyOf": [
      +              {
      +                "additionalProperties": {},
      +                "properties": {
      +                  "batch_size": {
      +                    "maximum": 200,
      +                    "minimum": 1,
      +                    "type": "integer"
      +                  },
      +                  "currency": {
      +                    "const": "EUR",
      +                    "type": "string"
      +                  },
      +                  "daily_requests": {
      +                    "maximum": 9007199254740991,
      +                    "minimum": 1,
      +                    "type": "integer"
      +                  },
      +                  "id": {
      +                    "type": "string"
      +                  },
      +                  "monthly_eur": {
      +                    "minimum": 0,
      +                    "type": "number"
      +                  },
      +                  "monthly_requests": {
      +                    "maximum": 9007199254740991,
      +                    "minimum": 1,
      +                    "type": "integer"
      +                  },
      +                  "name": {
      +                    "type": "string"
      +                  },
      +                  "requests_per_minute": {
      +                    "maximum": 9007199254740991,
      +                    "minimum": 1,
      +                    "type": "integer"
      +                  }
      +                },
      +                "required": [
      +                  "id",
      +                  "name",
      +                  "monthly_eur",
      +                  "currency",
      +                  "monthly_requests",
      +                  "daily_requests",
      +                  "requests_per_minute",
      +                  "batch_size"
      +                ],
      +                "type": "object"
      +              },
      +              {
      +                "type": "null"
      +              }
      +            ]
      +          },
      +          "request_url": {
      +            "type": "string"
      +          },
      +          "resets_at": {
      +            "format": "date-time",
      +            "pattern": "^(?:(?:\\d\\d[2468][048]|\\d\\d[13579][26]|\\d\\d0[48]|[02468][048]00|[13579][26]00)-02-29|\\d{4}-(?:(?:0[13578]|1[02])-(?:0[1-9]|[12]\\d|3[01])|(?:0[469]|11)-(?:0[1-9]|[12]\\d|30)|(?:02)-(?:0[1-9]|1\\d|2[0-8])))T(?:(?:[01]\\d|2[0-3]):[0-5]\\d:[0-5]\\d(?:\\.\\d+)?(?:Z|([+-](?:[01]\\d|2[0-3]):[0-5]\\d)))$",
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "activation",
      +          "reason",
      +          "message",
      +          "current_plan",
      +          "recommended_plan",
      +          "request_url",
      +          "resets_at"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. First observed

TDQS

A4.1/5.0
Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Goes well beyond the annotations by disclosing a quota/cost model: one admitted call consumes one shared account request, admitted errors count, and there are no automatic retries. This is exactly the kind of operational context annotations cannot carry. It stops short of describing result shape, which is acceptable given the output schema.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Front-loaded with the scope first, then identifier semantics, then the quota caveat. Dense and telegraphic in places ("cat_ identifies a source card"), but no sentence is wasted.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a read-only search with an output schema and cursor guidance already in the schema, the definition covers purpose, sibling boundary, quota, and retry behavior. The only gap is that view=compact vs full is never explained, leaving an agent to guess at result verbosity.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 50% and the description adds no per-parameter meaning; the undocumented fields (view, release_status) rely on their enum values and defaults being self-explanatory. The identifier-prefix explanation adds semantic value about results rather than inputs, so the baseline 3 holds.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ("Search the price-independent Japanese Pokémon source catalogue") and explicitly scopes it to cards with no price-variant match, which distinguishes it from the pricing siblings. The cat_/catv_ identifier note further pins down what the tool returns.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Gives a clear routing rule away from pricing: use pricing.price_variants[].id (tcg_) for prices and "never guess a bridge." It lacks an explicit statement of when to prefer search_cards or get_catalogue_card, but the price-independent scope implies the boundary.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources