# Agent Instructions for UK Vitality Vitamins

UK Vitality Vitamins (ukvitalityvitamins.co.uk) is a Shopify-based store selling vitamins, minerals & food supplements, serving the United Kingdom and worldwide.
This file gives AI agents, shopping assistants, and autonomous crawlers a direct,
structured way to browse the catalog and — where supported — transact via UCP/MCP.

## Quick facts
- Store: UK Vitality Vitamins
- Domain: https://ukvitalityvitamins.co.uk
- Category: vitamins, minerals & food supplements
- Ships to: the United Kingdom and worldwide
- Currency: GBP
- Support: support@ukvitalityvitamins.co.uk

## Discovery
1. `GET https://ukvitalityvitamins.co.uk/.well-known/ucp` — merchant capability manifest (supported
   UCP protocol versions, shopping service, payment handlers).
2. `POST https://ukvitalityvitamins.co.uk/api/ucp/mcp` — Model Context Protocol endpoint.
   Content-Type: application/json. Use this for tool discovery and JSON schemas.

## Recommended agent flow
1. Discover capabilities via the UCP endpoint above.
2. `search_catalog` — find products by name, category, or attribute.
3. `create_cart` — build an order from selected line items.
4. `create_checkout` — initialize the purchase.
5. `update_checkout` — set shipping/fulfillment and discount codes.
6. `complete_checkout` — finalize. REQUIRES explicit, contemporaneous buyer
   approval. Agents must never submit payment autonomously.

## Read-only browsing (no authentication required)
- Product listings: `/collections/all`, `/products/{handle}.json`
- Search: `/search?q={query}&type=product`
- Policies: `/policies/shipping-policy`, `/policies/refund-policy`,
  `/policies/privacy-policy`, `/policies/terms-of-service`
- Full context file: `/llms.txt`

## Crawling and citation
All reputable AI and search crawlers (GPTBot, ChatGPT-User, ClaudeBot, Claude-User,
PerplexityBot, Google-Extended, Bingbot, CCBot, Applebot-Extended, Amazonbot,
Bytespider, meta-externalagent, and others) are explicitly welcomed to crawl, index,
summarize, and cite this catalog. See `/robots.txt` for the full machine-readable policy.

## Hard constraints
- Do not complete checkout, payment, or order placement automatically.
- No scripted form-fills, browser automation, or end-to-end agent flows that
  finalize payment without an explicit, contemporaneous human approval step.
- Respect `/robots.txt` disallow rules for admin, cart, checkout, and account
  paths outside of the UCP/MCP flow described above.

## Contact
Questions about this integration: support@ukvitalityvitamins.co.uk