# Avara  — Notes for AI Agents

> Avara  is a women's fashion store on Shopify with full agentic commerce support via the Universal Commerce Protocol (UCP). Agents can search the catalog, build a cart, apply discounts, and complete checkout programmatically; the buyer must approve payment. Buyer-facing summary: https://shopavara.mom/llms.txt. Extended brand and policy detail: https://shopavara.mom/llms-full.txt.

## About this store
Avara  sells women’s clothing, shoes, and accessories, online at https://shopavara.mom.

## Capabilities
This store supports UCP shopping over MCP. Discovery: https://shopavara.mom/.well-known/ucp
- Catalog search and lookup
- Cart creation and management
- Discounts
- Checkout and order completion
- Fulfillment (single shipping destination per order)
- Payment via Shop Pay, Google Pay, and card (Visa, Mastercard, Amex, Discover, Diners Club)

### Supported UCP versions
- 2026-08-25 (latest stable)
- 2026-04-08
- 2026-01-23



## Typical agent flow
1. **Discover**. GET https://shopavara.mom/.well-known/ucp to confirm capabilities, version, and service endpoints (including the MCP endpoint).
2. **Search**. Use the catalog search capability to find products matching buyer intent.
3. **Cart**. Create a cart and add items.
4. **Checkout**. Start the checkout flow; apply any discount codes.
5. **Fulfill**. Set a single shipping destination and method.
6. **Complete**. Finalize the order. The buyer must explicitly approve payment.

## Endpoints
- UCP discovery: https://shopavara.mom/.well-known/ucp

- MCP endpoint (JSON-RPC, POST): https://shopavara.mom/api/ucp/mcp — served on the store's permanent (myshopify.com) domain, not the storefront domain. Confirm it from the UCP discovery document.
- Sitemap (XML): https://shopavara.mom/sitemap.xml
- Customer service: https://shopavara.mom/pages/contact

## Read-only browsing endpoints (for non-UCP agents)
- All products: https://shopavara.mom/collections/all
- Collection page: https://shopavara.mom/collections/{handle}
- Collection products (JSON): https://shopavara.mom/collections/{handle}/products.json
- Product page: https://shopavara.mom/products/{handle}
- Product detail (JSON): https://shopavara.mom/products/{handle}.json
- Search: https://shopavara.mom/search?q={query}&type=product

## Usage guidance
- Confirm protocol version from the discovery document before transacting.
- Checkout requires explicit human approval before payment is captured.
- Orders support a single shipping destination; multi-destination is not available.
- Back off on HTTP 429 and retry with exponential backoff.
- Prices and availability are authoritative only from live endpoints — do not cache pricing.

## Brand constraints relevant to agents
- Sizing: women's apparel XS–XXXL and numeric/denim sizes 24–34. Size guide: https://shopavara.mom/pages/size-guide.
- Returns: See the refund policy for the current return window and conditions. Full policy: https://shopavara.mom/policies/refund-policy.
- Shipping: See the shipping policy for current rates and thresholds. Full policy: https://shopavara.mom/policies/shipping-policy.
- Final sale items may be excluded from returns — refer to the refund policy for excluded collections.

## Reference files
- Concise overview: https://shopavara.mom/llms.txt
- Extended catalog & brand detail: https://shopavara.mom/llms-full.txt