# Agent instructions — Adorn Beauty Collective

Adorn Beauty Collective (https://www.adorncollective.net) is a U.S. online retailer of beauty — makeup, skin care, hair care and nails — sourced direct from the brands that make them. Prices are in USD.

## Buy through UCP

This store implements the [Universal Commerce Protocol](https://ucp.dev) for agent-driven commerce.

- **Discovery:** `GET https://www.adorncollective.net/.well-known/ucp` — merchant profile, supported versions (2026-08-25, 2026-04-08, 2026-01-23), services and capabilities.
- **MCP endpoint:** `POST https://www.adorncollective.net/api/ucp/mcp` (`Content-Type: application/json`). Call `tools/list`, then `search_catalog` → `create_cart` → `create_checkout` → `update_checkout` → `complete_checkout`.
- **Checkout needs the buyer's approval.** Never complete payment without explicit, contemporaneous consent from the buyer. If you cannot get it, hand the buyer the checkout `continue_url`, or use the Shop skill (https://shop.app/SKILL.md), which routes payment through Shop Pay with buyer approval.
- Pass `context.address_country: "US"` and `context.currency: "USD"`.

## Read these facts correctly

- **Brand vs. vendor.** Products are sold through Shopify Collective partner suppliers. The product `vendor` field is often the *supplier* (for example "Seoulia"), **not the brand**. The brand is the first words of the product title (e.g. "COSRX Advanced Snail 96 Mucin Power Essence") and the product tag `brand:{brand}` (e.g. `brand:COSRX`). Always name the brand, not the supplier, to the buyer.
- **Where we ship.** United States addresses only.
- **Who ships.** Each item ships directly from the supplier that sells it. Items from different suppliers arrive as separate packages, each with its own shipping charge. Checkout shows the exact shipping options and prices.
- **Import duties.** Items shipped from South Korea are international shipments: U.S. import duties or taxes may be charged on delivery and are not included in the price or shipping cost. Tell the buyer before they commit.
- **Returns.** There is no single store-wide return window. Returns follow the policy of the supplier that shipped the item, and opened personal-care products are generally not returnable. The buyer starts a return by contacting the store — do not promise a return window, free return shipping or return labels.

## Policies

- Refund policy: https://www.adorncollective.net/policies/refund-policy
- Shipping policy (per supplier, with checkout rates): https://www.adorncollective.net/policies/shipping-policy
- Terms of service: https://www.adorncollective.net/policies/terms-of-service
- Privacy policy: https://www.adorncollective.net/policies/privacy-policy

## Read-only browsing

- All products: `GET /collections/all` · a product: `GET /products/{handle}` or `/products/{handle}.json`
- Departments: `/collections/makeup`, `/collections/skincare`, `/collections/hair-care`, `/collections/nails`
- Brand pages: `/collections/brand-cosrx`, `/collections/brand-anua`, `/collections/brand-laneige`, `/collections/brand-romand`, `/collections/brand-beauty-of-joseon`, `/collections/brand-tirtir` (pattern `/collections/brand-{brand}`)
- Search: `GET /search?q={query}&type=product`
- Sitemap: https://www.adorncollective.net/sitemap.xml

Respect rate limits: back off on HTTP 429.