Borsheims MCP server for AI agents

Let Claude, ChatGPT or your own agent read Borsheims: 3 typed functions through one MCP server. No Borsheims API key needed.

Functions
3
Sign-in
Not needed
Works with
MCP, HTTP, Node, Python

Connect

Just Borsheims

An MCP server for Borsheims 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/borsheims
Every site

One MCP server for Borsheims 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 3
  • configureRingComposes a setting product page and a diamond/center-stone product page into a priced ring.

    Arguments

    NameTypeRequired
    settingUrlstringYes
    diamondUrlstringYes

    Returns BorsheimsRingConfiguration

    interface BorsheimsProduct {
      code: string;
      name: string;
      basePrice: number;             // dollars, before any discount
      price: number;                 // dollars, the real selling price
      discount: number | null;
      inventoryAvailable: number;
      imageUrl: string | null;
      url: string;                   // pass to getProduct / configureRing
    }
    
    interface BorsheimsRingConfiguration {
      setting: BorsheimsProduct;
      diamond: BorsheimsProduct;
      totalPrice: number;             // dollars, setting.price + diamond.price
      builderUrl: string;             // the handoff, open this to configure/buy
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/borsheims/configureRing

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.borsheims.configureRing({ settingUrl: "<settingUrl>", diamondUrl: "<diamondUrl>" });
  • getProductReads one product's real, live price straight off its product page's own embedded data (mivaJS.product), including any active discount.

    Arguments

    NameTypeRequired
    urlstringYes

    Returns BorsheimsProduct

    interface BorsheimsProduct {
      code: string;
      name: string;
      basePrice: number;             // dollars, before any discount
      price: number;                 // dollars, the real selling price
      discount: number | null;
      inventoryAvailable: number;
      imageUrl: string | null;
      url: string;                   // pass to getProduct / configureRing
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/borsheims/getProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.borsheims.getProduct("<url>");
  • searchProductsTurns a free-text query into real borsheims.com product page URLs by matching every query token against the site's own sitemap.xml (~16,000 URLs).

    Arguments

    NameTypeRequired
    querystringYes

    Returns BorsheimsSearchResult[]

    interface BorsheimsSearchResult {
      name: string;                  // derived from the URL slug, title-cased
      url: string;                   // pass to getProduct / configureRing
      lastmod: string | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/borsheims/searchProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.borsheims.searchProducts("engagement ring setting");

Use it from code