# Agent Instructions — Cricket's Crystals

This document describes how AI agents can interact with the online store at https://cricketscrystals.com.

## Commerce Protocol (UCP)

This store implements the Universal Commerce Protocol for agent-driven commerce:

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

### Supported UCP versions

- 2026-08-25 (latest stable)

- 2026-04-08

- 2026-01-23


## Read-only browsing

- All products: `GET /collections/all`
- Product JSON: `GET /products/{handle}.json`
- Sitemap: https://cricketscrystals.com/sitemap.xml

Pricing and availability are returned in USD.

## About this store

- Cricket's Crystals is a small US shop of handmade crystal jewelry (necklaces, earrings, bracelets, rings,
  keychains), natural crystal pieces (towers, points, palm stones, clusters, spheres, carvings, wands, pendulums) and
  hanging décor, run by its owner since 2017.
- Every piece is one of a kind. A product groups the pieces of one design; each option under "Choose your crystal"
  (#1, #2, ...) is ONE specific physical piece with its own photos, and the buyer receives exactly the piece pictured
  for the option they choose. Rings show their size in the option ("#3D - Size 10").
- Every order ships within 1 business day from within the US by USPS, so customers get their pieces quickly.
  Shipping is calculated at checkout from the order's weight. US shipping only.
- The shop is organized so shoppers can browse crystals by type, by zodiac sign, by element and by chakra (collections
  below and filters on every collection page).
- Policies: /policies/shipping-policy, /policies/refund-policy, /policies/privacy-policy, /policies/terms-of-service.
  Questions: /pages/contact.

## Collections

- All crystals: /collections/all-crystals
- Necklaces: /collections/necklaces
- Earrings: /collections/earrings
- Bracelets: /collections/bracelets
- Rings: /collections/rings
- Keychains: /collections/keychains
- Towers & Points: /collections/towers-and-points
- Palm Stones: /collections/palm-stones
- Clusters: /collections/clusters
- Spheres: /collections/spheres
- Flames: /collections/flames
- Hearts: /collections/hearts
- Carvings: /collections/carvings
- Raw Stones: /collections/raw-stones
- Wands: /collections/wands
- Pendulums: /collections/pendulums
- Hanging Décor: /collections/hanging-decor
- Tapestries: /collections/tapestries
- By chakra: [Root Chakra](/collections/root-chakra-crystals), [Sacral Chakra](/collections/sacral-chakra-crystals), [Solar Plexus Chakra](/collections/solar-plexus-chakra-crystals), [Heart Chakra](/collections/heart-chakra-crystals), [Throat Chakra](/collections/throat-chakra-crystals), [Third Eye Chakra](/collections/third-eye-chakra-crystals), [Crown Chakra](/collections/crown-chakra-crystals), [All 7 Chakras](/collections/all-7-chakras)
- By element: [Fire](/collections/fire-element-crystals), [Earth](/collections/earth-element-crystals), [Air](/collections/air-element-crystals), [Water](/collections/water-element-crystals), [Spirit](/collections/spirit-element-crystals)
- By zodiac sign: [Aries](/collections/aries-crystals), [Taurus](/collections/taurus-crystals), [Gemini](/collections/gemini-crystals), [Cancer](/collections/cancer-crystals), [Leo](/collections/leo-crystals), [Virgo](/collections/virgo-crystals), [Libra](/collections/libra-crystals), [Scorpio](/collections/scorpio-crystals), [Sagittarius](/collections/sagittarius-crystals), [Capricorn](/collections/capricorn-crystals), [Aquarius](/collections/aquarius-crystals), [Pisces](/collections/pisces-crystals)