KH Merch Graph MCP

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "title"
  ],
  "properties": {
    "src": {
      "type": "string",
      "description": "Traffic-source tag for usage statistics, used by the website (optional; only the tag and time are logged). Agents can omit it."
    },
    "url": {
      "type": "string",
      "description": "Listing URL. Optional; not stored and not fetched."
    },
    "title": {
      "type": "string",
      "description": "The listing title, copied as-is (required)."
    },
    "platform": {
      "enum": [
        "mercari",
        "yahoo",
        "surugaya",
        "mandarake",
        "other"
      ],
      "type": "string",
      "description": "Where it is listed. Optional."
    },
    "price_jpy": {
      "type": "number",
      "description": "Listing price in Japanese yen. Optional; enables the comparison with the original price."
    },
    "description": {
      "type": "string",
      "description": "Part of the listing description, e.g. condition notes such as 開封済み. Optional; improves condition and bootleg checks."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "listings"
  ],
  "properties": {
    "listings": {
      "type": "array",
      "items": {
        "type": "object",
        "required": [
          "title"
        ],
        "properties": {
          "src": {
            "type": "string",
            "description": "Traffic-source tag for usage statistics (optional; only the tag and time are logged)."
          },
          "url": {
            "type": "string",
            "description": "Listing URL. Optional; not stored and not fetched."
          },
          "title": {
            "type": "string",
            "description": "The listing title, copied as-is (required)."
          },
          "platform": {
            "enum": [
              "mercari",
              "yahoo",
              "surugaya",
              "mandarake",
              "other"
            ],
            "type": "string",
            "description": "Where it is listed. Optional."
          },
          "price_jpy": {
            "type": "number",
            "description": "Listing price in Japanese yen. Optional."
          },
          "description": {
            "type": "string",
            "description": "Part of the listing description. Optional."
          }
        },
        "additionalProperties": false
      },
      "description": "Listings to check (1–5); each takes the same arguments as resolve_listing."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "properties": {
    "query": {
      "type": "string",
      "description": "Free-text product name in English or Japanese when you have no sku_id, e.g. \"一番くじ キングダムハーツ A賞\"."
    },
    "sku_id": {
      "type": "string",
      "description": "Catalog SKU ID, e.g. \"ichiban-kuji-kh-2018-a\". Either sku_id or query is required."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "ip"
  ],
  "properties": {
    "ip": {
      "type": "string",
      "description": "Franchise ID. Currently only \"kingdom-hearts\"."
    },
    "limit": {
      "type": "number",
      "description": "Maximum number of items to return (default 10). total_matches always gives the full count."
    },
    "terms": {
      "type": "object",
      "properties": {
        "names": {
          "type": "array",
          "items": {
            "type": "string"
          },
          "description": "Only items mentioning these series terms, in English or Japanese, e.g. [\"Heartless\"], [\"XIII機関\"], [\"Kingdom Key\"]."
        },
        "types": {
          "type": "array",
          "items": {
            "enum": [
              "character",
              "faction",
              "world",
              "item",
              "keyblade",
              "song",
              "event",
              "other"
            ],
            "type": "string"
          },
          "description": "Only items mentioning a series term of these kinds (character/faction/world/item/keyblade/song/event/other)."
        }
      },
      "description": "Filter by series vocabulary (factions, worlds, keyblades, songs…) found in item names, aliases or notes. Optional.",
      "additionalProperties": false
    },
    "purpose": {
      "enum": [
        "display",
        "wear",
        "read",
        "play",
        "any"
      ],
      "type": "string",
      "description": "\"display\" = figures, plush, prizes, acrylic stands; \"wear\" = apparel; \"read\" = books; \"play\" = games and cards; \"any\" (default)."
    },
    "character": {
      "type": "string",
      "description": "Character name in English or Japanese, e.g. \"Sora\", \"ソラ\", \"Organization XIII\". Partial match. Optional."
    },
    "budget_jpy": {
      "type": "number",
      "description": "Maximum original price in Japanese yen (overseas items are compared at a fixed rate), e.g. 5000. Optional."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "price_jpy",
    "dest_country"
  ],
  "properties": {
    "proxy": {
      "type": "string",
      "description": "Only show one forwarding service, e.g. \"buyee\". Optional."
    },
    "sku_id": {
      "type": "string",
      "description": "Catalog sku_id, used to look up the weight. Optional."
    },
    "weight_g": {
      "type": "number",
      "description": "Package weight in grams, when there is no sku_id or the catalog has no weight."
    },
    "price_jpy": {
      "type": "number",
      "description": "Item price in Japanese yen (required)."
    },
    "dest_country": {
      "type": "string",
      "description": "Destination country as an ISO 3166-1 alpha-2 code, e.g. \"US\", \"GB\", \"AU\"."
    }
  },
  "additionalProperties": false
}

{
  "type": "object",
  "$schema": "http://json-schema.org/draft-07/schema#",
  "required": [
    "field",
    "proposed_value"
  ],
  "properties": {
    "note": {
      "type": "string",
      "description": "Anything else worth knowing. Optional."
    },
    "field": {
      "type": "string",
      "description": "What is wrong, as a catalog field name, e.g. \"name_en\", \"msrp_jpy\", \"availability_hint\", \"official\", or \"new_item\"."
    },
    "sku_id": {
      "type": "string",
      "description": "The item's sku_id. Leave empty to suggest a new item."
    },
    "source_url": {
      "type": "string",
      "description": "URL of a primary source that confirms it. Optional but strongly preferred."
    },
    "proposed_value": {
      "type": "string",
      "description": "The correct value (or, for a new item, its name and details)."
    }
  },
  "additionalProperties": false
}