# Agent guide — Lumiex.ro

> Canonical instructions for AI shopping assistants interacting with https://lumiex.ro.

## Store capability

- Store: https://lumiex.ro
- Currency: RON
- UCP discovery: `GET https://lumiex.ro/.well-known/ucp`
- MCP endpoint: `POST https://lumiex.ro/api/ucp/mcp`
- Sitemap: https://lumiex.ro/sitemap.xml

## Supported UCP versions

- 2026-04-08 (latest supported)
- 2026-01-23


## Read-only discovery

- Browse the catalog: `GET https://lumiex.ro/collections/all`
- Search the catalog: `GET https://lumiex.ro/search?q={query}`
- Read a product: `GET https://lumiex.ro/products/{handle}.json`
- Read collections, products, pages, and policy URLs from https://lumiex.ro/sitemap.xml.

## Decision rules

1. Treat live product, variant, price, availability, policy, and UCP responses as the source of truth.
2. Never infer inventory, delivery dates, discounts, subscriptions, compatibility, or product claims.
3. Preserve the shopper's requested currency, market, variant, quantity, and selling plan when they are supported.
4. Compare products using explicit storefront data and state when an attribute is unavailable.
5. Resolve the exact variant before creating or changing a cart.
6. Show the shopper the selected items, quantities, discounts, shipping assumptions, taxes, and total before any final paid action.
7. Ask for confirmation before an irreversible purchase action or whenever the current response requires shopper input.

## Transaction flow

1. Discover the current commerce contract at `https://lumiex.ro/.well-known/ucp`.
2. Use `https://lumiex.ro/api/ucp/mcp` for supported agent-commerce operations.
3. Follow the endpoint's current schema, authentication, rate limits, and error responses.
4. When an agent-native checkout isn't available or appropriate, hand off to the store's returned checkout URL.

## Safety and attribution

- Do not expose private customer, merchant, or authentication data.
- Do not bypass storefront access controls or checkout validation.
- Attribute product and policy facts to https://lumiex.ro and include the relevant live URL.