# Aura Historia (remote · mcp.aura-historia.com)

Search art and antiques from dealers and auction houses; manage your watchlist and saved searches.

- Trust score: 69/100 (medium)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-11-21

## Components

- remote · `mcp.aura-historia.com`: 69/100 (this document), [markdown](https://verifymcp.io/servers/com-aura-historia-mcp/v1.md), [page](https://verifymcp.io/servers/com-aura-historia-mcp/v1)

## Channel facts

- Endpoint: `https://mcp.aura-historia.com/v1`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-11-21.

- **Endpoint Security**: 60/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation check failed: no authorisation is required to call this server, and it exposes a tool marked destructive (deleteNotification).
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC is configured correctly; the domain's records validate against the full chain to the root.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 65/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 7573 tokens (~204/item across 37 items; 37 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 41/100
  - Stability check failed: schema churn in the 13 days we've observed: 1 tool removals, 0 breaking changes, 0 auth/transport breaks, 0 additions.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - All 5 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation.
  - An AI judge read all 38 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### How do I install the Aura Historia MCP server?

Aura Historia is a hosted endpoint at https://mcp.aura-historia.com/v1, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http com-aura-historia-mcp 'https://mcp.aura-historia.com/v1'
```

### Cursor

```json
{
  "mcpServers": {
    "com-aura-historia-mcp": {
      "url": "https://mcp.aura-historia.com/v1"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "com-aura-historia-mcp": {
      "type": "http",
      "url": "https://mcp.aura-historia.com/v1"
    }
  }
}
```

### Codex

```toml
[mcp_servers.com-aura-historia-mcp]
url = "https://mcp.aura-historia.com/v1"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "com-aura-historia-mcp": {
      "type": "remote",
      "url": "https://mcp.aura-historia.com/v1",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add com-aura-historia-mcp --url 'https://mcp.aura-historia.com/v1' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  com-aura-historia-mcp:
    url: "https://mcp.aura-historia.com/v1"
```

### Netclaw

```json
{
  "McpServers": {
    "com-aura-historia-mcp": {
      "Transport": "http",
      "Url": "https://mcp.aura-historia.com/v1"
    }
  }
}
```

### Vellum

```bash
assistant mcp add com-aura-historia-mcp -t streamable-http -u 'https://mcp.aura-historia.com/v1'
```

### Other

```json
{
  "mcpServers": {
    "com-aura-historia-mcp": {
      "type": "http",
      "url": "https://mcp.aura-historia.com/v1"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-11-21 (score 69, 0)

- [functional] Server version: 69d18537fbc2d6521bffdf835d2a5a94bfe07def → 870165d18629801d5695e65eb392caa5af81e7d4

### 2026-11-20 (score 69, +1)

- [functional] Server version: 2eecaaf92e66f624dfd29db18778e60e6b665a31 → 69d18537fbc2d6521bffdf835d2a5a94bfe07def

### 2026-11-18 (score 68, +1)

- [functional] Server version: cb1c27d56291c10ad036f7bcb7803835199a41d8 → 2eecaaf92e66f624dfd29db18778e60e6b665a31

### 2026-11-17 (score 67, 0)

- [functional] Server version: 3f32a83dea85a3a17ac11f02d7958b1cf3572b99 → cb1c27d56291c10ad036f7bcb7803835199a41d8

### 2026-11-16 (score 67, 0)

- [functional] Server version: 59c49b4b68f32ec382f14795cc24abb05f8a6816 → 3f32a83dea85a3a17ac11f02d7958b1cf3572b99

### 2026-11-15 (score 67, +1)

- [functional] Server version: 85fffb432c155747b07bb5ca2527b6d5951a9ddb → 59c49b4b68f32ec382f14795cc24abb05f8a6816

### 2026-11-14 (score 66, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “createUserSearchFilter” rewrote its description, which is the text the model reads
- [security] Tool “getAuction” rewrote its description, which is the text the model reads
- [security] Tool “getAuctionCatalogue” rewrote its description, which is the text the model reads
- [security] Tool “getProductListing” rewrote its description, which is the text the model reads
- [security] Tool “getProductListingByTitleSlug” rewrote its description, which is the text the model reads
- [security] Tool “getPublicListingSourceBySlug” rewrote its description, which is the text the model reads
- [security] Tool “getSimilarProductListings” rewrote its description, which is the text the model reads
- [security] Tool “getUserSearchFilter” rewrote its description, which is the text the model reads
- [security] Tool “getUserSearchFilters” rewrote its description, which is the text the model reads
- [security] Tool “getWatchlistProductListings” rewrote its description, which is the text the model reads
- [security] Tool “listNotifications” rewrote its description, which is the text the model reads
- [security] Tool “listSearchFilterMatches” rewrote its description, which is the text the model reads
- [security] Tool “patchWatchlistProduct” rewrote its description, which is the text the model reads
- [security] Tool “searchPublicListingSources” rewrote its description, which is the text the model reads
- [security] Tool “simpleSearchProductListings” rewrote its description, which is the text the model reads
- [security] Tool “updateUserSearchFilter” rewrote its description, which is the text the model reads
- [functional] Server version: 202aaecfaa1eee764aafdfd56c470c8deb09c720 → 85fffb432c155747b07bb5ca2527b6d5951a9ddb

### 2026-11-13 (score 66, 0)

- [security] The server rewrote its instructions, which are the text every model session reads
- [security] Tool “createUserSearchFilter” rewrote its description, which is the text the model reads
- [security] Tool “getAuction” rewrote its description, which is the text the model reads
- [security] Tool “getAuctionCatalogue” rewrote its description, which is the text the model reads
- [security] Tool “getProductListing” rewrote its description, which is the text the model reads
- [security] Tool “getProductListingByTitleSlug” rewrote its description, which is the text the model reads
- [security] Tool “getPublicListingSourceBySlug” rewrote its description, which is the text the model reads
- [security] Tool “getSimilarProductListings” rewrote its description, which is the text the model reads
- [security] Tool “getUserSearchFilter” rewrote its description, which is the text the model reads
- [security] Tool “getUserSearchFilters” rewrote its description, which is the text the model reads
- [security] Tool “getWatchlistProductListings” rewrote its description, which is the text the model reads
- [security] Tool “listNotifications” rewrote its description, which is the text the model reads
- [security] Tool “listSearchFilterMatches” rewrote its description, which is the text the model reads
- [security] Tool “patchWatchlistProduct” rewrote its description, which is the text the model reads
- [security] Tool “searchPublicListingSources” rewrote its description, which is the text the model reads
- [security] Tool “simpleSearchProductListings” rewrote its description, which is the text the model reads
- [security] Tool “updateUserSearchFilter” rewrote its description, which is the text the model reads
- [functional regression] Schema quality: 170 → 194
- [functional] Server version: 438a3dcf46e42598cdf392b6e414053aca4f0117 → 202aaecfaa1eee764aafdfd56c470c8deb09c720

## MCP tools (37)

### `addWatchlistProduct` (~98 tokens)

Add to watchlist

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.

Input parameters:

- `notifications` (boolean|null): Whether to be notified about changes to the listing (default true).
- `productListingId` (string, required): ID of the listing (`pl_…`) to add.

Output parameters:

- `created`
- `notifications` (boolean)
- `productListingId` (string)
- `state` (string)
- `updated`
- `userId` (string)

### `createUserAddress` (~101 tokens)

Add address

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.

Input parameters:

- `geography` (object, required): Where the address is: the reference release, the address text (required) and optionally country, subdivision and postal code.
- `label` (string, required): Name of the address in the address book.

Output parameters:

- `addressId` (string)
- `geography`
- `inputRevision` (integer)
- `label` (string)
- `preferred` (boolean)
- `resolution`
- `version` (integer)

### `createUserSearchFilter` (~310 tokens)

Create saved search

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. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. 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.

Input parameters:

- `acceptShippingDestination`: Optional guard confirming the shipping destination: the filter's shipping country must equal the country of the referenced address or browsing preference.
- `name` (string, required): Name of the saved search, at most 255 characters (longer names are cut off).
- `notifications` (boolean): Whether matches trigger notifications (default true).
- `search` (object, required): Criteria a listing must meet to match this saved search; the members are those of the listing search.

Output parameters:

- `created`
- `listingSources` (array): Public cards of the ListingSources that `search.listingSourceId` and `search.excludeListingSourceId` reference, one per ID, ordered by `listingSourceId`. A source referenced by both lists appears onc…
- `name` (string)
- `notifications` (boolean)
- `search`
- `state` (string)
- `updated`
- `userId` (string)
- `userSearchFilterId` (string)

### `deleteNotification` (~52 tokens)

Delete notification

Permanently delete one of the signed-in user's notifications by notificationId. Returns an empty object; an unknown ID returns NOT_FOUND.

Input parameters:

- `notificationId` (string, required): ID of the notification (`ntf_…`).

### `deleteNotifications` (~35 tokens)

Delete all notifications

Permanently delete every notification of the signed-in user, including those beyond the listed page. Takes no arguments. Returns an empty object.

### `deleteUserAddress` (~88 tokens)

Delete address

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.

Input parameters:

- `addressId` (string, required): ID of the saved address (`uaddr_…`).
- `expectedVersion` (integer, required): Current version from the last read; a stale version returns CONFLICT.

### `deleteUserSearchFilter` (~54 tokens)

Delete saved search

Permanently delete one of the signed-in user's saved searches. Returns an empty object; an unknown ID returns NOT_FOUND.

Input parameters:

- `userSearchFilterId` (string, required): ID of the saved search (`sf_…`).

### `deleteWatchlistProduct` (~69 tokens)

Remove from watchlist

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.

Input parameters:

- `productListingId` (string, required): ID of the listing (`pl_…`).

### `getAuction` (~135 tokens)

Get auction

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. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address.

Input parameters:

- `auctionId` (string, required): ID of the auction (`auc_…`).

Output parameters:

- `auctionId` (string)
- `catalogueUrl`
- `format`
- `listingSource`
- `name`
- `reportedLotCount` (integer|null)
- `reportedStatus`
- `schedule`
- `viewLink`: The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link.
- `visibleListingCount` (integer)

### `getAuctionCatalogue` (~368 tokens)

Get auction catalogue

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. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. 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.

Input parameters:

- `auctionId` (string, required): ID of the auction (`auc_…`).
- `currency` (string): Currency of the returned prices, as an ISO 4217 code (default `EUR`).
- `language` (string): Language of the returned listing text, as an ISO 639-1 code (default `en`).
- `pageSize` (integer|null): Number of lots per page, from 1 to 100 (default 21); values outside that range are clamped.
- `searchAfter` (string|null): Continuation from the previous page: its `searchAfter` object serialized as a JSON string, passed back exactly as returned.

Output parameters:

- `items` (array)
- `pageSize` (integer)
- `searchAfter`

### `getBrowsingDestination` (~54 tokens)

Get browsing destination

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.

Output parameters:

- `destination`
- `version` (integer)

### `getProductListing` (~308 tokens)

Get listing

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. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. 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.

Input parameters:

- `currency` (string): Currency of the returned prices, as an ISO 4217 code (default `EUR`).
- `language` (string): Language of the returned listing text, as an ISO 639-1 code (default `en`).
- `productListingId` (string, required): ID of the listing (`pl_…`).

Output parameters:

- `item`
- `userState`

### `getProductListingByTitleSlug` (~316 tokens)

Get listing by slug

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. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. 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.

Input parameters:

- `currency` (string): Currency of the returned prices, as an ISO 4217 code (default `EUR`).
- `language` (string): Language of the returned listing text, as an ISO 639-1 code (default `en`).
- `productListingTitleSlugId` (string, required): Slug ID of the listing, the last segment of an Aura Historia listing page URL.

Output parameters:

- `item`
- `userState`

### `getProductListingHistory` (~206 tokens)

Get listing history

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.

Input parameters:

- `currency`: 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.
- `productListingId` (string, required): ID of the listing (`pl_…`).

Output parameters:

- `result` (array)

### `getPublicListingSourceBySlug` (~164 tokens)

Get listing source

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. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address.

Input parameters:

- `listingSourceSlugId` (string, required): Slug ID of the provider, the last segment of an Aura Historia provider page URL.

Output parameters:

- `image`
- `listingSourceId` (string)
- `listingSourceSlugId` (string)
- `name` (string)
- `operator`
- `url`: The provider's own address, without Aura Historia's referral tagging; `viewLink.url` is the link meant to be shared.
- `viewLink`: The link to the provider's page that is meant to be shared with people, and whether it is an affiliate link.

### `getPublicOverview` (~51 tokens)

Get catalogue overview

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.

Output parameters:

- `asOf` (string)
- `countries` (integer)
- `languages` (integer)
- `liveObjects` (integer)
- `newObjectsLast7Days` (integer)
- `sourcesIndexed` (integer)
- `sourcesIndexedByType`

### `getSimilarProductListings` (~370 tokens)

Find similar listings

Find listings similar to one listing, identified by its productListingId. Returns up to `size` neighbours (default 20; values outside 1 to 50 are clamped) 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. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. 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.

Input parameters:

- `currency` (string): Currency of the returned prices, as an ISO 4217 code (default `EUR`).
- `language` (string): Language of the returned listing text, as an ISO 639-1 code (default `en`).
- `productListingId` (string, required): ID of the listing (`pl_…`).
- `size` (integer|null): Number of similar listings to return, from 1 to 50 (default 20); values outside that range are clamped.

### `getUserAccount` (~40 tokens)

Get account

Get the signed-in user's Aura Historia account: email, name, language, currency and measurement unit, content preference, marketing consent, subscription tier and role.

Output parameters:

- `currency`
- `email` (string)
- `firstName` (string|null)
- `language`
- `lastName` (string|null)
- `marketingEmailConsent` (boolean)
- `measurementUnit`
- `role` (string)
- `showUnassessedOrSensitiveContent` (boolean)
- `tier` (string)
- `userId` (string)

### `getUserAddress` (~55 tokens)

Get address

Get one of the signed-in user's saved addresses by addressId, with its resolved location and the attribution of the geocoding provider.

Input parameters:

- `addressId` (string, required): ID of the saved address (`uaddr_…`).

Output parameters:

- `addressId` (string)
- `geography`
- `inputRevision` (integer)
- `label` (string)
- `preferred` (boolean)
- `resolution`
- `version` (integer)

### `getUserSearchFilter` (~195 tokens)

Get saved search

Get one of the signed-in user's saved searches by userSearchFilterId, with its criteria, state and notification settings. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. 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.

Input parameters:

- `userSearchFilterId` (string, required): ID of the saved search (`sf_…`).

Output parameters:

- `created`
- `listingSources` (array): Public cards of the ListingSources that `search.listingSourceId` and `search.excludeListingSourceId` reference, one per ID, ordered by `listingSourceId`. A source referenced by both lists appears onc…
- `name` (string)
- `notifications` (boolean)
- `search`
- `state` (string)
- `updated`
- `userId` (string)
- `userSearchFilterId` (string)

### `getUserSearchFilters` (~173 tokens)

List saved searches

List all of the signed-in user's saved searches with their criteria, state and notification settings. Takes no arguments. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. 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.

Output parameters:

- `from` (integer)
- `items` (array)
- `size` (integer)
- `total` (integer|null)

### `getWatchlistProductListings` (~324 tokens)

List watchlist

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. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. 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.

Input parameters:

- `currency` (string): Currency of the returned prices, as an ISO 4217 code (default `EUR`).
- `language` (string): Language of the returned listing text, as an ISO 639-1 code (default `en`).
- `searchAfter` (string|null): Continuation from the previous page: its `searchAfter` array of [RFC 3339 watchlist creation time, listing ID] serialized as a JSON string, passed back exactly as returned.
- `size` (integer|null): Number of results per page, from 1 to 100 (default 21); values outside that range are clamped.

Output parameters:

- `items` (array)
- `searchAfter` (array|null)
- `size` (integer)
- `total` (integer|null)

### `listAuctions` (~372 tokens)

List auctions

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.

Input parameters:

- `format`: Only auctions of this format.
- `from`: Start of the schedule period for `timeRole`, as an ISO 8601 date-time with offset; give it together with `to` and `timeRole`.
- `listingSourceId`: Only auctions of this provider, as a listing source ID (`ls_…`).
- `order`: Sort direction, `asc` or `desc`.
- `pageSize` (integer|null): Number of auctions per page, from 1 to 100 (default 21); values outside that range are clamped.
- `reportedStatus`: Only auctions with this status as the provider reports it.
- `searchAfter` (string|null): Continuation from the previous page: its `searchAfter` object serialized as a JSON string, passed back exactly as returned with the same filters and sort.
- `sort`: `created` (default) orders by creation time; `scheduled` orders by the `timeRole` instant and requires `timeRole`.
- `timeRole`: Schedule instant that `from` and `to` filter on and `sort=scheduled` orders by; required with `from`/`to` and with `sort=scheduled`.
- `to`: End of the schedule period for `timeRole`, as an ISO 8601 date-time with offset; give it together with `from` and `timeRole`.

Output parameters:

- `items` (array)
- `pageSize` (integer)
- `searchAfter`

### `listNotifications` (~313 tokens)

List notifications

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. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. 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.

Input parameters:

- `language` (string): Language of the returned notification text, as an ISO 639-1 code (default `en`).
- `searchAfter` (string|null): Continuation from the previous page: its `searchAfter` array of [created time, notification ID] serialized as a JSON string, passed back exactly as returned.
- `size` (integer|null): Number of results per page, from 1 to 100 (default 21); values outside that range are clamped.

Output parameters:

- `items` (array)
- `searchAfter` (array)
- `size` (integer)

### `listSearchFilterMatches` (~363 tokens)

List saved search matches

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. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. 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.

Input parameters:

- `currency` (string): Currency of the returned prices, as an ISO 4217 code (default `EUR`).
- `language` (string): Language of the returned listing text, as an ISO 639-1 code (default `en`).
- `searchAfter`: Continuation from the previous page: its `searchAfter` array of [RFC 3339 match time, listing ID], passed back exactly as returned.
- `size` (integer|null): Number of results per page, from 1 to 100 (default 21); values outside that range are clamped.
- `userSearchFilterId` (string, required): ID of the saved search (`sf_…`).

Output parameters:

- `items` (array)
- `searchAfter`
- `size` (integer)
- `total` (integer|null)

### `listUserAddresses` (~97 tokens)

List addresses

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.

Input parameters:

- `after`: Continuation from the previous page: its `next` address ID, passed back exactly as returned.
- `limit` (integer|null): Number of addresses per page, from 1 to 100 (default 25).

Output parameters:

- `items` (array)
- `next`

### `patchWatchlistProduct` (~334 tokens)

Update watchlist entry

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. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. 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.

Input parameters:

- `currency` (string): Currency of the returned prices, as an ISO 4217 code (default `EUR`).
- `language` (string): Language of the returned listing text, as an ISO 639-1 code (default `en`).
- `notifications` (boolean): Whether to be notified about changes to the listing; omit to keep the current setting, null is rejected.
- `productListingId` (string, required): ID of the listing (`pl_…`).
- `state` (string): `ACTIVE` or `INACTIVE_BY_USER`; omit to keep the current state, null is rejected.

Output parameters:

- `item`
- `userState`

### `searchPublicListingSources` (~250 tokens)

Search listing sources

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. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address.

Input parameters:

- `query` (string|null): Optional source-name text; omission or whitespace browses, insufficient text returns no matches.
- `searchAfter` (string|null): Continuation from the previous page: pass back exactly as returned, with the same `query` and `size`.
- `size` (integer): Number of providers per page, from 1 to 50 (default 21); continuations are bound to the query and page size.

Output parameters:

- `items` (array)
- `searchAfter` (string|null)
- `size` (integer)

### `setBrowsingDestination` (~102 tokens)

Set browsing destination

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.

Input parameters:

- `destination` (object, required): The browsing destination to store, replacing the current one.
- `expectedVersion` (integer, required): Current version from the last read; a stale version returns CONFLICT.

Output parameters:

- `destination`
- `version` (integer)

### `simpleSearchProductListings` (~983 tokens)

Search listings

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. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. 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.

Input parameters:

- `auctionId` (array): Only listings that belong to these auctions, given as auction IDs (`auc_…`).
- `availability`: Only listings in one of these exact availability states; combined with `orderability`, a listing must satisfy both.
- `created` (object): Range on the listing's creation time, as ISO 8601 date-times with offset; both bounds inclusive.
- `currency` (string): Currency prices are returned in and `price` is interpreted in, as an ISO 4217 code (default `EUR`).
- `enhancedSearchDescription` (string|null): Optional natural-language description that refines the ranking of `productQuery` results. Only effective together with `productQuery`; on its own it returns unranked, unrelated results.
- `excludeListingSourceId` (array): Leave out listings from these providers, given as listing source IDs (`ls_…`).
- `excludeProductListingId` (array): Listing IDs (`pl_…`) to leave out of the results.
- `geography`: Where listings are located, by country, subdivision or distance from a point; every member given must hold.
- `includeUnspecifiedAvailability` (boolean|null): Also include listings that state no availability (default false).
- `language` (string): Language of the returned listing text and of the titles `productQuery` is matched against, as an ISO 639-1 code (default `en`).
- `listingSourceId` (array): Only listings from these providers, given as listing source IDs (`ls_…`).
- `lotBiddingOpens` (object): Range on the time bidding on the lot opens, as ISO 8601 date-times with offset; `min` inclusive, `max` exclusive.
- `lotScheduledCloses` (object): Range on the lot's scheduled closing time, as ISO 8601 date-times with offset; `min` inclusive, `max` exclusive.
- `order`: Sort direction, `asc` or `desc` (default `desc`); only valid together with `sort`.
- `orderability`: Only listings whose availability falls into one of these orderability groups; combined with `availability`, a listing must satisfy both.
- `price`: Price range in the request's `currency`, with both bounds inclusive. Amounts are always integers in the currency's minor unit when one exists (EUR `119199` = €1,191.99; USD in cents). For currencies…
- `productQuery` (array): Keyword phrases matched against listing titles; every word of one phrase must match, and a listing matches when any phrase does.
- `searchAfter`: Continuation from the previous page: pass back exactly as returned by the previous page, with the same filters and sort.
- `shipping`: Only listings whose advertised shipping terms meet these conditions for a destination country; every member given must hold.
- `size` (integer|null): Number of results per page, from 1 to 100 (default 21); values outside that range are clamped.
- `sort`: Field to order results by: `score` (relevance), `updated` or `created`; cannot be combined with `geography.distanceOrder`.
- `updated` (object): Range on the listing's last update time, as ISO 8601 date-times with offset; both bounds inclusive.

Output parameters:

- `items` (array)
- `searchAfter`
- `size` (integer)
- `total` (integer|null)

### `updateAllNotificationsSeen` (~54 tokens)

Mark all notifications seen or unseen

Mark every notification of the signed-in user as seen or unseen, including those beyond the listed page. Returns an empty object.

Input parameters:

- `seen` (boolean, required): `true` marks as seen, `false` as unseen.

### `updateNotificationSeen` (~74 tokens)

Mark notification seen or unseen

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.

Input parameters:

- `notificationId` (string, required): ID of the notification (`ntf_…`).
- `seen` (boolean, required): `true` marks as seen, `false` as unseen.

### `updateNotificationsSeen` (~92 tokens)

Mark selected notifications seen or unseen

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.

Input parameters:

- `notificationIds` (array, required): IDs (`ntf_…`) of the notifications to update; unknown or foreign IDs are ignored and an empty list is rejected.
- `seen` (boolean, required): `true` marks as seen, `false` as unseen.

### `updateSearchFilterMatchFeedback` (~193 tokens)

Rate saved search match

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. 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.

Input parameters:

- `feedback` (boolean|null): Feedback on the match, `true` or `false`; omit to keep the stored value, null clears it.
- `productListingId` (string, required): ID of the listing (`pl_…`).
- `userSearchFilterId` (string, required): ID of the saved search (`sf_…`).

Output parameters:

- `created` (string)
- `feedback` (boolean|null)
- `originEventId` (string)
- `productListingId` (string)
- `shippingMatchValuation`
- `updated` (string)
- `userId` (string)
- `userSearchFilterId` (string)
- `userSearchFilterName` (string|null)

### `updateUserAccount` (~198 tokens)

Update account

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.

Input parameters:

- `currency`: Preferred currency, as an ISO 4217 code; omit to keep it, null clears it.
- `firstName` (string|null): First name; omit to keep it, null clears it.
- `language`: Preferred language, as an ISO 639-1 code; omit to keep it, null clears it.
- `lastName` (string|null): Last name; omit to keep it, null clears it.
- `measurementUnit`: Preferred measurement unit system; omit to keep it, null clears it.
- `showUnassessedOrSensitiveContent` (boolean): Whether listings with unassessed or sensitive content are shown; omit to keep it, null is rejected.

Output parameters:

- `currency`
- `email` (string)
- `firstName` (string|null)
- `language`
- `lastName` (string|null)
- `marketingEmailConsent` (boolean)
- `measurementUnit`
- `role` (string)
- `showUnassessedOrSensitiveContent` (boolean)
- `tier` (string)
- `userId` (string)

### `updateUserAddress` (~121 tokens)

Update address

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.

Input parameters:

- `addressId` (string, required): ID of the saved address (`uaddr_…`).
- `expectedVersion` (integer, required): Current version from the last read; a stale version returns CONFLICT.
- `geography` (object, required): New location of the address, replacing the current one entirely.
- `label` (string, required): New name of the address, replacing the current one.

Output parameters:

- `addressId` (string)
- `geography`
- `inputRevision` (integer)
- `label` (string)
- `preferred` (boolean)
- `resolution`
- `version` (integer)

### `updateUserSearchFilter` (~401 tokens)

Update saved search

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. Each result's `viewLink.url` is the provider link meant to be shared with people: it carries Aura Historia's referral tagging, which is lost when its query parameters are changed. `viewLink.affiliate` is `true` when that link is an affiliate link, which can earn Aura Historia a commission. `url` is the provider's untagged address. 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.

Input parameters:

- `acceptShippingDestination`: Optional guard confirming the shipping destination: the filter's shipping country must equal the country of the referenced address or browsing preference.
- `name` (string|null): New name, at most 255 characters (longer names are cut off); omit to keep the current name.
- `notifications` (boolean|null): Whether matches trigger notifications; omit to keep the current setting.
- `search`: Partial criteria: omitted members stay unchanged, null clears `enhancedSearchDescription`, `auctionId`, `price`, the date ranges and the availability query, and `availability`, `orderability` and `in…
- `state`: `ACTIVE` or `INACTIVE_BY_USER`; omit to keep the current state, and activating a filter checks all its criteria against the current tier.
- `userSearchFilterId` (string, required): ID of the saved search (`sf_…`).

Output parameters:

- `created`
- `listingSources` (array): Public cards of the ListingSources that `search.listingSourceId` and `search.excludeListingSourceId` reference, one per ID, ordered by `listingSourceId`. A source referenced by both lists appears onc…
- `name` (string)
- `notifications` (boolean)
- `search`
- `state` (string)
- `updated`
- `userId` (string)
- `userSearchFilterId` (string)

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/com-aura-historia-mcp/v1#diagnostics

## Score history

- 2026-11-21: 69
- 2026-11-20: 69
- 2026-11-19: 68
- 2026-11-18: 68
- 2026-11-17: 67
- 2026-11-16: 67
- 2026-11-15: 67
- 2026-11-14: 66
- 2026-11-13: 66
- 2026-11-12: 66
- 2026-11-11: 65
- 2026-11-10: 63
- 2026-11-09: 62
- 2026-11-08: 62

## Common questions

### What is the Aura Historia MCP server?

Aura Historia is an MCP server listed in the public MCP registry as com.aura-historia/mcp. Search art and antiques from dealers and auction houses; manage your watchlist and saved searches. This page covers its hosted endpoint (https://mcp.aura-historia.com/v1).

### Is the Aura Historia MCP server safe to use?

Aura Historia scores 69 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the Aura Historia MCP server expose?

Aura Historia exposes 37 tools: addWatchlistProduct, createUserAddress, createUserSearchFilter, deleteNotification, deleteNotifications, and 32 more. Their descriptions and schemas cost roughly 7,513 tokens of context every time the server is loaded.

### Does the Aura Historia MCP server require authentication?

No. We connected to Aura Historia without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the Aura Historia MCP server still maintained?

Aura Historia is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What did VerifyMCP test on the Aura Historia MCP server?

VerifyMCP ran 13 checks on Aura Historia, covering TLS certificate, Authorization, HTTPS, HSTS header and 9 more. Supply Chain Security and Provenance & Transparency do not apply to a hosted endpoint, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.

## Links

- Remote endpoint: https://mcp.aura-historia.com/v1
- Repository: https://github.com/aura-historia/backend
- Website: https://aura-historia.com/
- Changelog RSS feed: https://verifymcp.io/servers/com-aura-historia-mcp/v1.xml
- Changelog JSON feed: https://verifymcp.io/servers/com-aura-historia-mcp/v1/changelog.json
- Trust report (JSON): https://verifymcp.io/servers/com-aura-historia-mcp/v1.json
- HTML version of this page: https://verifymcp.io/servers/com-aura-historia-mcp/v1
