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.

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/ritani
Every 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/mcp
Set it up in your client

Both 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/getConfigurator

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = 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

    NameTypeRequired
    centerStoneShapestring
    Required, a RitaniOption.name from centerStoneShapes.
    Yes
    headStylestring
    Required, from headStyles.
    Yes
    headMetalstring
    Required, from headMetals.
    Yes
    shankStylestring
    Omit for the head-only build (no band).
    No
    shankMetalstringNo
    ringSizestringNo

    Returns RitaniPriceResult

    interface 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/priceConfiguration

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.ritani.priceConfiguration({
      centerStoneShape: "round",
      headStyle: "104",
      headMetal: "head-14kt-white-gold"
    });

Use it from code