BaubleBar MCP server for AI agents
Let Claude, ChatGPT or your own agent read BaubleBar: 5 typed functions through one MCP server. No BaubleBar API key needed.
- Site
- baublebar.com
- Functions
- 5
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for BaubleBar 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/baublebarOne MCP server for BaubleBar 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.
getBaublebarCheckoutLinkResolves a product handle + chosen size/color + (for personalizer products) the initials/text to a real, purchasable Shopify cart permalink carrying…Arguments
Name Type Required handlestringYes selections{ size?: string; color?: string; text?: string }Yes opts{ quantity?: number }No Returns
BaublebarCheckoutLinkinterface BaublebarPersonalizationField { index: number; minLength: number; maxLength: number; /** The exact allowed-character set as the site states it, e.g. "A, B, C, …, Z". */ restriction: string; required: boolean; lettercase: "uppercase" | "lowercase" | "none"; } interface BaublebarPersonalization { fields: BaublebarPersonalizationField[]; /** True when a single "_Customization" cart property is used instead of one per field. */ hasIcons: boolean; } interface BaublebarVariant { id: string; title: string; /** Integer cents, verbatim from the storefront. */ price: number; available: boolean; options: string[]; } interface BaublebarProduct { handle: string; title: string; vendor: string; url: string; optionNames: string[]; variants: BaublebarVariant[]; inStock: boolean; images: string[]; /** null on a product with no free-text personalizer. */ personalization: BaublebarPersonalization | null; /** The literal made-to-order ship-by date as rendered right now, e.g. "9/11/26", or null. */ shipBy: string | null; } interface BaublebarCheckoutLink { url: string; variant: BaublebarVariant; product: BaublebarProduct; shipBy: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/baublebar/getBaublebarCheckoutLinkCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.baublebar.getBaublebarCheckoutLink("custom-tennis-bracelet", { size: "6.75 (Standard)", color: "Clear", text: "AMY" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.baublebar.getBaublebarCheckoutLink("custom-tennis-bracelet", {"size": "6.75 (Standard)", "color": "Clear", "text": "AMY"}))curl -X POST https://api.bowmark.ai/v1/sites/baublebar/getBaublebarCheckoutLink \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"handle":"custom-tennis-bracelet","selections":{"size":"6.75 (Standard)","color":"Clear","text":"AMY"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.baublebar.getBaublebarCheckoutLink("custom-tennis-bracelet", { size: "6.75 (Standard)", color: "Clear", text: "AMY" });getBaublebarProductReads one product by its handle.Arguments
Name Type Required handlestringYes Returns
BaublebarProductinterface BaublebarPersonalizationField { index: number; minLength: number; maxLength: number; /** The exact allowed-character set as the site states it, e.g. "A, B, C, …, Z". */ restriction: string; required: boolean; lettercase: "uppercase" | "lowercase" | "none"; } interface BaublebarPersonalization { fields: BaublebarPersonalizationField[]; /** True when a single "_Customization" cart property is used instead of one per field. */ hasIcons: boolean; } interface BaublebarVariant { id: string; title: string; /** Integer cents, verbatim from the storefront. */ price: number; available: boolean; options: string[]; } interface BaublebarProduct { handle: string; title: string; vendor: string; url: string; optionNames: string[]; variants: BaublebarVariant[]; inStock: boolean; images: string[]; /** null on a product with no free-text personalizer. */ personalization: BaublebarPersonalization | null; /** The literal made-to-order ship-by date as rendered right now, e.g. "9/11/26", or null. */ shipBy: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/baublebar/getBaublebarProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.baublebar.getBaublebarProduct("custom-tennis-bracelet");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.baublebar.getBaublebarProduct("custom-tennis-bracelet"))curl -X POST https://api.bowmark.ai/v1/sites/baublebar/getBaublebarProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"handle":"custom-tennis-bracelet"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.baublebar.getBaublebarProduct("custom-tennis-bracelet");listBaublebarCollectionsThe entry door: reads the storefront's own published collection index (/collections.json) so a caller holding only a shopper's words can find the…Arguments
Name Type Required opts{ limit?: number }No Returns
BaublebarCollectionRow[]interface BaublebarCollectionRow { handle: string; title: string; productsCount: number; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/baublebar/listBaublebarCollectionsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.baublebar.listBaublebarCollections();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.baublebar.listBaublebarCollections())curl -X POST https://api.bowmark.ai/v1/sites/baublebar/listBaublebarCollections \ -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.baublebar.listBaublebarCollections();listBaublebarProductsReads a BaubleBar collection's live catalogue as the storefront publishes it.Arguments
Name Type Required collectionHandlestringYes opts{ limit?: number }No Returns
BaublebarCatalogueRow[]interface BaublebarCatalogueRow { handle: string; title: string; vendor: string; url: string; priceRange: { min: number; max: number } | null; inStock: boolean; images: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/baublebar/listBaublebarProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.baublebar.listBaublebarProducts("tennis-bracelets", { limit: 10 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.baublebar.listBaublebarProducts("tennis-bracelets", {"limit": 10}))curl -X POST https://api.bowmark.ai/v1/sites/baublebar/listBaublebarProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"collectionHandle":"tennis-bracelets","opts":{"limit":10}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.baublebar.listBaublebarProducts("tennis-bracelets", { limit: 10 });searchFree-text product search on BaubleBar.Arguments
Name Type Required querystringYes opts{ inStockOnly?: boolean; limit?: number }No Returns
BaublebarSearchHit[]interface BaublebarVariant { id: string; title: string; /** Integer cents, verbatim from the storefront. */ price: number; available: boolean; options: string[]; } interface BaublebarSearchHit { handle: string; title: string; vendor: string; url: string; optionNames: string[]; /** Every variant with its id (what a cart permalink takes), price in cents and live stock. */ variants: BaublebarVariant[]; inStock: boolean; images: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/baublebar/searchCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.baublebar.search("earrings", { limit: 3 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.baublebar.search("earrings", {"limit": 3}))curl -X POST https://api.bowmark.ai/v1/sites/baublebar/search \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"earrings","opts":{"limit":3}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.baublebar.search("earrings", { limit: 3 });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/baublebar/<function> - OpenAPI
/v1/sites/baublebar/openapi.json