# Agent Instructions — ThatHealthySkin

This document describes how AI agents can interact with ThatHealthySkin's online store at https://thathealthyskin.storeza.ai/.

## Commerce Protocol (UCP)

This store supports agent-driven commerce via a cash-on-delivery profile of the Universal Commerce Protocol (UCP). Endpoints:

- **Discovery** — `GET https://thathealthyskin.storeza.ai/.well-known/ucp` returns the store's UCP profile: capabilities, endpoints, and payment policy.
- **MCP endpoint** — `POST https://thathealthyskin.storeza.ai/api/ucp/mcp` with `Content-Type: application/json`. Use the MCP `tools/list` method to discover tools and schemas, and `tools/call` to invoke them.

### Payment: Cash on Delivery only

This store does **not** take card or agent payments. Orders are paid in cash on delivery. Placing a checkout creates a COD order; the buyer pays the courier in person.

### Typical Agent Flow

1. **Discover** — `GET /.well-known/ucp` to confirm capabilities.
2. **Search** — `search_catalog` to find products matching the buyer's intent.
3. **Cart** — `create_cart` to price the desired items (server recomputes totals).
4. **Checkout** — `create_checkout` to preview the order and total.
5. **Complete** — `complete_checkout` to place the cash-on-delivery order (buyer must approve).
6. **Track** — `get_order_status` with the order number + buyer phone or email.

### Important Rules

- **Checkout requires human approval.** Do not call `complete_checkout` without the buyer's explicit consent. You must collect the buyer's name, phone, and delivery address, confirm the items and total, then set `buyer_approved: true`.
- **No payment is handled.** This is cash on delivery; never request card details.
- **Respect rate limits.** The MCP endpoint is rate-limited per IP. Back off on `429` responses with exponential delay.
- **Use buyer context.** Pass the delivery `city`/`address` for accurate fulfillment.

### Available MCP Tools

- `search_catalog` — Search this store's public products by free-text query and/or category. Returns matching products with price, currency, availability, URL and image.
- `get_product` — Get full details for one product by id or slug, including size/color options.
- `create_cart` — Build a priced cart from items. Validates availability and recomputes totals server-side. Returns line items, subtotal, delivery fee and total. Stateless — pass the returned cart to create_checkout.
- `create_checkout` — Preview a cash-on-delivery checkout: validates items + buyer details and returns an order summary and total to confirm. Does NOT place the order. No payment is taken.
- `complete_checkout` — Place a cash-on-delivery order. The buyer must have explicitly approved this purchase. Requires buyer name, phone and delivery address. Returns the order number and status. Payment is cash on delivery — the buyer pays the courier; no card or agent payment is involved.
- `get_order_status` — Look up the status of an order by order number. Requires the buyer's phone OR email on the order for verification.

## Read-Only Browsing

For agents that only need to read store data without transacting:

- Store homepage: `GET https://thathealthyskin.storeza.ai/`
- Product page: `GET https://thathealthyskin.storeza.ai/product/{slug}`
- Product feed (JSON): `GET https://thathealthyskin.storeza.ai/feed.json`
- Sitemap: `GET https://thathealthyskin.storeza.ai/sitemap.xml`
- AI summary: `GET https://thathealthyskin.storeza.ai/llms.txt`

## Categories

- Serums: https://thathealthyskin.storeza.ai/?category=c8c2c432-dfdc-4838-a8c1-988f11ae0701
- Skincare: https://thathealthyskin.storeza.ai/?category=3fd899d3-441b-4db7-b007-ffde9e11f9b7
- Anti-Aging: https://thathealthyskin.storeza.ai/?category=a24df58c-5e30-44a8-ab98-82849e08154c

## Products (snapshot)

- Retinol Firming Eye Cream & Anti-Wrinkle Repair (30ml) — 32.99 USD — In stock — https://thathealthyskin.storeza.ai/product/bruh
- Niacinamide Ginseng Pore Minimizing Cream — 15.99 USD — In stock — https://thathealthyskin.storeza.ai/product/niacinamide-ginseng-pore-minimizing-cream
- Retinol Eye Firming & Wrinkle Smoothing — 39.99 USD — In stock — https://thathealthyskin.storeza.ai/product/retinol-eye-firming-wrinkle-smoothing
- Retinol Firming Eye Cream & Anti-Wrinkle Repair (50ml) — 68.99 USD — In stock — https://thathealthyskin.storeza.ai/product/retinol-firming-eye-cream-anti-wrinkle-repair
- Niacinamide Acne & Texture Repair Serum — 19.99 USD — In stock — https://thathealthyskin.storeza.ai/product/niacinamide-acne-texture-repair-serum
- Niacinamide Skin Clearing & Oil Control Serum — 17.99 USD — In stock — https://thathealthyskin.storeza.ai/product/niacinamide-skin-clearing-oil-control-serum
- Niacinamide Dark Spot & Pore Refining Serum — 17.99 USD — In stock — https://thathealthyskin.storeza.ai/product/niacinamide-dark-spot-pore-refining-serum
- Niacinamide Brightening & Acne Control Serum — 17.99 USD — In stock — https://thathealthyskin.storeza.ai/product/niacinamide-brightening-acne-control-serum

## Platform

This store is built on Storeza (https://storeza.ai), an AI store builder for small businesses. Storeza stores are cash-on-delivery and expose a UCP profile per store for agent-driven commerce.