Find a place.
Make it a ring.

Discover the current collection.

Read the ring collection and gift guide, or use these public resources. All return without a login:

• JSON catalogue: exact variant codes, reference CAD prices, complete recipe templates, available sizing tables and place presets.
• Shopping OpenAPI specification: request and response schemas for the existing authorized shopping API.
• Agent discovery manifest: EIRVEN's discovery format, workflow and payment capabilities.
• llms.txt and full product context: readable product and policy summaries.

Browser tools with WebMCP.

In a supporting browser, the page registers tools through document.modelContext, with support for earlier navigator.modelContext implementations. WebMCP is experimental; assistants without it can use the HTTPS API or the normal studio.

1. eirven_catalog: inspect variants, size labels, reference prices and policies.
2. eirven_search_places: search by name on Earth or among the named Mars landmarks.
3. eirven_configure_ring: choose variant, coordinates, map width, size, finish and optional engraving. Returns a recipe and creation ID.
4. eirven_quote_ring: use that creation ID to save the recipe and get a fresh server quote and a private review link.
5. eirven_create_checkout: after the buyer reviews and approves the exact price and policies, create a hosted Stripe checkout link. The tool requires the quote ID, exact reviewed CAD amount and buyer confirmation.
6. eirven_get_orders: read orders in the current session and check payment status.

HTTPS API workflow.

Use the same storefront origin for every request: https://eirven.studio. Keep the server-issued session cookie in your HTTP client's cookie jar. Send Origin: https://eirven.studio on mutations and Content-Type: application/json for JSON bodies. No public API key, database access or browser token extraction is needed.

1. GET /agent-catalog.json: choose an available variant. Copy its complete recipe, then edit only the buyer's agreed selections. Bounds must contain the centre, span at most five degrees per axis and stay within ±85° latitude without crossing the antimeridian. For Mars use mars-mola.
2. GET /api/v1/map/search?q=...: resolve Earth place names. The catalogue also includes preset bounds and named Mars coordinates.
3. POST /api/auth/guest with {}: establish or retain the buyer's current session.
4. POST /api/v1/designs with {"creationId":"a-new-UUID","expectedRevision":0,"config":{...}}. Keep creationId stable on a retry, and use a new one for a different recipe. Verify the returned recipe matches the requested design. For an existing design, PATCH it with its current expectedRevision; edits create a new immutable version.
5. POST /api/v1/quotes with {"versionId":"the-returned-revision-id","currency":"CAD"}. Show the returned amount, expiry, exact recipe and purchase policies. If checkoutEnabled is false, keep the design saved and report payment unavailable.
6. POST /api/v1/checkout-sessions with {"quoteId":"...","fingerprint":"...","idempotencyKey":"stable-key-for-this-version"}. Use the returned quote fields exactly, retain the key on retries and obtain buyer authorization first. Tax and the Canadian delivery address are handled at Stripe.
7. GET /api/v1/orders or GET /api/v1/orders/{order_id}: verify webhook-confirmed payment status. A redirect alone does not confirm payment. Size-later orders can confirm a chosen size through the documented size-confirmation endpoint after buyer approval.

Optional generation and job-status endpoints are included in OpenAPI. Terrain data, the 3D preview and manufacturing checks do not have to finish before checkout.

Quotes, errors and retries.

Quotes expire after 30 minutes. Refresh and have the buyer review any new price; never silently accept a changed amount. A 401 requires a valid buyer session, 403 can indicate an unapproved Origin, 404 can mean the object belongs to another buyer, 409 requires resolving a changed revision or quote, and 422 means invalid selections. Respect 429 rate limits. A 503 can mean checkout or a provider is unavailable. Do not retry a payment as a new order just because confirmation is delayed.

Payment, production and delivery.

New orders are in CAD with delivery within Canada. Canadian shipping is included; applicable tax is shown at checkout. Dispatch is estimated at 6 to 8 weeks, with additional transit time. Manufacturing review follows payment. If the agreed design cannot be made, the buyer can approve a change or receive a full refund. A size-later order needs its final size before production.

Read the terms, shipping policy and refund policy before ordering; they are currently marked as drafts. Saved locations, engravings, designs and orders remain private to their owner.

Hosted Stripe checkout is the supported payment path. These tools do not accept card details or charge on their own. ChatGPT Instant Checkout and ACP delegated payment are not enabled for this storefront.

Protocol references: WebMCP specification on GitHub and Agentic Commerce Protocol on GitHub.