# Agent Instructions — Somavedic Uk

This document describes how AI agents can interact with Somavedic Uk's online store at https://somavedic-uk.myshopify.com.

## Commerce Protocol (UCP)

This store implements the [Universal Commerce Protocol](https://ucp.dev) for agent-driven commerce.

### Discovery
GET https://somavedic-uk.myshopify.com/.well-known/ucp

Returns the store's UCP merchant profile: supported versions, service endpoints, capabilities, and payment handlers.

### MCP Endpoint
POST https://somavedic-uk.myshopify.com/api/ucp/mcp
Content-Type: application/json

Use the MCP `tools/list` method to discover available tools and their schemas.

### Typical Agent Flow
1. Discover — `GET /.well-known/ucp`
2. Search — find products matching the buyer's intent
3. Cart — add items
4. Checkout — start the purchase flow
5. Fulfill — set shipping address/method
6. Complete — finalize (buyer must approve payment)

### Important Rules
- Checkout requires human approval. Agents must not complete payment without explicit buyer consent.
- Respect rate limits. Back off on 429.
- Use buyer context — pass `context.address_country` and `context.currency` for accurate pricing.

## Enhanced Capabilities (Bot It)

Bot It extends Shopify's native MCP with AI-enriched catalog search, brand context, and recommendation tools tailored to this store.

### Bot It MCP Endpoint
POST https://mcp.botitai.com/197b214f6c27fe7d3c197feca289672c38dd9cc9b189eab547465c4d5418ef71

Access Bot It's specialized tools for product discovery, cart management, and store information.

### Available Tools
- **searchProducts** — Search the catalog with AI-enriched brand context
- **getProductDetails** — Get full details for a product including variants, pricing, and availability
- **getStoreContext** — Get brand information, shipping/return policies, support channels, and FAQs
- **addToCart** — Add a product variant to the shopping cart
- **getCart** — Get current cart contents
- **getCollectionDetails** — Get a collection including narrative, merchandising notes, and product list
- **getProductRecommendations** — Get recommended complementary products for a given product
- **getPromotions** — Get active promotions and available discount codes
- **getSizeChart** — Get size chart, fit notes, and measurements for a product

### Bot It Endpoints
- Brand context: GET https://somavedic-uk.myshopify.com/apps/botit/brand-context
- Active promotions: GET https://somavedic-uk.myshopify.com/apps/botit/promotions
- Enriched search: GET https://somavedic-uk.myshopify.com/apps/botit/search?q={query}

### Buyer Context
Bot It honors `context.address_country`, `context.currency`, and `context.locale` to provide localized product availability, pricing, and recommendations.

## About Somavedic Uk

Somavedic creates high-end, handcrafted devices designed to harmonize home and office environments by mitigating the negative effects of electromagnetic fields (EMF) and structuring water.

## Policies

**Shipping.** Standard delivery 4-5 business days.
Express delivery 2-3 business days.

**Returns.** Our refund policy lasts 60 days. If it's been more than 60 days since your purchase, unfortunately, we can't offer you a refund or exchange.

You will be responsible for covering the shipping costs to return an unwanted item. Please note that shipping costs and Monk Protect delivery protection are non-refundable. To qualify for a refund, the item must be sent to us within 60 calendar days from the date of purchase. The product and its accessories (USB cable, power adapter, adapter tips) must be fully functional, in their original packaging, and placed in an additional package to ensure adequate protection against damage during the return process.

If the Somavedic device is returned without the original packaging or accessories (USB cable, power adapter, adapter tips), the refund amount will be reduced by 50 GBP.

Learn more at: https://www.somavedic.uk/policies/refund-policy

## Read-Only Browsing (No Authentication Required)

For agents that only need to read store data without transacting:

### Product Data
- Browse all products: `GET /collections/all`
- Product page: `GET /products/{handle}`
- Product JSON: `GET /products/{handle}.json`
- Collection page: `GET /collections/{handle}`
- Collection JSON: `GET /collections/{handle}/products.json`
- Search: `GET /search?q={query}&type=product`

### Store Metadata
- Sitemap: `GET /sitemap.xml`
- Agent discovery: this document (`/agents.md`) is the canonical agent-facing description of the store.

## Contact

For support inquiries, contact **support@somavedic.uk**.

## Platform

This store is built on [Shopify](https://www.shopify.com), the commerce platform powering millions of stores worldwide.