Skip to main content
Glama

tcgdata.dev — European TCG Prices

Get a Japanese source card

get_catalogue_card
Read-only

Read one Japanese source card, variants, provenance and explicit pricing references. Only use returned tcg_ price-variant IDs for price tools. One admitted API call consumes one shared account request, including admitted errors. No automatic retries.

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "catalogue_card_id": "<catalogue_card_id>"
    },
    "name": "get_catalogue_card"
  }
}

Input Schema

NameRequiredDescriptionDefault
viewNofull
catalogue_card_idYesPrice-independent Japanese catalogue card ID returned by search_catalogue_cards.

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": {
      -        "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"
      -      }
      -    },
      -    "required": [
      -      "data"
      -    ],
      -    "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": {
      +        "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"
      +      }
      +    },
      +    "required": [
      +      "data"
      +    ],
      +    "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

A3.7/5.0
Behavior4/5

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

Annotations already declare readOnlyHint/openWorldHint/destructiveHint=false, but the description adds cost behavior the annotations cannot express: one admitted API call consumes one shared account request, admitted errors count, and there are no automatic retries. That is genuinely decision-relevant operational context, though it does not say what happens on a rejected/malformed ID.

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?

Four short sentences, front-loaded with the core action, then the ID-provenance rule, then the cost/retry caveat. No filler, though the budget sentence could be tightened slightly.

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?

An output schema exists so return values need no prose, and annotations cover safety; the description fills the remaining gap with request-budget and no-retry semantics. The only missing piece is guidance on the view parameter, which leaves an agent guessing between compact and full.

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%: catalogue_card_id is fully documented in the schema (pattern and provenance), but the view parameter's compact/full tradeoff is explained nowhere in the description. The description adds no parameter-level meaning beyond the schema, so the baseline 3 applies.

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

Purpose4/5

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

Specific verb plus resource: "Read one Japanese source card" and enumerates what comes back (variants, provenance, explicit pricing references). This differentiates it from the generic get_card sibling by the Japanese-source qualifier, though it never names that sibling explicitly.

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

Usage Guidelines3/5

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

Gives a downstream rule ("Only use returned tcg_ price-variant IDs for price tools") that implies this tool is the prerequisite for the price tools, but there is no explicit statement of when to choose this over get_card or search_catalogue_cards, and no stated exclusions.

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