Skip to main content
Glama

Get listing history

getProductListingHistory
Read-onlyIdempotent

Get the complete history of one listing by its productListingId: when it was first seen and every recorded change, in event order. Use it for questions about price development or past changes. With currency, each price is also converted at the exchange rate of its event. Returns every event in one result; a history too large for one response fails instead of being truncated. Amounts are always integers in the currency's minor unit when one exists (EUR 119199 = €1,191.99; USD in cents). For currencies without minor units, such as JPY, the amount is whole units (211453 = ¥211,453). Follow ISO 4217 exponents.

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": {
      "productListingId": "<productListingId>"
    },
    "name": "getProductListingHistory"
  }
}

Input Schema

NameRequiredDescriptionDefault
currencyNoCurrency to also show each price in, converted at the exchange rate of its event, as an ISO 4217 code; without it only the source prices are returned.
productListingIdYesID of the listing (`pl_…`).

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • removedOutput schema / $defs / ProductListingDiscoveryHistoryData / properties / description
      Removed value: -{
      -  "anyOf": [
      -    {
      -      "$ref": "#/$defs/LocalizedTextData"
      -    },
      -    {
      -      "type": "null"
      -    }
      -  ]
      -}
    • changedOutput schema / $defs / ProductListingHistoryChangeData / oneOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/LocalizedTextData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/LocalizedTextData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "TITLE_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/LocalizedTextData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/LocalizedTextData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "DESCRIPTION_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "type": {
      -        "const": "DELIVERY_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "MAIN_PRICE_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "MINIMUM_ESTIMATE_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "MAXIMUM_ESTIMATE_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "AVAILABLE",
      -              "IN_STOCK",
      -              "LIMITED_AVAILABILITY",
      -              "BACK_ORDER",
      -              "MADE_TO_ORDER",
      -              "PRE_ORDER",
      -              "PRE_SALE",
      -              "UNAVAILABLE",
      -              "RESERVED",
      -              "OUT_OF_STOCK",
      -              "SOLD_OUT"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "AVAILABLE",
      -              "IN_STOCK",
      -              "LIMITED_AVAILABILITY",
      -              "BACK_ORDER",
      -              "MADE_TO_ORDER",
      -              "PRE_ORDER",
      -              "PRE_SALE",
      -              "UNAVAILABLE",
      -              "RESERVED",
      -              "OUT_OF_STOCK",
      -              "SOLD_OUT"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "AVAILABILITY_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "format": "uri",
      -        "type": "string"
      -      },
      -      "previous": {
      -        "format": "uri",
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "URL_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previous",
      -      "current"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "currentCount": {
      -        "format": "uint64",
      -        "maximum": 18446744073709552000,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "previousCount": {
      -        "format": "uint64",
      -        "maximum": 18446744073709552000,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "type": {
      -        "const": "IMAGES_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previousCount",
      -      "currentCount"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingAuctionData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingAuctionData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "AUCTION_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "previousAvailability": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "AVAILABLE",
      -              "IN_STOCK",
      -              "LIMITED_AVAILABILITY",
      -              "BACK_ORDER",
      -              "MADE_TO_ORDER",
      -              "PRE_ORDER",
      -              "PRE_SALE",
      -              "UNAVAILABLE",
      -              "RESERVED",
      -              "OUT_OF_STOCK",
      -              "SOLD_OUT"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "WITHDRAWN",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "type": {
      -        "const": "RESTORED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "observation": {
      -        "$ref": "#/$defs/ListingSaleObservationHistoryData"
      -      },
      -      "type": {
      -        "const": "SALE_OBSERVED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "observation"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "observation": {
      -        "$ref": "#/$defs/ListingSaleObservationHistoryData"
      -      },
      -      "type": {
      -        "const": "SALE_OBSERVATION_RETRACTED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "observation"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/LocalizedTextData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/LocalizedTextData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "TITLE_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "type": {
      +        "const": "DESCRIPTION_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "type": {
      +        "const": "DELIVERY_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "MAIN_PRICE_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "MINIMUM_ESTIMATE_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "MAXIMUM_ESTIMATE_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "AVAILABLE",
      +              "IN_STOCK",
      +              "LIMITED_AVAILABILITY",
      +              "BACK_ORDER",
      +              "MADE_TO_ORDER",
      +              "PRE_ORDER",
      +              "PRE_SALE",
      +              "UNAVAILABLE",
      +              "RESERVED",
      +              "OUT_OF_STOCK",
      +              "SOLD_OUT"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "AVAILABLE",
      +              "IN_STOCK",
      +              "LIMITED_AVAILABILITY",
      +              "BACK_ORDER",
      +              "MADE_TO_ORDER",
      +              "PRE_ORDER",
      +              "PRE_SALE",
      +              "UNAVAILABLE",
      +              "RESERVED",
      +              "OUT_OF_STOCK",
      +              "SOLD_OUT"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "AVAILABILITY_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "previous": {
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "URL_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "previous",
      +      "current"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "currentCount": {
      +        "format": "uint64",
      +        "maximum": 18446744073709552000,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "previousCount": {
      +        "format": "uint64",
      +        "maximum": 18446744073709552000,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "type": {
      +        "const": "IMAGES_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "previousCount",
      +      "currentCount"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingAuctionData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingAuctionData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "AUCTION_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "previousAvailability": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "AVAILABLE",
      +              "IN_STOCK",
      +              "LIMITED_AVAILABILITY",
      +              "BACK_ORDER",
      +              "MADE_TO_ORDER",
      +              "PRE_ORDER",
      +              "PRE_SALE",
      +              "UNAVAILABLE",
      +              "RESERVED",
      +              "OUT_OF_STOCK",
      +              "SOLD_OUT"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "WITHDRAWN",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "type": {
      +        "const": "RESTORED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "observation": {
      +        "$ref": "#/$defs/ListingSaleObservationHistoryData"
      +      },
      +      "type": {
      +        "const": "SALE_OBSERVED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "observation"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "observation": {
      +        "$ref": "#/$defs/ListingSaleObservationHistoryData"
      +      },
      +      "type": {
      +        "const": "SALE_OBSERVATION_RETRACTED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "observation"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed2 schema fields changed
    • addedInput schema / properties / currency / description
      Added value: +"Currency to also show each price in, converted at the exchange rate of its event, as an ISO 4217 code; without it only the source prices are returned."
    • addedInput schema / properties / productListingId / description
      Added value: +"ID of the listing (`pl_…`)."
  3. Changed1 schema field changed
    • changedOutput schema / $defs / LocalizedTextData / properties / language / enum
      Previous value: -[
      -  "de",
      -  "en",
      -  "fr",
      -  "es",
      -  "it",
      -  "zh",
      -  "pt",
      -  "pl",
      -  "tr",
      -  "nl",
      -  "cs",
      -  "ja",
      -  "ru",
      -  "ar"
      -]New value: +[
      +  "de",
      +  "en",
      +  "fr",
      +  "es",
      +  "it",
      +  "zh",
      +  "pt",
      +  "pl",
      +  "tr",
      +  "nl",
      +  "cs",
      +  "ja",
      +  "ru",
      +  "ar",
      +  "ko",
      +  "el",
      +  "he",
      +  "th",
      +  "hi"
      +]
  4. Changed4 schema fields changed
    • removedOutput schema / $defs / ProductListingAuctionData / required
      Removed value: -[
      -  "lotNumber",
      -  "cataloguePosition",
      -  "biddingOpens",
      -  "scheduledCloses",
      -  "reportedClosedAt"
      -]
    • changedOutput schema / $defs / ProductListingDiscoveryHistoryData / required
      Previous value: -[
      -  "listingSourceId",
      -  "sourceListingId",
      -  "pricing",
      -  "availability",
      -  "url",
      -  "imageCount",
      -  "auction"
      -]New value: +[
      +  "listingSourceId",
      +  "sourceListingId",
      +  "pricing",
      +  "url",
      +  "imageCount"
      +]
    • changedOutput schema / $defs / ProductListingHistoryChangeData / oneOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/LocalizedTextData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/LocalizedTextData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "TITLE_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previous",
      -      "current"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/LocalizedTextData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/LocalizedTextData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "DESCRIPTION_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previous",
      -      "current"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "type": {
      -        "const": "DELIVERY_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "MAIN_PRICE_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previous",
      -      "current"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "MINIMUM_ESTIMATE_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previous",
      -      "current"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "MAXIMUM_ESTIMATE_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previous",
      -      "current"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "AVAILABLE",
      -              "IN_STOCK",
      -              "LIMITED_AVAILABILITY",
      -              "BACK_ORDER",
      -              "MADE_TO_ORDER",
      -              "PRE_ORDER",
      -              "PRE_SALE",
      -              "UNAVAILABLE",
      -              "RESERVED",
      -              "OUT_OF_STOCK",
      -              "SOLD_OUT"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "AVAILABLE",
      -              "IN_STOCK",
      -              "LIMITED_AVAILABILITY",
      -              "BACK_ORDER",
      -              "MADE_TO_ORDER",
      -              "PRE_ORDER",
      -              "PRE_SALE",
      -              "UNAVAILABLE",
      -              "RESERVED",
      -              "OUT_OF_STOCK",
      -              "SOLD_OUT"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "AVAILABILITY_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previous",
      -      "current"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "format": "uri",
      -        "type": "string"
      -      },
      -      "previous": {
      -        "format": "uri",
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "URL_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previous",
      -      "current"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "currentCount": {
      -        "format": "uint64",
      -        "maximum": 18446744073709552000,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "previousCount": {
      -        "format": "uint64",
      -        "maximum": 18446744073709552000,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "type": {
      -        "const": "IMAGES_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previousCount",
      -      "currentCount"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingAuctionData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingAuctionData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "AUCTION_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previous",
      -      "current"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "previousAvailability": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "AVAILABLE",
      -              "IN_STOCK",
      -              "LIMITED_AVAILABILITY",
      -              "BACK_ORDER",
      -              "MADE_TO_ORDER",
      -              "PRE_ORDER",
      -              "PRE_SALE",
      -              "UNAVAILABLE",
      -              "RESERVED",
      -              "OUT_OF_STOCK",
      -              "SOLD_OUT"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "WITHDRAWN",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previousAvailability"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "type": {
      -        "const": "RESTORED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "observation": {
      -        "$ref": "#/$defs/ListingSaleObservationHistoryData"
      -      },
      -      "type": {
      -        "const": "SALE_OBSERVED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "observation"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "observation": {
      -        "$ref": "#/$defs/ListingSaleObservationHistoryData"
      -      },
      -      "type": {
      -        "const": "SALE_OBSERVATION_RETRACTED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "observation"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/LocalizedTextData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/LocalizedTextData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "TITLE_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/LocalizedTextData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/LocalizedTextData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "DESCRIPTION_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "type": {
      +        "const": "DELIVERY_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "MAIN_PRICE_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "MINIMUM_ESTIMATE_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "MAXIMUM_ESTIMATE_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "AVAILABLE",
      +              "IN_STOCK",
      +              "LIMITED_AVAILABILITY",
      +              "BACK_ORDER",
      +              "MADE_TO_ORDER",
      +              "PRE_ORDER",
      +              "PRE_SALE",
      +              "UNAVAILABLE",
      +              "RESERVED",
      +              "OUT_OF_STOCK",
      +              "SOLD_OUT"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "AVAILABLE",
      +              "IN_STOCK",
      +              "LIMITED_AVAILABILITY",
      +              "BACK_ORDER",
      +              "MADE_TO_ORDER",
      +              "PRE_ORDER",
      +              "PRE_SALE",
      +              "UNAVAILABLE",
      +              "RESERVED",
      +              "OUT_OF_STOCK",
      +              "SOLD_OUT"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "AVAILABILITY_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "previous": {
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "URL_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "previous",
      +      "current"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "currentCount": {
      +        "format": "uint64",
      +        "maximum": 18446744073709552000,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "previousCount": {
      +        "format": "uint64",
      +        "maximum": 18446744073709552000,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "type": {
      +        "const": "IMAGES_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "previousCount",
      +      "currentCount"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingAuctionData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingAuctionData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "AUCTION_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "previousAvailability": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "AVAILABLE",
      +              "IN_STOCK",
      +              "LIMITED_AVAILABILITY",
      +              "BACK_ORDER",
      +              "MADE_TO_ORDER",
      +              "PRE_ORDER",
      +              "PRE_SALE",
      +              "UNAVAILABLE",
      +              "RESERVED",
      +              "OUT_OF_STOCK",
      +              "SOLD_OUT"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "WITHDRAWN",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "type": {
      +        "const": "RESTORED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "observation": {
      +        "$ref": "#/$defs/ListingSaleObservationHistoryData"
      +      },
      +      "type": {
      +        "const": "SALE_OBSERVED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "observation"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "observation": {
      +        "$ref": "#/$defs/ListingSaleObservationHistoryData"
      +      },
      +      "type": {
      +        "const": "SALE_OBSERVATION_RETRACTED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "observation"
      +    ],
      +    "type": "object"
      +  }
      +]
    • changedOutput schema / description
      Previous value: -"Object envelope required by legacy MCP output schemas for arrays, null and scalars.\nThe inner value is the shared API response type without remapping or field dropping."New value: +"Object envelope required by legacy MCP output schemas for arrays and scalars.\nThe inner value is the shared API response type without remapping or field dropping."
  5. Changed1 schema field changed
    • changedOutput schema / $defs / ProductListingHistoryChangeData / oneOf
      Previous value: -[
      -  {
      -    "properties": {
      -      "type": {
      -        "const": "DELIVERY_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "MAIN_PRICE_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previous",
      -      "current"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "MINIMUM_ESTIMATE_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previous",
      -      "current"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "MAXIMUM_ESTIMATE_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previous",
      -      "current"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "AVAILABLE",
      -              "IN_STOCK",
      -              "LIMITED_AVAILABILITY",
      -              "BACK_ORDER",
      -              "MADE_TO_ORDER",
      -              "PRE_ORDER",
      -              "PRE_SALE",
      -              "UNAVAILABLE",
      -              "RESERVED",
      -              "OUT_OF_STOCK",
      -              "SOLD_OUT"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "AVAILABLE",
      -              "IN_STOCK",
      -              "LIMITED_AVAILABILITY",
      -              "BACK_ORDER",
      -              "MADE_TO_ORDER",
      -              "PRE_ORDER",
      -              "PRE_SALE",
      -              "UNAVAILABLE",
      -              "RESERVED",
      -              "OUT_OF_STOCK",
      -              "SOLD_OUT"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "AVAILABILITY_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previous",
      -      "current"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "format": "uri",
      -        "type": "string"
      -      },
      -      "previous": {
      -        "format": "uri",
      -        "type": "string"
      -      },
      -      "type": {
      -        "const": "URL_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previous",
      -      "current"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "currentCount": {
      -        "format": "uint64",
      -        "maximum": 18446744073709552000,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "previousCount": {
      -        "format": "uint64",
      -        "maximum": 18446744073709552000,
      -        "minimum": 0,
      -        "type": "integer"
      -      },
      -      "type": {
      -        "const": "IMAGES_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previousCount",
      -      "currentCount"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "current": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingAuctionData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "previous": {
      -        "anyOf": [
      -          {
      -            "$ref": "#/$defs/ProductListingAuctionData"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "AUCTION_CHANGED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previous",
      -      "current"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "previousAvailability": {
      -        "anyOf": [
      -          {
      -            "enum": [
      -              "AVAILABLE",
      -              "IN_STOCK",
      -              "LIMITED_AVAILABILITY",
      -              "BACK_ORDER",
      -              "MADE_TO_ORDER",
      -              "PRE_ORDER",
      -              "PRE_SALE",
      -              "UNAVAILABLE",
      -              "RESERVED",
      -              "OUT_OF_STOCK",
      -              "SOLD_OUT"
      -            ],
      -            "type": "string"
      -          },
      -          {
      -            "type": "null"
      -          }
      -        ]
      -      },
      -      "type": {
      -        "const": "WITHDRAWN",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "previousAvailability"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "type": {
      -        "const": "RESTORED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "observation": {
      -        "$ref": "#/$defs/ListingSaleObservationHistoryData"
      -      },
      -      "type": {
      -        "const": "SALE_OBSERVED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "observation"
      -    ],
      -    "type": "object"
      -  },
      -  {
      -    "properties": {
      -      "observation": {
      -        "$ref": "#/$defs/ListingSaleObservationHistoryData"
      -      },
      -      "type": {
      -        "const": "SALE_OBSERVATION_RETRACTED",
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "type",
      -      "observation"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/LocalizedTextData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/LocalizedTextData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "TITLE_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "previous",
      +      "current"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/LocalizedTextData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/LocalizedTextData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "DESCRIPTION_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "previous",
      +      "current"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "type": {
      +        "const": "DELIVERY_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "MAIN_PRICE_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "previous",
      +      "current"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "MINIMUM_ESTIMATE_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "previous",
      +      "current"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingHistoryPriceData2"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "MAXIMUM_ESTIMATE_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "previous",
      +      "current"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "AVAILABLE",
      +              "IN_STOCK",
      +              "LIMITED_AVAILABILITY",
      +              "BACK_ORDER",
      +              "MADE_TO_ORDER",
      +              "PRE_ORDER",
      +              "PRE_SALE",
      +              "UNAVAILABLE",
      +              "RESERVED",
      +              "OUT_OF_STOCK",
      +              "SOLD_OUT"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "AVAILABLE",
      +              "IN_STOCK",
      +              "LIMITED_AVAILABILITY",
      +              "BACK_ORDER",
      +              "MADE_TO_ORDER",
      +              "PRE_ORDER",
      +              "PRE_SALE",
      +              "UNAVAILABLE",
      +              "RESERVED",
      +              "OUT_OF_STOCK",
      +              "SOLD_OUT"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "AVAILABILITY_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "previous",
      +      "current"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "previous": {
      +        "format": "uri",
      +        "type": "string"
      +      },
      +      "type": {
      +        "const": "URL_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "previous",
      +      "current"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "currentCount": {
      +        "format": "uint64",
      +        "maximum": 18446744073709552000,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "previousCount": {
      +        "format": "uint64",
      +        "maximum": 18446744073709552000,
      +        "minimum": 0,
      +        "type": "integer"
      +      },
      +      "type": {
      +        "const": "IMAGES_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "previousCount",
      +      "currentCount"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "current": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingAuctionData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "previous": {
      +        "anyOf": [
      +          {
      +            "$ref": "#/$defs/ProductListingAuctionData"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "AUCTION_CHANGED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "previous",
      +      "current"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "previousAvailability": {
      +        "anyOf": [
      +          {
      +            "enum": [
      +              "AVAILABLE",
      +              "IN_STOCK",
      +              "LIMITED_AVAILABILITY",
      +              "BACK_ORDER",
      +              "MADE_TO_ORDER",
      +              "PRE_ORDER",
      +              "PRE_SALE",
      +              "UNAVAILABLE",
      +              "RESERVED",
      +              "OUT_OF_STOCK",
      +              "SOLD_OUT"
      +            ],
      +            "type": "string"
      +          },
      +          {
      +            "type": "null"
      +          }
      +        ]
      +      },
      +      "type": {
      +        "const": "WITHDRAWN",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "previousAvailability"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "type": {
      +        "const": "RESTORED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "observation": {
      +        "$ref": "#/$defs/ListingSaleObservationHistoryData"
      +      },
      +      "type": {
      +        "const": "SALE_OBSERVED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "observation"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "observation": {
      +        "$ref": "#/$defs/ListingSaleObservationHistoryData"
      +      },
      +      "type": {
      +        "const": "SALE_OBSERVATION_RETRACTED",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "type",
      +      "observation"
      +    ],
      +    "type": "object"
      +  }
      +]
  6. First observed

TDQS

A4.6/5.0
Behavior5/5

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

Goes well beyond the readOnly/idempotent annotations: it discloses that the entire history is returned in one result and that an oversized history fails rather than being silently truncated — a critical behavioral fact. It also explains per-event exchange-rate conversion and the minor-unit integer encoding with concrete examples.

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

Conciseness4/5

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

Front-loaded with purpose and usage before the formatting detail, and each sentence carries information. The minor-unit/ISO 4217 explanation with three examples is somewhat verbose for a fairly mechanical convention, though it is genuinely load-bearing for interpreting output.

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

Completeness5/5

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

Covers ordering, completeness/failure semantics, currency conversion, and amount encoding for a simple two-parameter read tool; with an output schema present, no further explanation of the return shape is required. Nothing an agent needs to invoke or interpret it is missing.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, and the description earns an upgrade by explaining the consequence of the currency argument (each price additionally converted at its event's rate, otherwise only source prices) and by clarifying how returned amounts map to ISO 4217 exponents.

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

Purpose5/5

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

Names a specific verb and resource ('complete history of one listing by its productListingId') and enumerates exactly what it returns: first-seen timestamp plus every recorded change in event order. That scope makes it plainly distinguishable from a current-state listing getter such as getProductListing.

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

Usage Guidelines4/5

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

'Use it for questions about price development or past changes' gives a clear usage context that steers the agent away from current-state lookups. It does not explicitly name a sibling alternative or state when not to use it, so it falls short of a full when/when-not treatment.

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