# Agent Instructions — Amorati

This document describes how AI agents can interact with the Amorati storefront at https://amorati.be.

## Store

- Canonical storefront: https://amorati.be/be/nl
- Store origin: https://amorati.be
- Sitemap index: https://amorati.be/sitemap_index.xml
- Agent discovery sitemap: https://amorati.be/sitemap_agentic_discovery.xml
- This document: https://amorati.be/agents.md

## Locales

Amorati uses locale prefixes for public pages:

- `/be/nl` — Dutch (Belgium)
- `/be/en` — English (Belgium)
- `/be/fr` — French (Belgium)
- `/es/es` — Spanish (Spain)
- `/nl/nl` — Dutch (Netherlands)

Use `/be/nl` as the default market when a request does not specify a market. Handles can vary by language; use the locale-specific sitemaps.

## Catalog

- Home: https://amorati.be/be/nl
- Skincare collection: https://amorati.be/be/nl/collections/huidverzorging
- Product pages: `https://amorati.be/{country}/{language}/products/{handle}`
- Collection pages: `https://amorati.be/{country}/{language}/collections/{handle}`
- Policy pages: `https://amorati.be/{country}/{language}/policies/{handle}`
- Product and collection URLs are listed in the locale-specific sitemaps.

The cart is transient storefront state. Checkout is completed through the Shopify checkout URL returned by the storefront, and payment must never be completed without explicit buyer approval.

## Commerce Protocol (UCP)

The store exposes the Universal Commerce Protocol through these site-owned endpoints:

- Discovery: `GET https://amorati.be/.well-known/ucp`
- MCP: `POST https://amorati.be/api/ucp/mcp` with `Content-Type: application/json`

Use the discovery document to determine supported versions, capabilities, payment handlers, and service endpoints. Use MCP `tools/list` to discover the available tools and their schemas.

Respect rate limits and pass buyer context such as country and currency when supported. Treat checkout completion as a user-authorized action.

## Policies

- Privacy: https://amorati.be/be/nl/policies/privacy-policy
- Terms of service: https://amorati.be/be/nl/policies/terms-of-service
- Refund policy: https://amorati.be/be/nl/policies/refund-policy
- Shipping policy: https://amorati.be/be/nl/policies/shipping-policy
- Legal notice: https://amorati.be/be/nl/policies/legal-notice
- Contact information: https://amorati.be/be/nl/policies/contact-information

## Agent rules

1. Prefer the site-owned endpoints and sitemaps above over scraping or guessing URLs.
2. Do not place an order, start a payment, or complete checkout without explicit buyer consent.
3. Use the buyer’s selected locale, country, and currency when making catalog or checkout requests.
4. Do not expose or request customer account credentials in agent instructions or logs.
5. Back off and retry when an endpoint returns a rate-limit response.
