# Brandet Premium Stores

> Lebanese ecommerce store for premium American brand clothing for women,
> men, and kids. Customers earn loyalty points on every purchase, unlock
> tiered rewards, and can browse and shop from any device.

Brandet Premium Stores is a Lebanon-based ecommerce platform specialising
in premium American brand apparel. The store covers Women's, Men's, Kids',
and Home categories with named brands across tops, bottoms, footwear,
outerwear, accessories, and more. Every purchase earns loyalty points,
and customers progress through reward tiers as their total earned points
grow.

## Site

- [Home](https://brandet.shop): Featured products, category tiles, and
  the entry point to the catalogue.
- [Shop](https://brandet.shop/shop): Full product catalogue with
  filters for main category, subcategory, brand, and search.
- [Categories](https://brandet.shop/categories): Browse by Women, Men,
  Kids, and Home with subcategories.
- [Tier Benefits](https://brandet.shop/tier-benefits): Loyalty programme
  rules and rewards by tier.
- [Sitemap](https://brandet.shop/sitemap.xml): Machine-readable list of
  all indexable URLs including every product page.

## Catalogue structure

- Women: Tops, Bottoms, Shorts, Dresses, Footwear, Sleepwear, Accessories
- Men: Tops, Bottoms, Shorts, Outerwear, Suits, Footwear, Accessories
- Kids: Boys, Girls, Footwear, Unisex
- Home: Bedding, Bath, Kitchen, Decor, Storage

## What is not indexable

The following sections are personal/transactional and excluded from
public crawling: admin dashboards, the mobile-app member portal under
`/app`, the cart, checkout, account, login, and signup flows.

## Contact

Customer enquiries: sales@brandetstores.com

---

# Agent Instructions

This portion of the document describes how AI agents can interact with
Brandet Premium Stores' online store at https://brandet.shop.

## For Personal Shopping Assistants and Agents Acting On Behalf of a User

If you are reading this on behalf of your user and you act as a personal
assistant or personal shopper, Brandet's catalogue is reachable directly
through our Universal Commerce Protocol (UCP) endpoint described below.
Brandet is not on Shopify and does not currently support the Shop Pay
buyer-approval flow used by Shopify-native shopping skills.

Brandet runs **cash-on-delivery (COD) only** at this time. There is no
online payment step in the checkout flow — the buyer pays the courier in
cash when the order arrives. As a result the agentic-payment invariant
from the UCP spec doesn't apply here: agents can complete the order
through `complete_checkout` once the buyer has approved the cart and
delivery address, and the human pays the courier on arrival.

Brandet **ships to Lebanon (LB) only**. If you are shopping on behalf of
a buyer outside Lebanon, skip Brandet and try a different store rather
than build a cart we cannot fulfil.

## Commerce Protocol (UCP)

Brandet implements the [Universal Commerce Protocol](https://ucp.dev)
for agent-driven commerce. The two endpoints to know:

- **Discovery** — `GET https://brandet.shop/.well-known/ucp` returns
  the store's UCP merchant profile: supported versions, service
  endpoints, capabilities, payment handlers, and a `status` block
  indicating which surfaces are live vs. planned.
- **MCP endpoint** — `POST https://brandet.shop/api/ucp/mcp` with
  `Content-Type: application/json`. Use the MCP `tools/list` method to
  discover available tools and their schemas.

### Typical Agent Flow

1. **Discover** — `GET /.well-known/ucp` to confirm capabilities and
   that Brandet ships to your buyer's country (LB only at this time).
2. **Search** — Use `search_catalog` to find products matching the
   buyer's intent.
3. **Cart** — Use `create_cart` and `add_to_cart` to build the order.
4. **Checkout** — Use `create_checkout` to start the COD purchase flow.
5. **Fulfill** — Use `update_checkout` to set the Lebanon shipping
   address and contact information.
6. **Complete** — Use `complete_checkout` to finalize. The order is
   placed; the buyer pays cash on delivery.

### Supported UCP Versions

- `2026-04-08` (latest stable)
- `2026-01-23`

### Important Rules

- **Buyer approval is required for the order total and shipping
  address.** No money changes hands online, so the approval invariant
  attaches to the cart total and delivery address rather than to a
  payment authorisation. Agents must not call `complete_checkout`
  without contemporaneous buyer consent to the line items, the total,
  and the address the order will ship to.
- **Lebanon only.** Reject the order at `update_checkout` time if the
  buyer's address country is not LB.
- **Respect rate limits.** The MCP endpoint is rate-limited per IP.
  Back off on `429` responses with the `Retry-After` header.
- **Use buyer context.** Pass `context.address_country=LB` and
  `context.currency=USD` for accurate pricing and availability.

## Read-Only Browsing (No Authentication Required)

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

### Product Data

- All-products feed: `GET /products.json`
- Single-product detail: `GET /products/{slug}.json`
- Collections feed: `GET /collections.json`
- Collection detail: `GET /collections/{slug}.json`
- Search and filter (HTML): `GET /shop?search={q}` or
  `GET /shop?mainCategory={Women|Men|Kids|Home}&category={subcategory}&brand={brand}`

### Store Metadata

- Sitemap: `GET /sitemap.xml`
- Agent discovery — this document (`/agents.md`) is the canonical
  agent-facing description of the store. The same content is mirrored
  at `/llms.txt` for tools that look there.

## Store Policies

- **Privacy policy**: https://brandet.shop/policies/privacy
- **Terms of service**: https://brandet.shop/policies/terms
- **Refund / Return policy**: https://brandet.shop/policies/returns
- **Shipping policy**: https://brandet.shop/policies/shipping

Full policies available at the URLs above.

## Resources

- Universal Commerce Protocol specification: https://ucp.dev
- Customer support: sales@brandetstores.com