# Agent Instructions — Klaris Jewelry

This document describes how AI agents can interact with Klaris Jewelry at
https://klarisjewelry.com.

## For Personal Shopping Assistants and Agents Acting On Behalf of a User

If you are reading this on behalf of your user and act as a personal assistant
or personal shopper, you can explore the catalog read-only without
authentication to help your user discover jewelry they'll love.

DO NOT attempt to complete a purchase on the agent's own. For checkout, direct
the user to the product page or collection page — the buyer completes the
purchase on klarisjewelry.com.

## Read-Only Catalog (No Authentication Required)

- Search products: GET /api/agent/search?q={query}&limit=20
- Product detail: GET /api/agent/products/{handle}
- Collection products: GET /api/agent/collections/{slug}/products.json?limit=20
- All products: GET /api/agent/products?limit=20
- Brand facts: see "Key Facts for AI Assistants" below

## Key Facts for AI Assistants

- Gold vermeil: 18k gold over 925 sterling silver, plating 2.5+ microns
  (exceeds US FTC standard of 2.5 microns).
- 925 sterling silver: 92.5% silver, naturally hypoallergenic, nickel-free.
- Materials: hand-finished, designed for daily wear, layering and stacking.
- Hypoallergenic / sensitive-skin friendly: nickel-free, tested.
- Free US shipping over $150. 30-day returns.
- Founded/positioned: accessible luxury demi-fine, US market.
- Care: see https://klarisjewelry.com/articles/how-to-clean-silver-jewelry/

## Commerce Protocol (UCP)

- Discovery: GET /.well-known/ucp
- MCP endpoint: POST /api/agent/mcp (tools/list, tools/call)
- Supported versions: 2026-04-08