# Agent Instructions — Main Website Store

This store supports AI-driven catalogue discovery over the Universal Commerce Protocol (UCP).

## Commerce Protocol (UCP)
- Discovery — GET https://www.lafermina.com/.well-known/ucp  (merchant profile: versions, capabilities)
- MCP endpoint — POST https://www.lafermina.com/agent/mcp  (Content-Type: application/json)

### Typical agent flow (v1)
1. Discover  — GET /.well-known/ucp
2. Search    — search_catalog
3. Inspect   — get_product / lookup_catalog
4. Cart      — create_cart, then give the shopper the returned continue_url to review and complete
(The agent builds the cart; the shopper completes checkout in the browser — checkout requires human approval.)

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

### Rules
- Pass context.address_country and context.currency for accurate pricing/availability.
- Respect rate limits; back off on 429.
- Checkout requires human approval. Do not complete payment without explicit buyer consent.

## Read-Only Browsing (No Authentication Required)
The store serves these JSON endpoints itself (no auth, no GraphQL dependency):
- Products / search — GET https://www.lafermina.com/agent/products.json?q={query}&page={n}
- Single product    — GET https://www.lafermina.com/agent/products/{url_key}.json
- Category products — GET https://www.lafermina.com/agent/collections/{url_key}/products.json
- Sitemap           — GET https://www.lafermina.com/sitemap.xml
- Agent discovery   — /agents.md (canonical) and /llms.txt (mirror), plus /.well-known/ucp

## Product Categories

- [Fornituras](https://www.lafermina.com/fornituras.html)

- [Cierres](https://www.lafermina.com/fornituras/cierres.html)

- [Zamak y Metal](https://www.lafermina.com/zamak-y-metal.html)

- [Colgantes](https://www.lafermina.com/zamak-y-metal/colgantes.html)

- [Anillas](https://www.lafermina.com/fornituras/anillas.html)

- [Herramientas](https://www.lafermina.com/herramientas.html)

- [Charms](https://www.lafermina.com/zamak-y-metal/charms.html)

- [Bolas](https://www.lafermina.com/zamak-y-metal/bolas.html)

- [Hilos, Cintas y Cuero](https://www.lafermina.com/cuero-hilos.html)

- [Cuquillo](https://www.lafermina.com/cuero-hilos/cuquillo.html)

- [Terminales](https://www.lafermina.com/fornituras/terminales.html)

- [Abalorios](https://www.lafermina.com/abalorios.html)

- [Resina](https://www.lafermina.com/abalorios/resina.html)

- [Cabujones](https://www.lafermina.com/abalorios/resina/cabujones.html)

- [Calabrotes](https://www.lafermina.com/zamak-y-metal/calabrotes.html)

- [Anillos](https://www.lafermina.com/zamak-y-metal/anillos.html)

- [Pulseras](https://www.lafermina.com/zamak-y-metal/pulseras.html)

- [Pendientes](https://www.lafermina.com/fornituras/pendientes.html)

- [Pasadores](https://www.lafermina.com/zamak-y-metal/pasadores.html)

- [Cascarillas](https://www.lafermina.com/fornituras/cascarillas.html)

- [Madreperla](https://www.lafermina.com/abalorios/madreperla.html)

- [Cristal](https://www.lafermina.com/abalorios/cristal.html)

- [Cristal Checo](https://www.lafermina.com/abalorios/cristal-checo.html)

- [Antelina](https://www.lafermina.com/cuero-hilos/antelina.html)

- [Tiras y cintas de cuero](https://www.lafermina.com/cuero-hilos/cuero.html)

- [Cuero 2 mm](https://www.lafermina.com/cuero-hilos/cuero/cuero-2-mm.html)

- [Cuero 3 mm](https://www.lafermina.com/cuero-hilos/cuero/cuero-3-mm.html)

- [Piel plana](https://www.lafermina.com/cuero-hilos/piel-plana.html)

- [Cuero trenzado](https://www.lafermina.com/cuero-hilos/cuero/cuero-trenzado.html)

- [Bases de anillos](https://www.lafermina.com/fornituras/bases-de-anillos.html)

- [Bastones](https://www.lafermina.com/fornituras/bastones.html)

- [Especiales](https://www.lafermina.com/abalorios/especiales.html)

- [Cadenas](https://www.lafermina.com/cadenas.html)

- [Nylon y silicona](https://www.lafermina.com/cuero-hilos/nylon-y-silicona.html)

- [Entrepiezas](https://www.lafermina.com/zamak-y-metal/entrepiezas.html)

- [Kits](https://www.lafermina.com/kits.html)

- [Imperdibles](https://www.lafermina.com/fornituras/imperdibles.html)

- [Para grabar](https://www.lafermina.com/para-grabar.html)

- [Zamak y otros metales](https://www.lafermina.com/para-grabar/zamak-y-otros-metales.html)

- [Algodón](https://www.lafermina.com/cuero-hilos/algodon.html)

- [Cordones elásticos](https://www.lafermina.com/cuero-hilos/cordon-elastico.html)

- [Pasadores](https://www.lafermina.com/abalorios/resina/pasadores.html)

- [Cintas](https://www.lafermina.com/cuero-hilos/cinta.html)

- [Pompones](https://www.lafermina.com/cuero-hilos/pompones.html)

- [Cuero 1,5 mm](https://www.lafermina.com/cuero-hilos/cuero/cuero-1.html)

- [Cordones de hilo](https://www.lafermina.com/cuero-hilos/cordon-hilo.html)

- [Cordón hilo 5 mm](https://www.lafermina.com/cuero-hilos/cordon-hilo/cordon-hilo-5-mm.html)

- [Hilos de macramé](https://www.lafermina.com/cuero-hilos/hilo-macrame.html)

- [Piedras semipreciosas](https://www.lafermina.com/abalorios/piedras-semipreciosas.html)

- [Cordón hilo 10 mm](https://www.lafermina.com/cuero-hilos/cordon-hilo/cordon-hilo-10-mm.html)

## Store Policies