Documentation · MCP beta

Connect an AI app to Ring Facet.

The Ring Facet Model Context Protocol (MCP) connector lets compatible AI apps read your account and, with separate write permissions, update Ring Builder pricing and configurators. It is live for approved beta accounts.

What MCP can do for your catalogue → · Open MCP connections →

1. Connect your app

Sign in to Account → MCP connections. If your account is not approved, use the beta request shown there.
Copy https://mcp.ringfacet.com/mcp into your AI app’s custom remote MCP connector setting. In Codex CLI, use codex mcp add ringfacet --url https://mcp.ringfacet.com/mcp. In Claude Code, use claude mcp add --transport http --scope user ringfacet https://mcp.ringfacet.com/mcp.
Complete Ring Facet sign-in in your browser. Check the app name and requested abilities on the consent screen before allowing it.
Ask the app to list your Ring Builder configurators or read your account. Confirm the workspace and names are yours before asking it to change anything.

The URL is a remote MCP endpoint. Opening it directly in a browser may return an authentication challenge; use it inside an MCP client. Private beta access is required even if you have an existing grant. Availability of custom connectors and their setup screens varies by AI app and plan.

2. Available tools

Read

Inspect the workspace

get_account, list_ring_builders, get_ring_builder, list_jewel_shots_models and get_pricing let an app understand the current account, builder catalogue and shared price rules.

Pricing

Update selected price rows

update_pricing changes named rows under the pricing write permission. It can work with metal, setting, band, diamond and combination pricing. Unnamed rows are left alone. The response reports what was actually saved, including values that were not accepted.

Builders

Create or update a configurator

create_ring_builder creates a catalogue-mode builder. update_ring_builder can change its name, options, defaults, shopper actions, quote text, selected display settings and the price fields of existing custom models. Shared prices belong in update_pricing.

Models

Hand off a file

send_3d_file can issue a one-use Ring Builder upload link for a 3DM, OBJ or GLB file, up to 100 MB, valid for one hour. The file appears under “From your AI app” in the dashboard. Review and import it there; the connector does not automatically place it in a live builder.

Shopify

Ring picture in cart

ring_picture_setup_guide gives the steps to show each shopper’s own ring in the Shopify cart, checkout and order email. prepare_order_email returns the merchant’s Order confirmation template with the ring picture added, or their staff New order template with the ring’s picture and details, for them to paste back. Neither changes anything in the account. Guide

Undo

Reverse an eligible save

undo_change can reverse the latest eligible pricing or builder edit, or one named by change ID. Undo requires the matching write permission and is refused when a later change would be overwritten.

3. Prompts to try

“List my configurators and explain which ones use custom models. Read only.”
“Compare my 14k and 18k setting prices. Suggest gaps, but do not save.”
“For the settings I name, show current and proposed prices by metal. Wait for my approval before saving.”
“Create a catalogue-mode builder with these options and quote wording. Show me what you will save first.”
“I updated this builder in the dashboard. Reload its latest revision before making any changes.”

4. Review changes and manage access

Price and configurator edits go live when saved. An AI app is instructed to show a before-and-after proposal and request approval, but each client controls its own approval behavior; check its tool settings. Review saved changes in Ring Facet and test checkout after price changes. If Shopify sync fails after a price save, the tool reports that checkout may still use older prices.

Connections use Ring Facet sign-in and separate read, pricing write, builder write and model upload abilities. A connection ends after 30 days without use. Disconnect an app from Account → MCP connections. Pricing undo history is kept for seven days; undo is only possible while no newer edit conflicts.

5. Current limits

The connector can list Jewel Shots models but cannot edit them or publish them to a Shopify product page. Use My Jewel Shots for that workflow. The Ring Builder upload handoff does not perform CAD conversion or 3D setup: finish those in the browser dashboard. The connector cannot add or remove custom-model files, delete or reorder configurators, or edit engraving, translations, two-tone and full brand theme settings.

6. Troubleshooting

Access

“Request beta access” appears

Sign in to the Ring Facet account and workspace that owns your builder. Request beta access in Account → MCP connections if this account is not approved.

Permissions

The app can read but cannot save

Reconnect and review the requested write abilities. Workspace members cannot write where the dashboard would also refuse them.

Revision

A save is refused as stale

Reload the latest pricing or builder state in the AI app, compare it with your proposal and try again after review.

Upload

A file is missing from the builder

Open the models editor and look under “From your AI app.” Choose “Use this file” and complete its import settings; upload alone does not publish it.

MCP questions → · Contact support →