# Agent Instructions — vuk.bg

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

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


## Product Categories

- [Воблери](https://www.vuk.bg/vobleri)

- [Силикони](https://www.vuk.bg/silikoni)

- [DUO International](https://www.vuk.bg/vobleri/duo-international)

- [Tide Minnow Slim](https://www.vuk.bg/vobleri/duo-international/tide-minnow-slim)

- [DUO International](https://www.vuk.bg/silikoni/duo-international)

- [Realis](https://www.vuk.bg/silikoni/duo-international/realis)

- [Tetra Works](https://www.vuk.bg/silikoni/duo-international/tetra-works)

- [ValkeIN](https://www.vuk.bg/vobleri/valkein)

- [Horizard](https://www.vuk.bg/vobleri/valkein/horizard)

- [Riola](https://www.vuk.bg/vobleri/valkein/c-riola)

- [Li-Worm](https://www.vuk.bg/vobleri/valkein/c-li-worm)

- [Spearhead Ryuki](https://www.vuk.bg/vobleri/duo-international/ryuki)

- [Rough Trail](https://www.vuk.bg/vobleri/duo-international/rough-trail)

- [Realis](https://www.vuk.bg/vobleri/duo-international/realis)

- [Tide Minnow](https://www.vuk.bg/vobleri/duo-international/tide-minnow)

- [Джигове / Пилкери](https://www.vuk.bg/jigove-pilkeri)

- [DUO International](https://www.vuk.bg/jigove-pilkeri/duo-international)

- [Drag Metal](https://www.vuk.bg/jigove-pilkeri/duo-international/drag-metal)

- [Tetra Works](https://www.vuk.bg/jigove-pilkeri/duo-international/tetra-works)

- [Tetra Works](https://www.vuk.bg/vobleri/duo-international/tetra-works)

- [Куки](https://www.vuk.bg/kuki)

- [Fanatik](https://www.vuk.bg/kuki/fanatik)

- [Fanatik](https://www.vuk.bg/silikoni/fanatik)

- [X-Larva](https://www.vuk.bg/silikoni/fanatik/x-larva)

- [Larva Lux](https://www.vuk.bg/silikoni/fanatik/larva-lux)

- [Larva](https://www.vuk.bg/silikoni/fanatik/larva)

- [Dagger](https://www.vuk.bg/silikoni/fanatik/dagger)

- [Mik Maus](https://www.vuk.bg/silikoni/fanatik/mik-maus)

- [Boxer](https://www.vuk.bg/silikoni/fanatik/boxer)

- [Classic](https://www.vuk.bg/silikoni/fanatik/classic)

- [Lobster](https://www.vuk.bg/silikoni/fanatik/lobster)

- [Viper](https://www.vuk.bg/silikoni/fanatik/viper)

- [Джиг глави](https://www.vuk.bg/jig-glavi)

- [Fanatik](https://www.vuk.bg/jig-glavi/fanatik)

- [Въдици](https://www.vuk.bg/vydici)

- [GAD](https://www.vuk.bg/vydici/gad)

- [Chaser](https://www.vuk.bg/vydici/gad/chaser)

- [Gancho](https://www.vuk.bg/vydici/gad/gancho)

- [Fair](https://www.vuk.bg/vydici/gad/fair)

- [DUO International](https://www.vuk.bg/kuki/duo-international)

- [Pontoon21](https://www.vuk.bg/silikoni/pontoon21)

- [Awaruna](https://www.vuk.bg/silikoni/pontoon21/awaruna)

- [Ratta](https://www.vuk.bg/silikoni/pontoon21/ratta)

- [Блесни / Клатушки](https://www.vuk.bg/blesni-i-klatushki)

- [ValkeIN](https://www.vuk.bg/blesni-i-klatushki/valkein)

- [Beach Walker](https://www.vuk.bg/vobleri/duo-international/beach-walker)

- [Bay RUF](https://www.vuk.bg/vobleri/duo-international/bay-ruf)

- [Terrif](https://www.vuk.bg/vobleri/duo-international/terrif)

- [Аксесоари](https://www.vuk.bg/ekipirovka/aksesoari)

- [Mechanic Lures](https://www.vuk.bg/vobleri/mechanic-lures)



## Store Policies