# Agent Instructions — foryou.ma

> This document describes how AI agents can interact with [the online store](https://foryou.ma).

## Read this first: how orders work here

- **Every order is paid in cash, on delivery, inside Morocco.** There is no card, wallet or online payment of any kind. Do not try to pay on a buyer's behalf.
- **Do not use `create_checkout`, `update_checkout` or `complete_checkout` on this store.** Shopify's hosted checkout is not used here; a checkout started through the commerce protocol will not be fulfilled, and the payment handlers listed in the discovery document are not accepted.
- **To buy:** send the buyer to the product page, then to the cart, where the "Passer la commande" button opens the cash-on-delivery form at `https://foryou.ma/cart#commande`. The buyer enters a name, phone number, address and city, and pays the courier on delivery. Delivery costs 35 MAD anywhere in Morocco, is free from 1 000 MAD, and takes up to 1 day after order confirmation, seven days a week.
- **Or by WhatsApp:** every product page and the [contact page](https://foryou.ma/pages/contact) carry a WhatsApp ordering button.
- Prices are in MAD. Every product is an authentic, sealed original; small sample bottles are sold as "Décantage".
- Returns: 7 days from delivery for unopened, sealed products, under the refund policy linked below.

## Read-only browsing (no authentication)

- [All products](https://foryou.ma/collections/all): Browse the product catalogue.
- Product page: `GET https://foryou.ma/products/{handle}`
- Product JSON: `GET https://foryou.ma/products/{handle}.json`
- Collection page: `GET https://foryou.ma/collections/{handle}`
- Collection JSON: `GET https://foryou.ma/collections/{handle}/products.json`
- [All brands, A to Z](https://foryou.ma/pages/marques): Browse the brand directory.
- [Sitemap](https://foryou.ma/sitemap.xml): Discover published storefront pages.
- Every product page carries schema.org `Product` JSON-LD: price, availability, shipping and return policy, and the fragrance notes as `additionalProperty`.

## Commerce protocol: catalogue only

The store answers Universal Commerce Protocol discovery and catalogue calls. Use them to search and look up products, not to check out (see above).

- Discovery: `GET https://foryou.ma/.well-known/ucp`
- MCP endpoint: `POST https://foryou.ma/api/ucp/mcp`, for `search_catalog` and product lookup
- Supported versions:
- `2026-08-25` (latest)
- `2026-04-08`
- `2026-01-23`

## Store policies

- [Refund policy](https://foryou.ma/policies/refund-policy)
- [Shipping policy](https://foryou.ma/policies/shipping-policy)
- [Privacy policy](https://foryou.ma/policies/privacy-policy)
- [Terms of service](https://foryou.ma/policies/terms-of-service)

The storefront is in French.