Ritani MCP server for AI agents
Let Claude, ChatGPT or your own agent read Ritani: 2 typed functions through one MCP server. No Ritani API key needed.
- Site
- ritani.com
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just Ritani
An MCP server for Ritani alone, with one tool per function. Paste it into Claude, ChatGPT, Cursor or any MCP client as a remote server.
https://api.bowmark.ai/mcp/site/ritaniEvery site
One MCP server for Ritani and every other site Bowmark covers. Your agent looks up what it needs and calls it.
https://api.bowmark.ai/mcpSet it up in your clientBoth need a Bowmark API key. The quickstart gets you one and a first result in a few minutes.
Functions
Open a function to see its arguments, what it returns and how to call it.
Read 2
getConfiguratorReads Ritani's real live Ring Studio option catalog: every center stone shape, head/setting style (grouped, e.g. 4-Prong/Halo/Vintage), head metal…Arguments
None.
Returns
RitaniConfigurator// Ritani's OWN shapes, not a capability contract. interface RitaniOption { name: string; // the site's own option code, e.g. "round" | "104" | "head-14kt-white-gold" title: string; // e.g. "Round" | "Four Prong" | "14kt White Gold" icon: string; group: string | null; // e.g. "4-Prong" | "Halo" | "Vintage", for head/shank styles disabled: boolean; // true for a currently-unavailable option, still listed } interface RitaniConfigurator { centerStoneShapes: RitaniOption[]; headStyles: RitaniOption[]; headMetals: RitaniOption[]; shankStyles: RitaniOption[]; // the band/setting style shankMetals: RitaniOption[]; startingPrice: number; // the default build's own price ("Starting at" on the site) }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/ritani/getConfiguratorCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ritani.getConfigurator();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ritani.getConfigurator())curl -X POST https://api.bowmark.ai/v1/sites/ritani/getConfigurator \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.ritani.getConfigurator();priceConfigurationPrices one exact custom-ring build against Ritani's own live Ring Studio pricing engine ('/api/custom-ring') and returns the real total, compare-at…Arguments
Name Type Required centerStoneShapestringRequired, a RitaniOption.name from centerStoneShapes.Yes headStylestringRequired, from headStyles.Yes headMetalstringRequired, from headMetals.Yes shankStylestringOmit for the head-only build (no band).No shankMetalstringNo ringSizestringNo Returns
RitaniPriceResultinterface RitaniPriceResult { title: string; sku: string; price: number; // the real total for this exact build compareAtPrice: number; bandPrice: number; // a plain matching band's own price, quoted alongside selections: { // echoes back what Ritani's engine actually priced centerStoneShape: string; headStyle: string; headMetal: string; shankStyle: string; shankMetal: string; }; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/ritani/priceConfigurationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ritani.priceConfiguration({ centerStoneShape: "round", headStyle: "104", headMetal: "head-14kt-white-gold" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ritani.priceConfiguration({ "centerStoneShape": "round", "headStyle": "104", "headMetal": "head-14kt-white-gold" }))curl -X POST https://api.bowmark.ai/v1/sites/ritani/priceConfiguration \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"selections":{"centerStoneShape":"round","headStyle":"104","headMetal":"head-14kt-white-gold"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.ritani.priceConfiguration({ centerStoneShape: "round", headStyle: "104", headMetal: "head-14kt-white-gold" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/ritani/<function> - OpenAPI
/v1/sites/ritani/openapi.json