# Agent Instructions — Vitateka

Vitateka OÜ is an Estonian online retailer of dietary supplements, cosmetics and healthy food.
Around 6,100 products, priced in EUR, storefronts in 7 languages, delivery across Estonia,
Latvia, Lithuania, Finland and Poland.

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

Store URL: https://vitateka.ee/fi

## Commerce Protocol (UCP)
- Discovery — GET https://vitateka.ee/fi/.well-known/ucp  (merchant profile: versions, capabilities)
- MCP endpoint — POST https://vitateka.ee/fi/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://vitateka.ee/fi/agent/products.json?q={query}&page={n}
- Single product    — GET https://vitateka.ee/fi/agent/products/{url_key}.json
- Category products — GET https://vitateka.ee/fi/agent/collections/{url_key}/products.json
- Sitemap           — GET https://vitateka.ee/fi/sitemap.xml
- Agent discovery   — /agents.md (canonical) and /llms.txt (mirror), plus /.well-known/ucp

## Main Product Categories

- [Ravintolisät](https://vitateka.ee/fi/catalog/supplements)
- [Kosmetiikka](https://vitateka.ee/fi/catalog/cosmetics)
- [Erityishoito](https://vitateka.ee/fi/catalog/healing-cosmetics)
- [Terveellinen ruoka](https://vitateka.ee/fi/catalog/healthy-food)
- [Tarvikkeet terveydelle ja kotiin](https://vitateka.ee/fi/catalog/health-equipment)
- [Alennukset](https://vitateka.ee/fi/discounts)

## Product Questions and Answers

- [Tietopankki](https://vitateka.ee/fi/knowledge-base) — a curated question-and-answer library about the
  products in this catalogue (composition, dosage, contraindications, usage). Answers are
  tied to specific products and are a good source when a shopper asks how something is used.

## Store Policies

- [Toimitus](https://vitateka.ee/fi/delivery)

- [Tuotteen palautus](https://vitateka.ee/fi/returning-goods)

- [Myyntiehdot](https://vitateka.ee/fi/terms_of_sale)

- [Evästekäytäntö](https://vitateka.ee/fi/privacy-policy-cookie-restriction-mode)

- [Tietosuojakäytäntö](https://vitateka.ee/fi/rules-for-processing-personal-data)