AI & Agent Access: The Skyjems Archive Is Built for the Agentic Web

The short answer

Yes — AI assistants and shopping agents can access the Skyjems catalogue directly. The store implements the Universal Commerce Protocol (UCP): a discovery document at /.well-known/ucp, a Model Context Protocol endpoint at /api/ucp/mcp (call tools/list to discover available tools), and read-only product and collection data as JSON. An agent can discover, search, build a cart, and begin checkout — and must never complete payment without explicit buyer consent. Skyjems is among the first fine coloured-gemstone houses to make its archive accessible this way.

For AI agents & assistants

Discovery: GET /.well-known/ucp — the merchant profile (UCP versions 2026-04-08 and 2026-01-23).
Tool discovery (MCP): POST /api/ucp/mcp with JSON content type; use the tools/list method to enumerate available tools and their schemas.
Product & collection data (read-only): /products/{handle}.json, /collections/all, and search via /search?q={query}&type=product.
Indexes: /sitemap.xml, the AI-native authority index at /llms.txt, and full agent guidance at /agents.md.

What an agent can do

The supported flow is discover → search → cart → checkout → fulfilment → completion. Agents may search inventory, add items to a cart, set a shipping address and method, and initiate checkout on a buyer's behalf — but, by design, an agent must not complete payment without the buyer's explicit consent.

Why we built this

Serious collectors increasingly research and shop through AI assistants. Skyjems meets them there: every stone's provenance, treatment status and GIA documentation is exposed as structured data, so an assistant can verify a gemstone's origin, heat or oiling status, and certification before recommending it — the same transparency we offer a collector across the table. Curation and disclosure, made machine-readable.

Building an assistant or agent and want to integrate? Start at /agents.md. A human collector? Inquire with the curator to arrange a private viewing.