# Agent Instructions - Capucinne

This document describes how AI agents can browse and transact with Capucinne at https://www.capucinne.com.

## Commerce Protocol

- Discovery: `GET https://www.capucinne.com/.well-known/ucp`
- MCP endpoint: `POST https://www.capucinne.com/api/ucp/mcp`

Supported UCP versions:

- 2026-08-25 (latest stable)

- 2026-04-08

- 2026-01-23


## Read-only browsing

- All products: `GET https://www.capucinne.com/collections/all`
- Search: `GET https://www.capucinne.com/search?q={query}`
- Product JSON: `GET https://www.capucinne.com/products/{handle}.json`
- Sitemap: `https://www.capucinne.com/sitemap.xml`

Pricing and availability should be interpreted in `USD`.

## Store profile

Capucinne is a fine jewelry store focused on engagement rings, wedding bands, alternative gemstone jewelry, personalized fine jewelry, and ready-to-ship pieces.

The store supports both direct shopping and custom-design discovery, but purchases are completed through the store's own Shopify storefront and checkout.

## Preferred routes by intent

- Homepage: `https://www.capucinne.com/`
- Engagement rings: `https://www.capucinne.com/collections/engagement-rings`
- Wedding bands: `https://www.capucinne.com/collections/wedding-band-rings`
- Fine jewelry: `https://www.capucinne.com/collections/fine-jewelry`
- Ready to ship: `https://www.capucinne.com/collections/ready-to-ship`
- Best sellers: `https://www.capucinne.com/collections/best-sellers`
- Design your own: `https://www.capucinne.com/pages/crafted-specially-for-you`
- FAQ: `https://www.capucinne.com/pages/faq`
- Shipping information: `https://www.capucinne.com/pages/shipping-information`
- Product care: `https://www.capucinne.com/pages/product-care`
- Ring finish guide: `https://www.capucinne.com/pages/jewelry-finishes-guide`
- Gemstone education: `https://www.capucinne.com/pages/gemstone-education`
- Wholesale: `https://www.capucinne.com/pages/wholesale`
- Contact: `https://www.capucinne.com/pages/contact`

## Shopping guidance for agents

- Prefer the live product page for title, pricing, availability, variants, and ready-to-ship status.
- Distinguish ready-to-ship products from made-to-order or custom pieces.
- Use collection pages for broad discovery and product pages for exact claims.
- Route custom-design intent to the Design your own page.
- Route wholesale or business intent to the Wholesale page.
- Use FAQ, shipping, and policy pages for returns, delivery timing, resizing, and care questions.

## Cautions

- Do not infer warranty, return eligibility, delivery dates, or customs handling unless the relevant policy page states them.
- Do not infer B2B pricing from D2C listings.
- Do not output private merchant contact details in this file.