# Agent Instructions — Easy Weigh

This document describes how AI agents can interact with Easy Weigh's online store at https://easy-weigh.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://easy-weigh.storeza.ai/.well-known/ucp` returns the store's UCP profile: capabilities, endpoints, and payment policy.
- **MCP endpoint** — `POST https://easy-weigh.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://easy-weigh.storeza.ai/`
- Product page: `GET https://easy-weigh.storeza.ai/product/{slug}`
- Product feed (JSON): `GET https://easy-weigh.storeza.ai/feed.json`
- Sitemap: `GET https://easy-weigh.storeza.ai/sitemap.xml`
- AI summary: `GET https://easy-weigh.storeza.ai/llms.txt`

## Categories

- Kitchen Tools: https://easy-weigh.storeza.ai/?category=2c1a5158-38de-4081-b4bf-17cf151c182d
- Scales: https://easy-weigh.storeza.ai/?category=d30fdb27-da59-41bf-bdbd-88f40b1c133e
- Measuring Spoons: https://easy-weigh.storeza.ai/?category=32bbfcc9-f548-417f-8c57-3cd36ef9ec07

## Products (snapshot)

- Digital Measuring Spoon — 33.99 USD — In stock — https://easy-weigh.storeza.ai/product/digital-measuring-spoon-f2s1h
- Digital Measuring Spoon — 33.99 USD — In stock — https://easy-weigh.storeza.ai/product/digital-measuring-spoon-athrl
- Digital Measuring Spoon — 33.99 USD — In stock — https://easy-weigh.storeza.ai/product/digital-measuring-spoon

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