Try it
Call this server's tools from your browser. Nothing to install.
https://mcp.aura-historia.com/v1
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
addWatchlistProduct
Add a listing to the signed-in user's watchlist by productListingId so they can follow it and, with notifications on (the default), hear about changes. A listing already on the watchlist returns CONFLICT; subscription tier limits apply.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Install
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http mcp https://mcp.aura-historia.com/v1
Tools (38)
addWatchlistProductAdd a listing to the signed-in user's watchlist by productListingId so they can follow it and, with notifications on (the default), hear about changes. A listing already on the watchlist returns CONFLICT; subscription tier limits apply.
addWatchlistProduct
Add a listing to the signed-in user's watchlist by productListingId so they can follow it and, with notifications on (the default), hear about changes. A listing already on the watchlist returns CONFLICT; subscription tier limits apply.
| Argument | Type | Description |
|---|---|---|
| notifications | boolean | null | |
| productListingId* | string |
Input schema (JSON)
{
"type": "object",
"title": "AddInput",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"productListingId"
],
"properties": {
"notifications": {
"type": [
"boolean",
"null"
]
},
"productListingId": {
"type": "string",
"pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"additionalProperties": false
}createUserAddressSave a new private address with a label and its location in the signed-in user's address book; Aura Historia resolves the location for shipping estimates. Each call creates a new address, so repeating a call that timed out can create a duplicate.
createUserAddress
Save a new private address with a label and its location in the signed-in user's address book; Aura Historia resolves the location for shipping estimates. Each call creates a new address, so repeating a call that timed out can create a duplicate.
| Argument | Type | Description |
|---|---|---|
| label* | string | |
| geography* | any |
Input schema (JSON)
{
"type": "object",
"$defs": {
"GeographyData": {
"type": "object",
"required": [
"referenceRelease"
],
"properties": {
"country": {
"type": [
"string",
"null"
]
},
"postalCode": {
"type": [
"string",
"null"
]
},
"addressText": {
"type": [
"string",
"null"
]
},
"subdivision": {
"type": [
"string",
"null"
]
},
"referenceRelease": {
"type": "string"
}
},
"additionalProperties": false
}
},
"title": "CreateData",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"label",
"geography"
],
"properties": {
"label": {
"type": "string"
},
"geography": {
"allOf": [
{
"$ref": "#/$defs/GeographyData"
},
{
"type": "object",
"required": [
"addressText"
],
"properties": {
"addressText": {
"type": "string",
"maxLength": 4096,
"minLength": 1
}
}
}
]
}
},
"additionalProperties": false
}createUserSearchFilterSave a listing search for the signed-in user. Aura Historia matches new listings against it in the background and, with notifications on (the default), notifies the user, so matches appear later. Subscription tier limits apply. Each call creates a new saved search, so repeating a call that timed out can create a duplicate.
createUserSearchFilter
Save a listing search for the signed-in user. Aura Historia matches new listings against it in the background and, with notifications on (the default), notifies the user, so matches appear later. Subscription tier limits apply. Each call creates a new saved search, so repeating a call that timed out can create a duplicate.
| Argument | Type | Description |
|---|---|---|
| name* | string | |
| search* | any | |
| notifications | boolean | |
| acceptShippingDestination | any |
Input schema (JSON)
{
"type": "object",
"$defs": {
"AmountData": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "integer",
"format": "uint64",
"maximum": 9223372036854776000,
"minimum": 0
},
"currency": {
"enum": [
"EUR",
"GBP",
"USD",
"AUD",
"CAD",
"NZD",
"CNY",
"BRL",
"PLN",
"TRY",
"JPY",
"CZK",
"RUB",
"AED",
"SAR",
"HKD",
"SGD",
"CHF",
"ZAR",
"SEK",
"DKK",
"NOK",
"KRW",
"INR",
"TWD",
"HUF",
"RON",
"MXN",
"THB",
"ARS"
],
"type": "string"
}
},
"additionalProperties": false
},
"OriginData": {
"type": "object",
"required": [
"latitude",
"longitude"
],
"properties": {
"latitude": {
"type": "number",
"format": "double"
},
"longitude": {
"type": "number",
"format": "double"
}
},
"additionalProperties": false
},
"DateRangeSchema": {
"type": "object",
"properties": {
"max": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"default": null
},
"min": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"default": null
}
}
},
"DestinationData": {
"oneOf": [
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "NONE"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"country"
],
"properties": {
"kind": {
"type": "string",
"const": "COUNTRY"
},
"country": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"NumberRangeSchema": {
"type": "object",
"properties": {
"max": {
"type": [
"integer",
"null"
],
"format": "uint64",
"maximum": 18446744073709552000,
"minimum": 0
},
"min": {
"type": [
"integer",
"null"
],
"format": "uint64",
"maximum": 18446744073709552000,
"minimum": 0
}
}
},
"ShippingSearchData": {
"type": "object",
"properties": {
"service": {
"type": [
"string",
"null"
]
},
"destination": {
"anyOf": [
{
"$ref": "#/$defs/DestinationData"
},
{
"type": "null"
}
]
},
"interpretation": {
"type": [
"string",
"null"
]
},
"maximumPerItem": {
"anyOf": [
{
"$ref": "#/$defs/AmountData"
},
{
"type": "null"
}
]
},
"referenceRelease": {
"type": [
"string",
"null"
]
},
"collectionOffered": {
"type": "boolean"
}
},
"additionalProperties": false
},
"GeographicSearchData": {
"type": "object",
"properties": {
"mode": {
"type": [
"string",
"null"
]
},
"origin": {
"anyOf": [
{
"$ref": "#/$defs/OriginData"
},
{
"type": "null"
}
]
},
"radius": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"unit"
],
"properties": {
"unit": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"countries": {
"type": "array",
"items": {
"type": "string"
}
},
"subdivisions": {
"type": "array",
"items": {
"type": "string"
}
},
"distanceOrder": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"ProductListingSearchData": {
"type": "object",
"properties": {
"price": {
"anyOf": [
{
"$ref": "#/$defs/NumberRangeSchema"
},
{
"type": "null"
}
]
},
"created": {
"$ref": "#/$defs/DateRangeSchema"
},
"updated": {
"$ref": "#/$defs/DateRangeSchema"
},
"currency": {
"enum": [
"EUR",
"GBP",
"USD",
"AUD",
"CAD",
"NZD",
"CNY",
"BRL",
"PLN",
"TRY",
"JPY",
"CZK",
"RUB",
"AED",
"SAR",
"HKD",
"SGD",
"CHF",
"ZAR",
"SEK",
"DKK",
"NOK",
"KRW",
"INR",
"TWD",
"HUF",
"RON",
"MXN",
"THB",
"ARS"
],
"type": "string",
"default": "EUR"
},
"language": {
"enum": [
"de",
"en",
"fr",
"es",
"it",
"zh",
"pt",
"pl",
"tr",
"nl",
"cs",
"ja",
"ru",
"ar",
"de-DE",
"de-AT",
"de-CH",
"de-LU",
"de-LI",
"en-US",
"en-GB",
"en-AU",
"en-CA",
"en-NZ",
"en_IE",
"fr-FR",
"fr-CA",
"fr-BE",
"fr-CH",
"fr-LU",
"es-ES",
"es-MX",
"es-AR",
"es-CO",
"es-CL",
"es-PE",
"es-VE",
"it-IT",
"it-CH",
"zh-CN",
"zh-Hans",
"pt-PT",
"pt-BR",
"pl-PL",
"tr-TR",
"nl-NL",
"nl-BE",
"cs-CZ",
"ja-JP",
"ru-RU",
"ar-SA",
"ar-EG",
"ar-AE"
],
"type": "string",
"default": "en"
},
"shipping": {
"anyOf": [
{
"$ref": "#/$defs/ShippingSearchData"
},
{
"type": "null"
}
]
},
"auctionId": {
"type": "array",
"items": {
"type": "string",
"pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"geography": {
"anyOf": [
{
"$ref": "#/$defs/GeographicSearchData"
},
{
"type": "null"
}
]
},
"availability": {
"anyOf": [
{
"type": "array",
"items": {
"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"
}
]
},
"orderability": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"ORDERABLE_NOW",
"ORDERABLE_CONDITIONALLY",
"NOT_ORDERABLE"
],
"type": "string"
}
},
{
"type": "null"
}
]
},
"productQuery": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"listingSourceId": {
"type": "array",
"items": {
"type": "string",
"pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"lotBiddingOpens": {
"$ref": "#/$defs/DateRangeSchema"
},
"lotScheduledCloses": {
"$ref": "#/$defs/DateRangeSchema"
},
"excludeListingSourceId": {
"type": "array",
"items": {
"type": "string",
"pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"excludeProductListingId": {
"type": "array",
"items": {
"type": "string",
"pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"enhancedSearchDescription": {
"type": [
"string",
"null"
]
},
"includeUnspecifiedAvailability": {
"type": [
"boolean",
"null"
]
}
}
},
"AcceptShippingDestinationData": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"addressId"
],
"properties": {
"kind": {
"type": "string",
"const": "ADDRESS"
},
"addressId": {
"type": "string",
"pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "PREFERENCE"
}
},
"additionalProperties": false
}
],
"description": "Optional acceptance guard. The submitted country must equal the authorized address or\npreference's asserted country. Neither the reference nor provider evidence is retained."
}
},
"title": "CreateArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"search"
],
"properties": {
"name": {
"type": "string"
},
"search": {
"$ref": "#/$defs/ProductListingSearchData"
},
"notifications": {
"type": "boolean",
"default": true
},
"acceptShippingDestination": {
"anyOf": [
{
"$ref": "#/$defs/AcceptShippingDestinationData"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}deleteNotificationPermanently delete one of the signed-in user's notifications by notificationId. Returns an empty object; an unknown ID returns NOT_FOUND.
destructive
deleteNotification
Permanently delete one of the signed-in user's notifications by notificationId. Returns an empty object; an unknown ID returns NOT_FOUND.
| Argument | Type | Description |
|---|---|---|
| notificationId* | string |
Input schema (JSON)
{
"type": "object",
"title": "NotificationArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"notificationId"
],
"properties": {
"notificationId": {
"type": "string",
"pattern": "^ntf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"additionalProperties": false
}deleteNotificationsPermanently delete every notification of the signed-in user, including those beyond the listed page. Takes no arguments. Returns an empty object.
destructive
deleteNotifications
Permanently delete every notification of the signed-in user, including those beyond the listed page. Takes no arguments. Returns an empty object.
No arguments.
Input schema (JSON)
{
"type": "object",
"title": "EmptyArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}deleteUserAddressPermanently delete one of the signed-in user's saved addresses. expectedVersion must equal its current version. If the address is the browsing destination, that destination is cleared too. Returns an empty object.
destructive
deleteUserAddress
Permanently delete one of the signed-in user's saved addresses. expectedVersion must equal its current version. If the address is the browsing destination, that destination is cleared too. Returns an empty object.
| Argument | Type | Description |
|---|---|---|
| addressId* | string | |
| expectedVersion* | integer |
Input schema (JSON)
{
"type": "object",
"title": "DeleteAddressArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"addressId",
"expectedVersion"
],
"properties": {
"addressId": {
"type": "string",
"pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
},
"expectedVersion": {
"type": "integer",
"format": "uint64",
"maximum": 9223372036854776000,
"minimum": 1
}
},
"additionalProperties": false
}deleteUserSearchFilterPermanently delete one of the signed-in user's saved searches. Returns an empty object; an unknown ID returns NOT_FOUND.
destructive
deleteUserSearchFilter
Permanently delete one of the signed-in user's saved searches. Returns an empty object; an unknown ID returns NOT_FOUND.
| Argument | Type | Description |
|---|---|---|
| userSearchFilterId* | string |
Input schema (JSON)
{
"type": "object",
"title": "FilterArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"userSearchFilterId"
],
"properties": {
"userSearchFilterId": {
"type": "string",
"pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"additionalProperties": false
}deleteWatchlistProductRemove a listing from the signed-in user's watchlist by productListingId. Returns an empty object; a listing that is not on the watchlist returns NOT_FOUND, also after an earlier call removed it.
destructive
deleteWatchlistProduct
Remove a listing from the signed-in user's watchlist by productListingId. Returns an empty object; a listing that is not on the watchlist returns NOT_FOUND, also after an earlier call removed it.
| Argument | Type | Description |
|---|---|---|
| productListingId* | string |
Input schema (JSON)
{
"type": "object",
"title": "RemoveInput",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"productListingId"
],
"properties": {
"productListingId": {
"type": "string",
"pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"additionalProperties": false
}discoverPartyLocationsFind the public locations, such as shops and showrooms, of the dealers and auction houses that Aura Historia indexes, within countries or subdivisions or within a radius around a point. Returns each location's business, label, country, coordinates and precision, and with distanceOrder its distance from the point. Returns 1 to 100 locations per page (default 21); pass the returned searchAfter object unchanged to get the next page.
read-only
discoverPartyLocations
Find the public locations, such as shops and showrooms, of the dealers and auction houses that Aura Historia indexes, within countries or subdivisions or within a radius around a point. Returns each location's business, label, country, coordinates and precision, and with distanceOrder its distance from the point. Returns 1 to 100 locations per page (default 21); pass the returned searchAfter object unchanged to get the next page.
| Argument | Type | Description |
|---|---|---|
| size | integer | Page size from 1 through 100, validated by the discovery use case. |
| geography* | any | |
| searchAfter | any |
Input schema (JSON)
{
"type": "object",
"$defs": {
"OriginData": {
"type": "object",
"required": [
"latitude",
"longitude"
],
"properties": {
"latitude": {
"type": "number",
"format": "double"
},
"longitude": {
"type": "number",
"format": "double"
}
},
"additionalProperties": false
},
"GeographicSearchData": {
"type": "object",
"properties": {
"mode": {
"type": [
"string",
"null"
]
},
"origin": {
"anyOf": [
{
"$ref": "#/$defs/OriginData"
},
{
"type": "null"
}
]
},
"radius": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"unit"
],
"properties": {
"unit": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"countries": {
"type": "array",
"items": {
"type": "string"
}
},
"subdivisions": {
"type": "array",
"items": {
"type": "string"
}
},
"distanceOrder": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"PartyLocationCursorData": {
"type": "object",
"required": [
"locationId"
],
"properties": {
"distanceKm": {
"type": [
"number",
"null"
],
"format": "double"
},
"locationId": {
"type": "string",
"pattern": "^ploc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"additionalProperties": false
}
},
"title": "DiscoverPartyLocationsData",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"geography"
],
"properties": {
"size": {
"type": "integer",
"format": "uint64",
"default": 21,
"maximum": 18446744073709552000,
"minimum": 0,
"description": "Page size from 1 through 100, validated by the discovery use case."
},
"geography": {
"$ref": "#/$defs/GeographicSearchData"
},
"searchAfter": {
"anyOf": [
{
"$ref": "#/$defs/PartyLocationCursorData"
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": false
}getAuctionGet one auction by its auctionId: name, provider, format, schedule, reported status, reported and visible lot counts, and the link to its catalogue at the provider.
read-only
getAuction
Get one auction by its auctionId: name, provider, format, schedule, reported status, reported and visible lot counts, and the link to its catalogue at the provider.
| Argument | Type | Description |
|---|---|---|
| auctionId* | string |
Input schema (JSON)
{
"type": "object",
"title": "AuctionArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"auctionId"
],
"properties": {
"auctionId": {
"type": "string",
"pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"additionalProperties": false
}getAuctionCatalogueList the lots of one auction by its auctionId in catalogue order, as listings in the requested language and currency with shipping details. Pass the returned searchAfter object as a JSON string to get the next page. For a signed-in user, each result also carries userState sections for which the token has the read scope: watchlist:read, search-filters:read, notifications:read or users:read.
read-only
getAuctionCatalogue
List the lots of one auction by its auctionId in catalogue order, as listings in the requested language and currency with shipping details. Pass the returned searchAfter object as a JSON string to get the next page. For a signed-in user, each result also carries userState sections for which the token has the read scope: watchlist:read, search-filters:read, notifications:read or users:read.
| Argument | Type | Description |
|---|---|---|
| currency | string | |
| language | string | |
| pageSize | integer | null | |
| auctionId* | string | |
| searchAfter | string | null |
Input schema (JSON)
{
"type": "object",
"title": "CatalogueArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"auctionId"
],
"properties": {
"currency": {
"enum": [
"EUR",
"GBP",
"USD",
"AUD",
"CAD",
"NZD",
"CNY",
"BRL",
"PLN",
"TRY",
"JPY",
"CZK",
"RUB",
"AED",
"SAR",
"HKD",
"SGD",
"CHF",
"ZAR",
"SEK",
"DKK",
"NOK",
"KRW",
"INR",
"TWD",
"HUF",
"RON",
"MXN",
"THB",
"ARS"
],
"type": "string",
"default": "EUR"
},
"language": {
"enum": [
"de",
"en",
"fr",
"es",
"it",
"zh",
"pt",
"pl",
"tr",
"nl",
"cs",
"ja",
"ru",
"ar",
"de-DE",
"de-AT",
"de-CH",
"de-LU",
"de-LI",
"en-US",
"en-GB",
"en-AU",
"en-CA",
"en-NZ",
"en_IE",
"fr-FR",
"fr-CA",
"fr-BE",
"fr-CH",
"fr-LU",
"es-ES",
"es-MX",
"es-AR",
"es-CO",
"es-CL",
"es-PE",
"es-VE",
"it-IT",
"it-CH",
"zh-CN",
"zh-Hans",
"pt-PT",
"pt-BR",
"pl-PL",
"tr-TR",
"nl-NL",
"nl-BE",
"cs-CZ",
"ja-JP",
"ru-RU",
"ar-SA",
"ar-EG",
"ar-AE"
],
"type": "string",
"default": "en"
},
"pageSize": {
"type": [
"integer",
"null"
],
"format": "uint64",
"maximum": 18446744073709552000,
"minimum": 0
},
"auctionId": {
"type": "string",
"pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
},
"searchAfter": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}getBrowsingDestinationGet the destination Aura Historia uses to estimate shipping while the signed-in user browses: NONE, one of their saved addresses (ADDRESS) or a country with an optional postal code (COUNTRY_POSTAL), with its version.
read-only
getBrowsingDestination
Get the destination Aura Historia uses to estimate shipping while the signed-in user browses: NONE, one of their saved addresses (ADDRESS) or a country with an optional postal code (COUNTRY_POSTAL), with its version.
No arguments.
Input schema (JSON)
{
"type": "object",
"title": "OwnAccountArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}getProductListingGet the full details of one listing by its productListingId: text, prices, images, provider, availability, auction and shipping, in the requested language and currency. Use it when the user wants more than a search result shows. For a signed-in user, each result also carries userState sections for which the token has the read scope: watchlist:read, search-filters:read, notifications:read or users:read.
read-only
getProductListing
Get the full details of one listing by its productListingId: text, prices, images, provider, availability, auction and shipping, in the requested language and currency. Use it when the user wants more than a search result shows. For a signed-in user, each result also carries userState sections for which the token has the read scope: watchlist:read, search-filters:read, notifications:read or users:read.
| Argument | Type | Description |
|---|---|---|
| currency | string | |
| language | string | |
| productListingId* | string |
Input schema (JSON)
{
"type": "object",
"title": "ListingInput",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"productListingId"
],
"properties": {
"currency": {
"enum": [
"EUR",
"GBP",
"USD",
"AUD",
"CAD",
"NZD",
"CNY",
"BRL",
"PLN",
"TRY",
"JPY",
"CZK",
"RUB",
"AED",
"SAR",
"HKD",
"SGD",
"CHF",
"ZAR",
"SEK",
"DKK",
"NOK",
"KRW",
"INR",
"TWD",
"HUF",
"RON",
"MXN",
"THB",
"ARS"
],
"type": "string",
"default": "EUR"
},
"language": {
"enum": [
"de",
"en",
"fr",
"es",
"it",
"zh",
"pt",
"pl",
"tr",
"nl",
"cs",
"ja",
"ru",
"ar",
"de-DE",
"de-AT",
"de-CH",
"de-LU",
"de-LI",
"en-US",
"en-GB",
"en-AU",
"en-CA",
"en-NZ",
"en_IE",
"fr-FR",
"fr-CA",
"fr-BE",
"fr-CH",
"fr-LU",
"es-ES",
"es-MX",
"es-AR",
"es-CO",
"es-CL",
"es-PE",
"es-VE",
"it-IT",
"it-CH",
"zh-CN",
"zh-Hans",
"pt-PT",
"pt-BR",
"pl-PL",
"tr-TR",
"nl-NL",
"nl-BE",
"cs-CZ",
"ja-JP",
"ru-RU",
"ar-SA",
"ar-EG",
"ar-AE"
],
"type": "string",
"default": "en"
},
"productListingId": {
"type": "string",
"pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"description": "Existing presentation query used by listing detail and similarity reads.",
"additionalProperties": false
}getProductListingByTitleSlugGet the full details of one listing by its productListingTitleSlugId, the last segment of an Aura Historia listing page URL (/products/{slug}). Returns the same details as the lookup by productListingId. For a signed-in user, each result also carries userState sections for which the token has the read scope: watchlist:read, search-filters:read, notifications:read or users:read.
read-only
getProductListingByTitleSlug
Get the full details of one listing by its productListingTitleSlugId, the last segment of an Aura Historia listing page URL (/products/{slug}). Returns the same details as the lookup by productListingId. For a signed-in user, each result also carries userState sections for which the token has the read scope: watchlist:read, search-filters:read, notifications:read or users:read.
| Argument | Type | Description |
|---|---|---|
| currency | string | |
| language | string | |
| productListingTitleSlugId* | string |
Input schema (JSON)
{
"type": "object",
"title": "SlugInput",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"productListingTitleSlugId"
],
"properties": {
"currency": {
"enum": [
"EUR",
"GBP",
"USD",
"AUD",
"CAD",
"NZD",
"CNY",
"BRL",
"PLN",
"TRY",
"JPY",
"CZK",
"RUB",
"AED",
"SAR",
"HKD",
"SGD",
"CHF",
"ZAR",
"SEK",
"DKK",
"NOK",
"KRW",
"INR",
"TWD",
"HUF",
"RON",
"MXN",
"THB",
"ARS"
],
"type": "string",
"default": "EUR"
},
"language": {
"enum": [
"de",
"en",
"fr",
"es",
"it",
"zh",
"pt",
"pl",
"tr",
"nl",
"cs",
"ja",
"ru",
"ar",
"de-DE",
"de-AT",
"de-CH",
"de-LU",
"de-LI",
"en-US",
"en-GB",
"en-AU",
"en-CA",
"en-NZ",
"en_IE",
"fr-FR",
"fr-CA",
"fr-BE",
"fr-CH",
"fr-LU",
"es-ES",
"es-MX",
"es-AR",
"es-CO",
"es-CL",
"es-PE",
"es-VE",
"it-IT",
"it-CH",
"zh-CN",
"zh-Hans",
"pt-PT",
"pt-BR",
"pl-PL",
"tr-TR",
"nl-NL",
"nl-BE",
"cs-CZ",
"ja-JP",
"ru-RU",
"ar-SA",
"ar-EG",
"ar-AE"
],
"type": "string",
"default": "en"
},
"productListingTitleSlugId": {
"type": "string",
"pattern": "^[a-z0-9]+(?:-[a-z0-9]+)*-[0-9a-f]{6}$",
"maxLength": 120
}
},
"description": "Existing presentation query used by listing detail and similarity reads.",
"additionalProperties": false
}getProductListingHistoryGet 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.
read-only
getProductListingHistory
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.
| Argument | Type | Description |
|---|---|---|
| currency | any | |
| productListingId* | string |
Input schema (JSON)
{
"type": "object",
"title": "HistoryInput",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"productListingId"
],
"properties": {
"currency": {
"anyOf": [
{
"enum": [
"EUR",
"GBP",
"USD",
"AUD",
"CAD",
"NZD",
"CNY",
"BRL",
"PLN",
"TRY",
"JPY",
"CZK",
"RUB",
"AED",
"SAR",
"HKD",
"SGD",
"CHF",
"ZAR",
"SEK",
"DKK",
"NOK",
"KRW",
"INR",
"TWD",
"HUF",
"RON",
"MXN",
"THB",
"ARS"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"productListingId": {
"type": "string",
"pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"description": "Existing optional REST history presentation query, reused by MCP arguments.",
"additionalProperties": false
}getPublicListingSourceBySlugGet the public profile of one provider (a dealer, auction house, marketplace or auction platform) by its listingSourceSlugId, the last segment of an Aura Historia provider page URL (/shops/{slug}): name, operator, website and image.
read-only
getPublicListingSourceBySlug
Get the public profile of one provider (a dealer, auction house, marketplace or auction platform) by its listingSourceSlugId, the last segment of an Aura Historia provider page URL (/shops/{slug}): name, operator, website and image.
| Argument | Type | Description |
|---|---|---|
| listingSourceSlugId* | string |
Input schema (JSON)
{
"type": "object",
"title": "GetPublicListingSourceBySlugData",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"listingSourceSlugId"
],
"properties": {
"listingSourceSlugId": {
"type": "string"
}
},
"additionalProperties": false
}getPublicOverviewGet the latest calculated statistics of the Aura Historia catalogue: live listings, listings added in the last seven days, countries, languages and indexed providers by type, with the time they were calculated. Takes no arguments.
read-only
getPublicOverview
Get the latest calculated statistics of the Aura Historia catalogue: live listings, listings added in the last seven days, countries, languages and indexed providers by type, with the time they were calculated. Takes no arguments.
No arguments.
Input schema (JSON)
{
"type": "object",
"title": "OverviewArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}getSimilarProductListingsFind listings similar to one listing, identified by its productListingId. Returns up to a fixed number of neighbours in the requested language and currency. EMBEDDING_PENDING means the listing is not yet prepared for comparison and a later call can succeed; READY with an empty list means nothing similar was found. For a signed-in user, each result also carries userState sections for which the token has the read scope: watchlist:read, search-filters:read, notifications:read or users:read.
read-only
getSimilarProductListings
Find listings similar to one listing, identified by its productListingId. Returns up to a fixed number of neighbours in the requested language and currency. EMBEDDING_PENDING means the listing is not yet prepared for comparison and a later call can succeed; READY with an empty list means nothing similar was found. For a signed-in user, each result also carries userState sections for which the token has the read scope: watchlist:read, search-filters:read, notifications:read or users:read.
| Argument | Type | Description |
|---|---|---|
| currency | string | |
| language | string | |
| productListingId* | string |
Input schema (JSON)
{
"type": "object",
"title": "ListingInput",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"productListingId"
],
"properties": {
"currency": {
"enum": [
"EUR",
"GBP",
"USD",
"AUD",
"CAD",
"NZD",
"CNY",
"BRL",
"PLN",
"TRY",
"JPY",
"CZK",
"RUB",
"AED",
"SAR",
"HKD",
"SGD",
"CHF",
"ZAR",
"SEK",
"DKK",
"NOK",
"KRW",
"INR",
"TWD",
"HUF",
"RON",
"MXN",
"THB",
"ARS"
],
"type": "string",
"default": "EUR"
},
"language": {
"enum": [
"de",
"en",
"fr",
"es",
"it",
"zh",
"pt",
"pl",
"tr",
"nl",
"cs",
"ja",
"ru",
"ar",
"de-DE",
"de-AT",
"de-CH",
"de-LU",
"de-LI",
"en-US",
"en-GB",
"en-AU",
"en-CA",
"en-NZ",
"en_IE",
"fr-FR",
"fr-CA",
"fr-BE",
"fr-CH",
"fr-LU",
"es-ES",
"es-MX",
"es-AR",
"es-CO",
"es-CL",
"es-PE",
"es-VE",
"it-IT",
"it-CH",
"zh-CN",
"zh-Hans",
"pt-PT",
"pt-BR",
"pl-PL",
"tr-TR",
"nl-NL",
"nl-BE",
"cs-CZ",
"ja-JP",
"ru-RU",
"ar-SA",
"ar-EG",
"ar-AE"
],
"type": "string",
"default": "en"
},
"productListingId": {
"type": "string",
"pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"description": "Existing presentation query used by listing detail and similarity reads.",
"additionalProperties": false
}getUserAccountGet the signed-in user's Aura Historia account: email, name, language, currency and measurement unit, content preference, marketing consent, subscription tier and role.
read-only
getUserAccount
Get the signed-in user's Aura Historia account: email, name, language, currency and measurement unit, content preference, marketing consent, subscription tier and role.
No arguments.
Input schema (JSON)
{
"type": "object",
"title": "OwnAccountArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}getUserAddressGet one of the signed-in user's saved addresses by addressId, with its resolved location and the attribution of the geocoding provider.
read-only
getUserAddress
Get one of the signed-in user's saved addresses by addressId, with its resolved location and the attribution of the geocoding provider.
| Argument | Type | Description |
|---|---|---|
| addressId* | string |
Input schema (JSON)
{
"type": "object",
"title": "AddressArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"addressId"
],
"properties": {
"addressId": {
"type": "string",
"pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"additionalProperties": false
}getUserSearchFilterGet one of the signed-in user's saved searches by userSearchFilterId, with its criteria, state and notification settings.
read-only
getUserSearchFilter
Get one of the signed-in user's saved searches by userSearchFilterId, with its criteria, state and notification settings.
| Argument | Type | Description |
|---|---|---|
| userSearchFilterId* | string |
Input schema (JSON)
{
"type": "object",
"title": "FilterArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"userSearchFilterId"
],
"properties": {
"userSearchFilterId": {
"type": "string",
"pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"additionalProperties": false
}getUserSearchFiltersList all of the signed-in user's saved searches with their criteria, state and notification settings. Takes no arguments.
read-only
getUserSearchFilters
List all of the signed-in user's saved searches with their criteria, state and notification settings. Takes no arguments.
No arguments.
Input schema (JSON)
{
"type": "object",
"title": "EmptyArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"additionalProperties": false
}getWatchlistProductListingsList the listings on the signed-in user's watchlist with their full details and notification settings, in the requested language and currency. Pass the returned searchAfter array as a JSON string to get the next page.
read-only
getWatchlistProductListings
List the listings on the signed-in user's watchlist with their full details and notification settings, in the requested language and currency. Pass the returned searchAfter array as a JSON string to get the next page.
| Argument | Type | Description |
|---|---|---|
| size | integer | null | |
| currency | string | |
| language | string | |
| searchAfter | string | null | JSON encoded [RFC3339 watchlist creation timestamp, ProductListing ID]. |
Input schema (JSON)
{
"type": "object",
"title": "ListInput",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"size": {
"type": [
"integer",
"null"
],
"format": "uint64",
"maximum": 18446744073709552000,
"minimum": 0
},
"currency": {
"enum": [
"EUR",
"GBP",
"USD",
"AUD",
"CAD",
"NZD",
"CNY",
"BRL",
"PLN",
"TRY",
"JPY",
"CZK",
"RUB",
"AED",
"SAR",
"HKD",
"SGD",
"CHF",
"ZAR",
"SEK",
"DKK",
"NOK",
"KRW",
"INR",
"TWD",
"HUF",
"RON",
"MXN",
"THB",
"ARS"
],
"type": "string",
"default": "EUR"
},
"language": {
"enum": [
"de",
"en",
"fr",
"es",
"it",
"zh",
"pt",
"pl",
"tr",
"nl",
"cs",
"ja",
"ru",
"ar",
"de-DE",
"de-AT",
"de-CH",
"de-LU",
"de-LI",
"en-US",
"en-GB",
"en-AU",
"en-CA",
"en-NZ",
"en_IE",
"fr-FR",
"fr-CA",
"fr-BE",
"fr-CH",
"fr-LU",
"es-ES",
"es-MX",
"es-AR",
"es-CO",
"es-CL",
"es-PE",
"es-VE",
"it-IT",
"it-CH",
"zh-CN",
"zh-Hans",
"pt-PT",
"pt-BR",
"pl-PL",
"tr-TR",
"nl-NL",
"nl-BE",
"cs-CZ",
"ja-JP",
"ru-RU",
"ar-SA",
"ar-EG",
"ar-AE"
],
"type": "string",
"default": "en"
},
"searchAfter": {
"type": [
"string",
"null"
],
"description": "JSON encoded [RFC3339 watchlist creation timestamp, ProductListing ID]."
}
},
"additionalProperties": false
}listAuctionsList auctions of the auction houses and platforms that Aura Historia indexes, filtered by provider, format, reported status and schedule period and sorted by creation or schedule time. Use it to find upcoming, running or past auctions. A schedule period needs timeRole, from and to together, and sorting by schedule time needs timeRole. Pass the returned searchAfter object as a JSON string to get the next page.
read-only
listAuctions
List auctions of the auction houses and platforms that Aura Historia indexes, filtered by provider, format, reported status and schedule period and sorted by creation or schedule time. Use it to find upcoming, running or past auctions. A schedule period needs timeRole, from and to together, and sorting by schedule time needs timeRole. Pass the returned searchAfter object as a JSON string to get the next page.
| Argument | Type | Description |
|---|---|---|
| to | any | |
| from | any | |
| sort | any | |
| order | any | |
| format | any | |
| pageSize | integer | null | |
| timeRole | any | |
| searchAfter | string | null | |
| reportedStatus | any | |
| listingSourceId | any |
Input schema (JSON)
{
"type": "object",
"title": "DirectoryQuery",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"to": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"default": null
},
"from": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"default": null
},
"sort": {
"anyOf": [
{
"enum": [
"created",
"scheduled"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"order": {
"anyOf": [
{
"enum": [
"asc",
"desc"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"format": {
"anyOf": [
{
"enum": [
"LIVE",
"TIMED"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"pageSize": {
"type": [
"integer",
"null"
],
"format": "uint64",
"maximum": 18446744073709552000,
"minimum": 0
},
"timeRole": {
"anyOf": [
{
"enum": [
"BIDDING_OPENS",
"LIVE_STARTS",
"LOTS_BEGIN_CLOSING",
"SCHEDULED_END"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"searchAfter": {
"type": [
"string",
"null"
]
},
"reportedStatus": {
"anyOf": [
{
"enum": [
"SCHEDULED",
"IN_PROGRESS",
"ENDED",
"POSTPONED",
"CANCELLED"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"listingSourceId": {
"anyOf": [
{
"type": "string",
"pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
},
{
"type": "null"
}
],
"default": null
}
},
"additionalProperties": false
}listNotificationsList the signed-in user's notifications, such as watchlist changes and new saved-search matches, with each listing as it was when notified, in the requested language. Returns up to size notifications (default 21, 1 to 100); pass the returned searchAfter array as a JSON string to get the next page.
read-only
listNotifications
List the signed-in user's notifications, such as watchlist changes and new saved-search matches, with each listing as it was when notified, in the requested language. Returns up to size notifications (default 21, 1 to 100); pass the returned searchAfter array as a JSON string to get the next page.
| Argument | Type | Description |
|---|---|---|
| size | integer | null | Defaults to 21 and is clamped to 1 through 100, as on REST. |
| language | string | |
| searchAfter | string | null | JSON string of the returned [created, notificationId] array. |
Input schema (JSON)
{
"type": "object",
"title": "ListArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"size": {
"type": [
"integer",
"null"
],
"format": "uint64",
"maximum": 18446744073709552000,
"minimum": 0,
"description": "Defaults to 21 and is clamped to 1 through 100, as on REST."
},
"language": {
"enum": [
"de",
"en",
"fr",
"es",
"it",
"zh",
"pt",
"pl",
"tr",
"nl",
"cs",
"ja",
"ru",
"ar",
"de-DE",
"de-AT",
"de-CH",
"de-LU",
"de-LI",
"en-US",
"en-GB",
"en-AU",
"en-CA",
"en-NZ",
"en_IE",
"fr-FR",
"fr-CA",
"fr-BE",
"fr-CH",
"fr-LU",
"es-ES",
"es-MX",
"es-AR",
"es-CO",
"es-CL",
"es-PE",
"es-VE",
"it-IT",
"it-CH",
"zh-CN",
"zh-Hans",
"pt-PT",
"pt-BR",
"pl-PL",
"tr-TR",
"nl-NL",
"nl-BE",
"cs-CZ",
"ja-JP",
"ru-RU",
"ar-SA",
"ar-EG",
"ar-AE"
],
"type": "string",
"default": "en"
},
"searchAfter": {
"type": [
"string",
"null"
],
"description": "JSON string of the returned [created, notificationId] array."
}
},
"additionalProperties": false
}listSearchFilterMatchesList the listings that matched one of the signed-in user's saved searches, oldest match first, in the requested language and currency. Matching runs in the background, so an empty first page means there are no matches yet. Returns up to size matches (default 21, 1 to 100); pass the returned searchAfter array unchanged to get the next page.
read-only
listSearchFilterMatches
List the listings that matched one of the signed-in user's saved searches, oldest match first, in the requested language and currency. Matching runs in the background, so an empty first page means there are no matches yet. Returns up to size matches (default 21, 1 to 100); pass the returned searchAfter array unchanged to get the next page.
| Argument | Type | Description |
|---|---|---|
| size | integer | null | Defaults to 21 and clamps to 1..=100. |
| currency | string | |
| language | string | |
| searchAfter | any | |
| userSearchFilterId* | string |
Input schema (JSON)
{
"type": "object",
"title": "MatchesArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"userSearchFilterId"
],
"properties": {
"size": {
"type": [
"integer",
"null"
],
"format": "uint64",
"default": null,
"maximum": 18446744073709552000,
"minimum": 0,
"description": "Defaults to 21 and clamps to 1..=100."
},
"currency": {
"enum": [
"EUR",
"GBP",
"USD",
"AUD",
"CAD",
"NZD",
"CNY",
"BRL",
"PLN",
"TRY",
"JPY",
"CZK",
"RUB",
"AED",
"SAR",
"HKD",
"SGD",
"CHF",
"ZAR",
"SEK",
"DKK",
"NOK",
"KRW",
"INR",
"TWD",
"HUF",
"RON",
"MXN",
"THB",
"ARS"
],
"type": "string",
"default": "EUR"
},
"language": {
"enum": [
"de",
"en",
"fr",
"es",
"it",
"zh",
"pt",
"pl",
"tr",
"nl",
"cs",
"ja",
"ru",
"ar",
"de-DE",
"de-AT",
"de-CH",
"de-LU",
"de-LI",
"en-US",
"en-GB",
"en-AU",
"en-CA",
"en-NZ",
"en_IE",
"fr-FR",
"fr-CA",
"fr-BE",
"fr-CH",
"fr-LU",
"es-ES",
"es-MX",
"es-AR",
"es-CO",
"es-CL",
"es-PE",
"es-VE",
"it-IT",
"it-CH",
"zh-CN",
"zh-Hans",
"pt-PT",
"pt-BR",
"pl-PL",
"tr-TR",
"nl-NL",
"nl-BE",
"cs-CZ",
"ja-JP",
"ru-RU",
"ar-SA",
"ar-EG",
"ar-AE"
],
"type": "string",
"default": "en"
},
"searchAfter": {
"anyOf": [
{
"type": "array",
"maxItems": 2,
"minItems": 2,
"prefixItems": [
{
"type": "string",
"format": "date-time"
},
{
"type": "string",
"pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
]
},
{
"type": "null"
}
],
"default": null
},
"userSearchFilterId": {
"type": "string",
"pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"additionalProperties": false
}listUserAddressesList the signed-in user's saved addresses with their resolved locations. Returns up to limit addresses (default 25, 1 to 100); pass the returned next as after to get the next page.
read-only
listUserAddresses
List the signed-in user's saved addresses with their resolved locations. Returns up to limit addresses (default 25, 1 to 100); pass the returned next as after to get the next page.
| Argument | Type | Description |
|---|---|---|
| after | any | |
| limit | integer | null |
Input schema (JSON)
{
"type": "object",
"title": "PageQuery",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"after": {
"anyOf": [
{
"type": "string",
"pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
},
{
"type": "null"
}
],
"default": null
},
"limit": {
"type": [
"integer",
"null"
],
"format": "uint32",
"default": null,
"maximum": 100,
"minimum": 1
}
},
"additionalProperties": false
}patchWatchlistProductTurn notifications for a watched listing on or off, or pause (INACTIVE_BY_USER) or resume (ACTIVE) the entry. Omitted fields stay unchanged and null is invalid; resuming is subject to subscription tier limits. Returns the listing with its full details in the requested language and currency.
destructive
patchWatchlistProduct
Turn notifications for a watched listing on or off, or pause (INACTIVE_BY_USER) or resume (ACTIVE) the entry. Omitted fields stay unchanged and null is invalid; resuming is subject to subscription tier limits. Returns the listing with its full details in the requested language and currency.
| Argument | Type | Description |
|---|---|---|
| state | string | |
| currency | string | |
| language | string | |
| notifications | boolean | |
| productListingId* | string |
Input schema (JSON)
{
"type": "object",
"title": "UpdateInput",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"productListingId"
],
"properties": {
"state": {
"enum": [
"ACTIVE",
"INACTIVE_BY_USER"
],
"type": "string"
},
"currency": {
"enum": [
"EUR",
"GBP",
"USD",
"AUD",
"CAD",
"NZD",
"CNY",
"BRL",
"PLN",
"TRY",
"JPY",
"CZK",
"RUB",
"AED",
"SAR",
"HKD",
"SGD",
"CHF",
"ZAR",
"SEK",
"DKK",
"NOK",
"KRW",
"INR",
"TWD",
"HUF",
"RON",
"MXN",
"THB",
"ARS"
],
"type": "string",
"default": "EUR"
},
"language": {
"enum": [
"de",
"en",
"fr",
"es",
"it",
"zh",
"pt",
"pl",
"tr",
"nl",
"cs",
"ja",
"ru",
"ar",
"de-DE",
"de-AT",
"de-CH",
"de-LU",
"de-LI",
"en-US",
"en-GB",
"en-AU",
"en-CA",
"en-NZ",
"en_IE",
"fr-FR",
"fr-CA",
"fr-BE",
"fr-CH",
"fr-LU",
"es-ES",
"es-MX",
"es-AR",
"es-CO",
"es-CL",
"es-PE",
"es-VE",
"it-IT",
"it-CH",
"zh-CN",
"zh-Hans",
"pt-PT",
"pt-BR",
"pl-PL",
"tr-TR",
"nl-NL",
"nl-BE",
"cs-CZ",
"ja-JP",
"ru-RU",
"ar-SA",
"ar-EG",
"ar-AE"
],
"type": "string",
"default": "en"
},
"notifications": {
"type": "boolean"
},
"productListingId": {
"type": "string",
"pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"description": "Existing presentation query used by listing detail and similarity reads.",
"additionalProperties": false
}searchPublicListingSourcesSearch the providers whose listings Aura Historia indexes (dealers, auction houses, marketplaces and auction platforms) by name. Without a query it browses all providers; a query too short to match returns no results. Returns 1 to 50 providers per page (default 21); pass the returned searchAfter unchanged, with the same query and size, to get the next page.
read-only
searchPublicListingSources
Search the providers whose listings Aura Historia indexes (dealers, auction houses, marketplaces and auction platforms) by name. Without a query it browses all providers; a query too short to match returns no results. Returns 1 to 50 providers per page (default 21); pass the returned searchAfter unchanged, with the same query and size, to get the next page.
| Argument | Type | Description |
|---|---|---|
| size | integer | Page size from 1 through 50. Continuations are bound to the query and page size. |
| query | string | null | Optional source-name text; omission or whitespace browses, insufficient text returns no matches. |
| searchAfter | string | null |
Input schema (JSON)
{
"type": "object",
"title": "SearchPublicListingSourcesData",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"size": {
"type": "integer",
"format": "uint8",
"default": 21,
"maximum": 255,
"minimum": 0,
"description": "Page size from 1 through 50. Continuations are bound to the query and page size."
},
"query": {
"type": [
"string",
"null"
],
"default": null,
"description": "Optional source-name text; omission or whitespace browses, insufficient text returns no matches."
},
"searchAfter": {
"type": [
"string",
"null"
],
"default": null
}
},
"additionalProperties": false
}setBrowsingDestinationSet or clear the destination used to estimate shipping while the signed-in user browses: NONE clears it, ADDRESS selects one of their saved addresses and COUNTRY_POSTAL a country with an optional postal code. expectedVersion must equal the current version. Returns the new destination and version.
destructive
setBrowsingDestination
Set or clear the destination used to estimate shipping while the signed-in user browses: NONE clears it, ADDRESS selects one of their saved addresses and COUNTRY_POSTAL a country with an optional postal code. expectedVersion must equal the current version. Returns the new destination and version.
| Argument | Type | Description |
|---|---|---|
| destination* | any | |
| expectedVersion* | integer |
Input schema (JSON)
{
"type": "object",
"$defs": {
"DestinationData": {
"oneOf": [
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "NONE"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"addressId"
],
"properties": {
"kind": {
"type": "string",
"const": "ADDRESS"
},
"addressId": {
"type": "string",
"pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"country"
],
"properties": {
"kind": {
"type": "string",
"const": "COUNTRY_POSTAL"
},
"country": {
"type": "string"
},
"postalCode": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
}
]
}
},
"title": "SetDestinationData",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"expectedVersion",
"destination"
],
"properties": {
"destination": {
"$ref": "#/$defs/DestinationData"
},
"expectedVersion": {
"type": "integer",
"format": "uint64",
"maximum": 9223372036854776000,
"minimum": 1
}
},
"additionalProperties": false
}simpleSearchProductListingsSearch Aura Historia's index of art, antiques and design objects listed by dealers, auction houses, marketplaces and auction platforms. Use it to find listings by text and by filters such as price, dates, availability, provider, auction, location and shipping. Returns listing summaries in the requested language and currency, with the total when known; pass the returned searchAfter object unchanged to get the next page. For a signed-in user, each result also carries userState sections for which the token has the read scope: watchlist:read, search-filters:read, notifications:read or users:read.
read-only
simpleSearchProductListings
Search Aura Historia's index of art, antiques and design objects listed by dealers, auction houses, marketplaces and auction platforms. Use it to find listings by text and by filters such as price, dates, availability, provider, auction, location and shipping. Returns listing summaries in the requested language and currency, with the total when known; pass the returned searchAfter object unchanged to get the next page. For a signed-in user, each result also carries userState sections for which the token has the read scope: watchlist:read, search-filters:read, notifications:read or users:read.
| Argument | Type | Description |
|---|---|---|
| size | integer | null | Values are clamped to the existing service-supported range 1..=100. |
| sort | any | |
| order | any | |
| price | any | |
| created | any | |
| updated | any | |
| currency | string | |
| language | string | |
| shipping | any | |
| auctionId | array | |
| geography | any | |
| searchAfter | any | |
| availability | any | |
| orderability | any | |
| productQuery | array | |
| listingSourceId | array | |
| lotBiddingOpens | any | |
| lotScheduledCloses | any | |
| excludeListingSourceId | array | |
| excludeProductListingId | array | |
| enhancedSearchDescription | string | null | |
| includeUnspecifiedAvailability | boolean | null |
Input schema (JSON)
{
"type": "object",
"$defs": {
"AmountData": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "integer",
"format": "uint64",
"maximum": 9223372036854776000,
"minimum": 0
},
"currency": {
"enum": [
"EUR",
"GBP",
"USD",
"AUD",
"CAD",
"NZD",
"CNY",
"BRL",
"PLN",
"TRY",
"JPY",
"CZK",
"RUB",
"AED",
"SAR",
"HKD",
"SGD",
"CHF",
"ZAR",
"SEK",
"DKK",
"NOK",
"KRW",
"INR",
"TWD",
"HUF",
"RON",
"MXN",
"THB",
"ARS"
],
"type": "string"
}
},
"additionalProperties": false
},
"OriginData": {
"type": "object",
"required": [
"latitude",
"longitude"
],
"properties": {
"latitude": {
"type": "number",
"format": "double"
},
"longitude": {
"type": "number",
"format": "double"
}
},
"additionalProperties": false
},
"DateRangeSchema": {
"type": "object",
"properties": {
"max": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"default": null
},
"min": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"default": null
}
}
},
"DestinationData": {
"oneOf": [
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "NONE"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"country"
],
"properties": {
"kind": {
"type": "string",
"const": "COUNTRY"
},
"country": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"NumberRangeSchema": {
"type": "object",
"properties": {
"max": {
"type": [
"integer",
"null"
],
"format": "uint64",
"maximum": 18446744073709552000,
"minimum": 0
},
"min": {
"type": [
"integer",
"null"
],
"format": "uint64",
"maximum": 18446744073709552000,
"minimum": 0
}
}
},
"ShippingSearchData": {
"type": "object",
"properties": {
"service": {
"type": [
"string",
"null"
]
},
"destination": {
"anyOf": [
{
"$ref": "#/$defs/DestinationData"
},
{
"type": "null"
}
]
},
"interpretation": {
"type": [
"string",
"null"
]
},
"maximumPerItem": {
"anyOf": [
{
"$ref": "#/$defs/AmountData"
},
{
"type": "null"
}
]
},
"referenceRelease": {
"type": [
"string",
"null"
]
},
"collectionOffered": {
"type": "boolean"
}
},
"additionalProperties": false
},
"GeographicSearchData": {
"type": "object",
"properties": {
"mode": {
"type": [
"string",
"null"
]
},
"origin": {
"anyOf": [
{
"$ref": "#/$defs/OriginData"
},
{
"type": "null"
}
]
},
"radius": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"unit"
],
"properties": {
"unit": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"countries": {
"type": "array",
"items": {
"type": "string"
}
},
"subdivisions": {
"type": "array",
"items": {
"type": "string"
}
},
"distanceOrder": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"SortProductListingFieldData": {
"enum": [
"score",
"updated",
"created"
],
"type": "string"
},
"ProductListingSearchCursorInputData": {
"type": "object",
"required": [
"fxRateId",
"searchAfter"
],
"properties": {
"fxRateId": {
"type": "string",
"pattern": "^fx_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
},
"searchAfter": true
}
}
},
"title": "SearchInput",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"size": {
"type": [
"integer",
"null"
],
"format": "uint64",
"maximum": 18446744073709552000,
"minimum": 0,
"description": "Values are clamped to the existing service-supported range 1..=100."
},
"sort": {
"anyOf": [
{
"$ref": "#/$defs/SortProductListingFieldData"
},
{
"type": "null"
}
]
},
"order": {
"anyOf": [
{
"enum": [
"asc",
"desc"
],
"type": "string"
},
{
"type": "null"
}
],
"default": null
},
"price": {
"anyOf": [
{
"$ref": "#/$defs/NumberRangeSchema"
},
{
"type": "null"
}
],
"default": null
},
"created": {
"$ref": "#/$defs/DateRangeSchema",
"default": null
},
"updated": {
"$ref": "#/$defs/DateRangeSchema",
"default": null
},
"currency": {
"enum": [
"EUR",
"GBP",
"USD",
"AUD",
"CAD",
"NZD",
"CNY",
"BRL",
"PLN",
"TRY",
"JPY",
"CZK",
"RUB",
"AED",
"SAR",
"HKD",
"SGD",
"CHF",
"ZAR",
"SEK",
"DKK",
"NOK",
"KRW",
"INR",
"TWD",
"HUF",
"RON",
"MXN",
"THB",
"ARS"
],
"type": "string",
"default": "EUR"
},
"language": {
"enum": [
"de",
"en",
"fr",
"es",
"it",
"zh",
"pt",
"pl",
"tr",
"nl",
"cs",
"ja",
"ru",
"ar",
"de-DE",
"de-AT",
"de-CH",
"de-LU",
"de-LI",
"en-US",
"en-GB",
"en-AU",
"en-CA",
"en-NZ",
"en_IE",
"fr-FR",
"fr-CA",
"fr-BE",
"fr-CH",
"fr-LU",
"es-ES",
"es-MX",
"es-AR",
"es-CO",
"es-CL",
"es-PE",
"es-VE",
"it-IT",
"it-CH",
"zh-CN",
"zh-Hans",
"pt-PT",
"pt-BR",
"pl-PL",
"tr-TR",
"nl-NL",
"nl-BE",
"cs-CZ",
"ja-JP",
"ru-RU",
"ar-SA",
"ar-EG",
"ar-AE"
],
"type": "string",
"default": "en"
},
"shipping": {
"anyOf": [
{
"$ref": "#/$defs/ShippingSearchData"
},
{
"type": "null"
}
],
"default": null
},
"auctionId": {
"type": "array",
"items": {
"type": "string",
"pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
},
"default": []
},
"geography": {
"anyOf": [
{
"$ref": "#/$defs/GeographicSearchData"
},
{
"type": "null"
}
],
"default": null
},
"searchAfter": {
"anyOf": [
{
"$ref": "#/$defs/ProductListingSearchCursorInputData"
},
{
"type": "null"
}
]
},
"availability": {
"anyOf": [
{
"type": "array",
"items": {
"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"
}
]
},
"orderability": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"ORDERABLE_NOW",
"ORDERABLE_CONDITIONALLY",
"NOT_ORDERABLE"
],
"type": "string"
}
},
{
"type": "null"
}
]
},
"productQuery": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"default": []
},
"listingSourceId": {
"type": "array",
"items": {
"type": "string",
"pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
},
"default": []
},
"lotBiddingOpens": {
"$ref": "#/$defs/DateRangeSchema",
"default": null
},
"lotScheduledCloses": {
"$ref": "#/$defs/DateRangeSchema",
"default": null
},
"excludeListingSourceId": {
"type": "array",
"items": {
"type": "string",
"pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
},
"default": []
},
"excludeProductListingId": {
"type": "array",
"items": {
"type": "string",
"pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
},
"default": []
},
"enhancedSearchDescription": {
"type": [
"string",
"null"
],
"default": null
},
"includeUnspecifiedAvailability": {
"type": [
"boolean",
"null"
],
"default": null
}
},
"description": "Query options shared by REST extraction and MCP's combined argument envelope.",
"additionalProperties": false
}updateAllNotificationsSeenMark every notification of the signed-in user as seen or unseen, including those beyond the listed page. Returns an empty object.
destructive
updateAllNotificationsSeen
Mark every notification of the signed-in user as seen or unseen, including those beyond the listed page. Returns an empty object.
| Argument | Type | Description |
|---|---|---|
| seen* | boolean |
Input schema (JSON)
{
"type": "object",
"title": "AllSeenArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"seen"
],
"properties": {
"seen": {
"type": "boolean"
}
},
"additionalProperties": false
}updateNotificationSeenMark one of the signed-in user's notifications as seen or unseen by notificationId. Returns an empty object; an unknown ID returns NOT_FOUND.
destructive
updateNotificationSeen
Mark one of the signed-in user's notifications as seen or unseen by notificationId. Returns an empty object; an unknown ID returns NOT_FOUND.
| Argument | Type | Description |
|---|---|---|
| seen* | boolean | |
| notificationId* | string |
Input schema (JSON)
{
"type": "object",
"title": "SingleSeenArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"notificationId",
"seen"
],
"properties": {
"seen": {
"type": "boolean"
},
"notificationId": {
"type": "string",
"pattern": "^ntf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"additionalProperties": false
}updateNotificationsSeenMark the signed-in user's notifications with the given notificationIds (at least one) as seen or unseen. Unknown IDs are ignored. Returns an empty object.
destructive
updateNotificationsSeen
Mark the signed-in user's notifications with the given notificationIds (at least one) as seen or unseen. Unknown IDs are ignored. Returns an empty object.
| Argument | Type | Description |
|---|---|---|
| seen* | boolean | |
| notificationIds* | array |
Input schema (JSON)
{
"type": "object",
"title": "SelectedSeenArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"notificationIds",
"seen"
],
"properties": {
"seen": {
"type": "boolean"
},
"notificationIds": {
"type": "array",
"items": {
"type": "string",
"pattern": "^ntf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
}
},
"additionalProperties": false
}updateSearchFilterMatchFeedbackRecord whether a listing that matched one of the signed-in user's saved searches is relevant: true or false sets the feedback, null clears it and omission keeps it. Returns the match; a listing that is not a current match returns NOT_FOUND.
destructive
updateSearchFilterMatchFeedback
Record whether a listing that matched one of the signed-in user's saved searches is relevant: true or false sets the feedback, null clears it and omission keeps it. Returns the match; a listing that is not a current match returns NOT_FOUND.
| Argument | Type | Description |
|---|---|---|
| feedback | any | |
| productListingId* | string | |
| userSearchFilterId* | string |
Input schema (JSON)
{
"type": "object",
"$defs": {
"PatchValue_boolean": {
"type": [
"boolean",
"null"
]
}
},
"title": "FeedbackArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"userSearchFilterId",
"productListingId"
],
"properties": {
"feedback": {
"$ref": "#/$defs/PatchValue_boolean"
},
"productListingId": {
"type": "string",
"pattern": "^pl_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
},
"userSearchFilterId": {
"type": "string",
"pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"additionalProperties": false
}updateUserAccountUpdate the signed-in user's name, language, currency, measurement unit or whether unassessed or sensitive content is shown. Omitted fields stay unchanged and null clears an optional field; the content preference cannot be null. Returns the updated account.
destructive
updateUserAccount
Update the signed-in user's name, language, currency, measurement unit or whether unassessed or sensitive content is shown. Omitted fields stay unchanged and null clears an optional field; the content preference cannot be null. Returns the updated account.
| Argument | Type | Description |
|---|---|---|
| currency | any | |
| language | any | |
| lastName | string | null | |
| firstName | string | null | |
| measurementUnit | any | |
| showUnassessedOrSensitiveContent | boolean |
Input schema (JSON)
{
"type": "object",
"title": "PatchOwnUserData",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"currency": {
"anyOf": [
{
"enum": [
"EUR",
"GBP",
"USD",
"AUD",
"CAD",
"NZD",
"CNY",
"BRL",
"PLN",
"TRY",
"JPY",
"CZK",
"RUB",
"AED",
"SAR",
"HKD",
"SGD",
"CHF",
"ZAR",
"SEK",
"DKK",
"NOK",
"KRW",
"INR",
"TWD",
"HUF",
"RON",
"MXN",
"THB",
"ARS"
],
"type": "string"
},
{
"type": "null"
}
]
},
"language": {
"anyOf": [
{
"enum": [
"de",
"en",
"fr",
"es",
"it",
"zh",
"pt",
"pl",
"tr",
"nl",
"cs",
"ja",
"ru",
"ar",
"de-DE",
"de-AT",
"de-CH",
"de-LU",
"de-LI",
"en-US",
"en-GB",
"en-AU",
"en-CA",
"en-NZ",
"en_IE",
"fr-FR",
"fr-CA",
"fr-BE",
"fr-CH",
"fr-LU",
"es-ES",
"es-MX",
"es-AR",
"es-CO",
"es-CL",
"es-PE",
"es-VE",
"it-IT",
"it-CH",
"zh-CN",
"zh-Hans",
"pt-PT",
"pt-BR",
"pl-PL",
"tr-TR",
"nl-NL",
"nl-BE",
"cs-CZ",
"ja-JP",
"ru-RU",
"ar-SA",
"ar-EG",
"ar-AE"
],
"type": "string"
},
{
"type": "null"
}
]
},
"lastName": {
"type": [
"string",
"null"
]
},
"firstName": {
"type": [
"string",
"null"
]
},
"measurementUnit": {
"anyOf": [
{
"enum": [
"METRIC",
"IMPERIAL"
],
"type": "string"
},
{
"type": "null"
}
]
},
"showUnassessedOrSensitiveContent": {
"type": "boolean"
}
}
}updateUserAddressReplace the label and location of one of the signed-in user's saved addresses. expectedVersion must equal the address's current version; a stale version returns CONFLICT. Returns the updated address.
destructive
updateUserAddress
Replace the label and location of one of the signed-in user's saved addresses. expectedVersion must equal the address's current version; a stale version returns CONFLICT. Returns the updated address.
| Argument | Type | Description |
|---|---|---|
| label* | string | |
| addressId* | string | |
| geography* | any | |
| expectedVersion* | integer |
Input schema (JSON)
{
"type": "object",
"$defs": {
"GeographyData": {
"type": "object",
"required": [
"referenceRelease"
],
"properties": {
"country": {
"type": [
"string",
"null"
]
},
"postalCode": {
"type": [
"string",
"null"
]
},
"addressText": {
"type": [
"string",
"null"
]
},
"subdivision": {
"type": [
"string",
"null"
]
},
"referenceRelease": {
"type": "string"
}
},
"additionalProperties": false
}
},
"title": "UpdateAddressArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"addressId",
"expectedVersion",
"label",
"geography"
],
"properties": {
"label": {
"type": "string"
},
"addressId": {
"type": "string",
"pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
},
"geography": {
"allOf": [
{
"$ref": "#/$defs/GeographyData"
},
{
"type": "object",
"required": [
"addressText"
],
"properties": {
"addressText": {
"type": "string",
"maxLength": 4096,
"minLength": 1
}
}
}
]
},
"expectedVersion": {
"type": "integer",
"format": "uint64",
"maximum": 9223372036854776000,
"minimum": 1
}
},
"additionalProperties": false
}updateUserSearchFilterChange the name, criteria, state or notification setting of one of the signed-in user's saved searches. Omitted fields stay unchanged and null clears fields that can be cleared; availability, orderability and includeUnspecifiedAvailability change together. Matching against new criteria runs in the background. Returns the saved search.
destructive
updateUserSearchFilter
Change the name, criteria, state or notification setting of one of the signed-in user's saved searches. Omitted fields stay unchanged and null clears fields that can be cleared; availability, orderability and includeUnspecifiedAvailability change together. Matching against new criteria runs in the background. Returns the saved search.
| Argument | Type | Description |
|---|---|---|
| name | string | null | |
| state | any | |
| search | any | |
| notifications | boolean | null | |
| userSearchFilterId* | string | |
| acceptShippingDestination | any |
Input schema (JSON)
{
"type": "object",
"$defs": {
"AmountData": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "integer",
"format": "uint64",
"maximum": 9223372036854776000,
"minimum": 0
},
"currency": {
"enum": [
"EUR",
"GBP",
"USD",
"AUD",
"CAD",
"NZD",
"CNY",
"BRL",
"PLN",
"TRY",
"JPY",
"CZK",
"RUB",
"AED",
"SAR",
"HKD",
"SGD",
"CHF",
"ZAR",
"SEK",
"DKK",
"NOK",
"KRW",
"INR",
"TWD",
"HUF",
"RON",
"MXN",
"THB",
"ARS"
],
"type": "string"
}
},
"additionalProperties": false
},
"OriginData": {
"type": "object",
"required": [
"latitude",
"longitude"
],
"properties": {
"latitude": {
"type": "number",
"format": "double"
},
"longitude": {
"type": "number",
"format": "double"
}
},
"additionalProperties": false
},
"DateRangeSchema": {
"type": "object",
"properties": {
"max": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"default": null
},
"min": {
"anyOf": [
{
"type": "string",
"format": "date-time"
},
{
"type": "null"
}
],
"default": null
}
}
},
"DestinationData": {
"oneOf": [
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "NONE"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind",
"country"
],
"properties": {
"kind": {
"type": "string",
"const": "COUNTRY"
},
"country": {
"type": "string"
}
},
"additionalProperties": false
}
]
},
"NumberRangeSchema": {
"type": "object",
"properties": {
"max": {
"type": [
"integer",
"null"
],
"format": "uint64",
"maximum": 18446744073709552000,
"minimum": 0
},
"min": {
"type": [
"integer",
"null"
],
"format": "uint64",
"maximum": 18446744073709552000,
"minimum": 0
}
}
},
"PatchValue_string": {
"type": [
"string",
"null"
]
},
"PatchValue_boolean": {
"type": [
"boolean",
"null"
]
},
"ShippingSearchData": {
"type": "object",
"properties": {
"service": {
"type": [
"string",
"null"
]
},
"destination": {
"anyOf": [
{
"$ref": "#/$defs/DestinationData"
},
{
"type": "null"
}
]
},
"interpretation": {
"type": [
"string",
"null"
]
},
"maximumPerItem": {
"anyOf": [
{
"$ref": "#/$defs/AmountData"
},
{
"type": "null"
}
]
},
"referenceRelease": {
"type": [
"string",
"null"
]
},
"collectionOffered": {
"type": "boolean"
}
},
"additionalProperties": false
},
"GeographicSearchData": {
"type": "object",
"properties": {
"mode": {
"type": [
"string",
"null"
]
},
"origin": {
"anyOf": [
{
"$ref": "#/$defs/OriginData"
},
{
"type": "null"
}
]
},
"radius": {
"anyOf": [
{
"type": "object",
"required": [
"amount",
"unit"
],
"properties": {
"unit": {
"type": "string"
},
"amount": {
"type": "number"
}
},
"additionalProperties": false
},
{
"type": "null"
}
]
},
"countries": {
"type": "array",
"items": {
"type": "string"
}
},
"subdivisions": {
"type": "array",
"items": {
"type": "string"
}
},
"distanceOrder": {
"type": [
"string",
"null"
]
}
},
"additionalProperties": false
},
"PatchSearchFilterStateData": {
"enum": [
"ACTIVE",
"INACTIVE_BY_USER"
],
"type": "string"
},
"AcceptShippingDestinationData": {
"oneOf": [
{
"type": "object",
"required": [
"kind",
"addressId"
],
"properties": {
"kind": {
"type": "string",
"const": "ADDRESS"
},
"addressId": {
"type": "string",
"pattern": "^uaddr_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"additionalProperties": false
},
{
"type": "object",
"required": [
"kind"
],
"properties": {
"kind": {
"type": "string",
"const": "PREFERENCE"
}
},
"additionalProperties": false
}
],
"description": "Optional acceptance guard. The submitted country must equal the authorized address or\npreference's asserted country. Neither the reference nor provider evidence is retained."
},
"PatchValue_ShippingSearchData": {
"anyOf": [
{
"$ref": "#/$defs/ShippingSearchData"
},
{
"type": "null"
}
]
},
"ProductListingSearchPatchData": {
"type": "object",
"anyOf": [
{
"not": {
"anyOf": [
{
"required": [
"availability"
]
},
{
"required": [
"orderability"
]
},
{
"required": [
"includeUnspecifiedAvailability"
]
}
]
}
},
{
"required": [
"availability",
"orderability",
"includeUnspecifiedAvailability"
],
"properties": {
"availability": {
"type": "null"
},
"orderability": {
"type": "null"
},
"includeUnspecifiedAvailability": {
"type": "null"
}
}
},
{
"required": [
"availability",
"orderability",
"includeUnspecifiedAvailability"
],
"properties": {
"availability": {
"type": "array"
},
"orderability": {
"type": "array"
},
"includeUnspecifiedAvailability": {
"type": "boolean"
}
}
}
],
"properties": {
"price": {
"anyOf": [
{
"$ref": "#/$defs/NumberRangeSchema"
},
{
"type": "null"
}
]
},
"created": {
"anyOf": [
{
"$ref": "#/$defs/DateRangeSchema"
},
{
"type": "null"
}
]
},
"updated": {
"anyOf": [
{
"$ref": "#/$defs/DateRangeSchema"
},
{
"type": "null"
}
]
},
"currency": {
"enum": [
"EUR",
"GBP",
"USD",
"AUD",
"CAD",
"NZD",
"CNY",
"BRL",
"PLN",
"TRY",
"JPY",
"CZK",
"RUB",
"AED",
"SAR",
"HKD",
"SGD",
"CHF",
"ZAR",
"SEK",
"DKK",
"NOK",
"KRW",
"INR",
"TWD",
"HUF",
"RON",
"MXN",
"THB",
"ARS"
],
"type": "string"
},
"language": {
"enum": [
"de",
"en",
"fr",
"es",
"it",
"zh",
"pt",
"pl",
"tr",
"nl",
"cs",
"ja",
"ru",
"ar",
"de-DE",
"de-AT",
"de-CH",
"de-LU",
"de-LI",
"en-US",
"en-GB",
"en-AU",
"en-CA",
"en-NZ",
"en_IE",
"fr-FR",
"fr-CA",
"fr-BE",
"fr-CH",
"fr-LU",
"es-ES",
"es-MX",
"es-AR",
"es-CO",
"es-CL",
"es-PE",
"es-VE",
"it-IT",
"it-CH",
"zh-CN",
"zh-Hans",
"pt-PT",
"pt-BR",
"pl-PL",
"tr-TR",
"nl-NL",
"nl-BE",
"cs-CZ",
"ja-JP",
"ru-RU",
"ar-SA",
"ar-EG",
"ar-AE"
],
"type": "string"
},
"shipping": {
"$ref": "#/$defs/PatchValue_ShippingSearchData"
},
"auctionId": {
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"pattern": "^auc_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
{
"type": "null"
}
]
},
"geography": {
"$ref": "#/$defs/PatchValue_GeographicSearchData"
},
"availability": {
"anyOf": [
{
"type": "array",
"items": {
"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"
}
]
},
"orderability": {
"anyOf": [
{
"type": "array",
"items": {
"enum": [
"ORDERABLE_NOW",
"ORDERABLE_CONDITIONALLY",
"NOT_ORDERABLE"
],
"type": "string"
}
},
{
"type": "null"
}
]
},
"productQuery": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
}
},
"listingSourceId": {
"type": "array",
"items": {
"type": "string",
"pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"lotBiddingOpens": {
"anyOf": [
{
"$ref": "#/$defs/DateRangeSchema"
},
{
"type": "null"
}
]
},
"lotScheduledCloses": {
"anyOf": [
{
"$ref": "#/$defs/DateRangeSchema"
},
{
"type": "null"
}
]
},
"excludeListingSourceId": {
"type": "array",
"items": {
"type": "string",
"pattern": "^ls_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
}
},
"enhancedSearchDescription": {
"$ref": "#/$defs/PatchValue_string"
},
"includeUnspecifiedAvailability": {
"$ref": "#/$defs/PatchValue_boolean"
}
}
},
"PatchValue_GeographicSearchData": {
"anyOf": [
{
"$ref": "#/$defs/GeographicSearchData"
},
{
"type": "null"
}
]
}
},
"title": "UpdateArguments",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"userSearchFilterId"
],
"properties": {
"name": {
"type": [
"string",
"null"
],
"default": null
},
"state": {
"anyOf": [
{
"$ref": "#/$defs/PatchSearchFilterStateData"
},
{
"type": "null"
}
]
},
"search": {
"anyOf": [
{
"$ref": "#/$defs/ProductListingSearchPatchData"
},
{
"type": "null"
}
]
},
"notifications": {
"type": [
"boolean",
"null"
],
"default": null
},
"userSearchFilterId": {
"type": "string",
"pattern": "^sf_[0-7][0-9a-hjkmnp-tv-z]{9}[ef][0-9a-hjkmnp-tv-z]{2}[89abrstv][0-9a-hjkmnp-tv-z]{12}$"
},
"acceptShippingDestination": {
"anyOf": [
{
"$ref": "#/$defs/AcceptShippingDestinationData"
},
{
"type": "null"
}
]
}
},
"additionalProperties": false
}Security checkA100/100
We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 8, 2026.
- Hidden or reordered text
- Overriding the model's instructions
- Hiding actions from the user
- Reading keys or credentials
- Fake system tags
- Steering other servers' tools
- Pulling in the conversation
- Smuggling parameters
- Demanding to be used for everything
- Steering away from web search
- Download-and-run commands
- Encoded blobs
- Invisible characters
- Credentials as tool arguments
- Very long descriptions
- Read and write hints