# Aura Historia

> Aura Historia is a global discovery platform for art, antiques and design objects. It indexes public listings from dealers, auction houses, shops and marketplaces, so collectors and market professionals can search across providers, languages and currencies in one place, then follow objects with watchlists, saved searches and notifications. Structured access is available through a public MCP server and a REST API.

Key facts for agents:

- Aura Historia is a discovery service, not a marketplace. Each listing links to the provider that offers it; purchases, bids and payment happen with that provider.
- To link someone to a provider's page, use the result's `viewUrl` exactly as returned, not `url`. `viewUrl` carries Aura Historia's referral tagging, so do not remove, replace or add query parameters.
- Listing facts come from the provider. Confirm authenticity, provenance, condition, price and availability with the provider before acting on them. Converted prices are for orientation; the provider's source price is authoritative.
- "Provider" means a dealer, auction house, shop or marketplace. The API and MCP tools call a provider a "listing source" (`listingSourceId`).
- Prefer the MCP server or the REST API over scraping web pages: both return complete, structured data, and the public catalogue needs no account.
- Website pages carry a language prefix: `de`, `en`, `es`, `fr` or `it`. A path without a prefix redirects to a preferred language.
- Listing search: `https://aura-historia.com/{lang}/search?q={query}`, optionally with `sortField` (`RELEVANCE`, `CREATION_DATE`, `UPDATE_DATE`) and `sortOrder` (`ASC`, `DESC`). Provider search: `https://aura-historia.com/{lang}/search/shops?q={query}`.
- Listing pages use `https://aura-historia.com/{lang}/products/{productListingTitleSlugId}`; provider pages use `https://aura-historia.com/{lang}/shops/{shopSlugId}`.
- Account, partner and admin areas (`/{lang}/me/`, `/{lang}/partners/`, `/{lang}/admin/`) require sign-in and are not public content.

## MCP server

- [MCP endpoint](https://mcp.aura-historia.com/v1): Remote MCP server over Streamable HTTP (JSON-RPC via POST). Tool discovery and the public catalogue tools (listing search and detail, price history, similar listings, auctions and auction catalogues, provider search, locations, catalogue overview) need no credentials. Tools for the signed-in user's own account, watchlist, saved searches and notifications need an OAuth access token with the matching scopes.
- [MCP documentation](https://docs.api.aura-historia.com/mcp.md): Supported protocol revisions, the tool catalogue and required scopes, continuation and pagination rules, error codes and request limits. Tool names match the REST operation IDs.
- [MCP protected resource metadata](https://mcp.aura-historia.com/.well-known/oauth-protected-resource/v1): RFC 9728 metadata naming the authorization server `https://api.aura-historia.com`. Send `resource=https://mcp.aura-historia.com/v1` in authorization and token requests.

## REST API

- [API reference](https://docs.api.aura-historia.com/): Interactive reference for `https://api.aura-historia.com/v1`, covering listings, auctions, providers, personalization, partner workflows, identity and OAuth. Public catalogue reads need no credentials.
- [OpenAPI contract](https://docs.api.aura-historia.com/swagger.yaml): Complete OpenAPI 3.0 document. It is large (about 1 MB); search it for the operation you need instead of loading it whole.
- [OAuth guide](https://docs.api.aura-historia.com/oauth.md): Authorization code flow with mandatory S256 PKCE, resource indicators, consent and revocation. An agent signs in as a public client identified by the HTTPS URL of its Client ID Metadata Document, without registration, and receives one-hour access tokens and rotating refresh tokens; other clients are registered by Aura Historia and receive non-expiring tokens. There is no dynamic client registration.
- [OAuth authorization server metadata](https://api.aura-historia.com/.well-known/oauth-authorization-server): RFC 8414 metadata with the issuer, endpoints and supported scopes.
- [API changelog](https://docs.api.aura-historia.com/CHANGELOG.md): REST contract and user-visible behaviour changes, newest first.

## Agent discovery

- [MCP server card](https://aura-historia.com/.well-known/mcp/server-card.json): MCP Server Card (SEP-2127) with the MCP endpoint, its transport and protocol versions, and its protected resource metadata.
- [API catalog](https://aura-historia.com/.well-known/api-catalog): RFC 9727 linkset that lists the REST API and the MCP server with their descriptions, documentation and status endpoints.
- [Agent skills index](https://aura-historia.com/.well-known/agent-skills/index.json): Agent Skills Discovery index of the published `SKILL.md` instructions, each with the `sha256` digest of its exact bytes.
- [auth.md](https://aura-historia.com/auth.md): How agents authenticate: anonymous access, signing a user in with OAuth, and personal access tokens.

## Partner integrations

- [Partner program](https://aura-historia.com/en/partner-program): How dealers and auction houses apply to join, with every application reviewed by our team, and once accepted list their inventory on Aura Historia, free of charge and without sales commission, through WooCommerce, Shopify or the API.
- [Custom API integration guide](https://aura-historia.com/en/partner-program/custom-integration): Asynchronous (recommended) and synchronous batches that create, update, upsert and withdraw a provider's listings, the admission report and idempotency key, and the asking-price format.
- [Partner product API (OpenAPI)](https://aura-historia.com/partner-products.openapi.json): The asynchronous and synchronous listing-batch operations (POST, PATCH, PUT, DELETE), extracted from the full contract.
- [WooCommerce plugin](https://wordpress.org/plugins/aura-historia-partner-connect/): Aura Historia Partner Connect for WordPress and WooCommerce.
- [Shopify app](https://apps.shopify.com/aura-historia-partner-connect): Aura Historia app on the Shopify App Store; syncs listings from a Shopify store.

## Website

- [Home](https://aura-historia.com/en): Overview of the platform, plans and frequently asked questions.
- [Search listings](https://aura-historia.com/en/search): Full-text search across all indexed listings.
- [Search providers](https://aura-historia.com/en/search/shops): Find dealers, auction houses and shops by name.
- [About us](https://aura-historia.com/en/about-us): What Aura Historia does, how it differs from auction aggregators, price databases and marketplaces, who uses it, the team behind it, and frequently asked questions.
- [Use Aura Historia with AI assistants](https://aura-historia.com/en/ai-agents): How people connect Aura Historia to Claude or ChatGPT with the MCP server address, what works without an account, what signing in allows and for how long, and how to disconnect. Apps for Gemini, Grok and Muse are in development.
- [Aura Historia compared with 1stDibs](https://aura-historia.com/en/compare/1stdibs): The 1stDibs curated marketplace of approved sellers compared with a search across dealers, auction houses and marketplaces: curation and vetting, object range, auctions, price history and similar objects, monitoring and languages, with sourced 2025 annual-report figures.
- [Aura Historia compared with art price databases](https://aura-historia.com/en/compare/art-price-databases): Price databases such as Artnet, WorthPoint, MutualArt and Artprice, which record what objects sold for, compared with a search across dealers, auction houses and marketplaces that shows what is offered now: past results versus current offers, alerts and valuation, with each database's figures attributed to its own announcement and year.
- [Aura Historia compared with Artsy](https://aura-historia.com/en/compare/artsy): The Artsy marketplace compared with a search across dealers, auction houses and marketplaces: object types, languages and monitoring, with the 2026 Artsy and Artnet announcement.
- [Aura Historia compared with Barnebys](https://aura-historia.com/en/compare/barnebys): Source coverage, multilingual search and alerts compared, with the current status of Barnebys.
- [Aura Historia compared with Catawiki](https://aura-historia.com/en/compare/catawiki): The Catawiki marketplace of weekly online auctions compared with a search across auction houses, dealers and marketplaces: curation and buyer protection as Catawiki describes them, weekly auctions, source types, dealer stock, category focus and languages, sourced to Catawiki's Terms of Use and Buyer Terms of March 2024.
- [Aura Historia compared with eBay](https://aura-historia.com/en/compare/ebay): The eBay marketplace across many categories compared with a search across dealers, auction houses and marketplaces built for art, antiques and design objects: reach and buyer protection as eBay's annual report for 2025 describes them, category focus, provider types and languages, with monitoring across providers.
- [Aura Historia compared with Invaluable](https://aura-historia.com/en/compare/invaluable): The Invaluable auction marketplace compared with a search across auction houses, dealers and marketplaces: bidding, provider types, monitoring, price data and languages, with the October 2026 acquisition announcement.
- [Aura Historia compared with LiveAuctioneers](https://aura-historia.com/en/compare/liveauctioneers): The LiveAuctioneers auction platform, with The Saleroom and Lot-tissimo from the same group, compared with a search across auction houses, dealers and marketplaces: live and timed bidding, self-described bidder audience, provider types, monitoring and languages, with the group's 2025 annual-report ownership details.

## Optional

- [Terms and conditions](https://aura-historia.com/en/terms-and-conditions): Terms of use, including paid services and payment processing.
- [Privacy policy](https://aura-historia.com/en/privacy): How personal data is processed.
- [Imprint](https://aura-historia.com/en/imprint): Legal operator information.
- [MCP documentation on GitHub](https://github.com/aura-historia/backend/blob/develop/docs/mcp.md): Source of the MCP documentation, with links to the tool manifests and tests.
- [Sitemap](https://aura-historia.com/sitemap.xml): All indexable static pages in every language.