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.

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

Connect

Just BaubleBar

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/baublebar
Every site

One MCP server for BaubleBar 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 5
  • getBaublebarProductReads one product by its handle.

    Arguments

    NameTypeRequired
    handlestringYes

    Returns BaublebarProduct

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

    Call it

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

    NameTypeRequired
    opts{ limit?: number }No

    Returns BaublebarCollectionRow[]

    interface BaublebarCollectionRow {
      handle: string;
      title: string;
      productsCount: number;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/baublebar/listBaublebarCollections

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.baublebar.listBaublebarCollections();
  • listBaublebarProductsReads a BaubleBar collection's live catalogue as the storefront publishes it.

    Arguments

    NameTypeRequired
    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/listBaublebarProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.baublebar.listBaublebarProducts("tennis-bracelets", { limit: 10 });

Use it from code