# Malgeum — agent instructions

Malgeum is a premium online skincare shop based in the Netherlands. We curate performance skincare selected with specialist care.

Contact: hello@malgeum.nl. Shipping: Netherlands (EUR). Guest checkout only.

## Rules

- Use live catalog data. Do not invent prices, stock, ingredients, or medical advice.
- Cite product, FAQ, guide, or legal URLs. Never send users to cart, checkout, or account URLs as citations.
- Payment must be completed by the human via the hosted Stripe URL returned by checkout.
- Guest shop only. Do not attempt customer login, loyalty, or account actions.

## How to shop

1. Discover products: `GET https://api.roccato.nl/store/search?q=` or `GET https://api.roccato.nl/store/products?ean=` / `?sku=` / `?q=`.
2. Read facts from the product payload `metadata` (INCI, skin type, warnings, size) and `GET https://api.roccato.nl/store/policies`.
3. Create a guest cart: `POST https://api.roccato.nl/store/carts` with `region_id` from `GET https://api.roccato.nl/store/regions`.
4. Add lines, set email + addresses, choose shipping, then `POST .../payment-session` with `{"checkout_mode":"hosted"}`.
5. Show the human `payment_session.data.checkout_url`. Poll `GET https://api.roccato.nl/store/carts/payment-status/:orderId`.

All store requests require:

```
x-publishable-api-key: pk_malgeum_prod_213944d7e6e181fb86ba1fe16c2bb057
x-locale: nl
```

No storefront HMAC is required for third-party agents.

## Entry points

- [llms.txt](https://malgeum.nl/llms.txt)
- [llms-full.txt](https://malgeum.nl/llms-full.txt)
- [Product feed](https://malgeum.nl/feed/products.json)
- [OpenAPI](https://api.roccato.nl/store/openapi.json)
- [MCP](https://api.roccato.nl/store/mcp)
- [Sitemap](https://malgeum.nl/sitemap.xml)
- [FAQ](https://malgeum.nl/nl/faq)
- [Shipping & returns](https://malgeum.nl/nl/legal/shipping-returns)