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.
- Site
- borsheims.com
- 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/borsheimsEvery 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/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 3
configureRingComposes a setting product page and a diamond/center-stone product page into a priced ring.Arguments
Name Type Required settingUrlstringYes diamondUrlstringYes Returns
BorsheimsRingConfigurationinterface 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/configureRingCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.borsheims.configureRing({ settingUrl: "<settingUrl>", diamondUrl: "<diamondUrl>" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.borsheims.configureRing({"settingUrl": "<settingUrl>", "diamondUrl": "<diamondUrl>"}))curl -X POST https://api.bowmark.ai/v1/sites/borsheims/configureRing \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"settingUrl":"<settingUrl>","diamondUrl":"<diamondUrl>"}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required urlstringYes Returns
BorsheimsProductinterface 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/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.borsheims.getProduct("<url>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.borsheims.getProduct("<url>"))curl -X POST https://api.bowmark.ai/v1/sites/borsheims/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"<url>"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.borsheims.searchProducts("engagement ring setting");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.borsheims.searchProducts("engagement ring setting"))curl -X POST https://api.bowmark.ai/v1/sites/borsheims/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"engagement ring setting"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.borsheims.searchProducts("engagement ring setting");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/borsheims/<function> - OpenAPI
/v1/sites/borsheims/openapi.json