Caraway Home MCP server for AI agents

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

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

Connect

Just Caraway Home

An MCP server for Caraway Home 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/caraway
Every site

One MCP server for Caraway Home 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
  • getCarawayProductReads one product by its handle.

    Arguments

    NameTypeRequired
    handlestringYes

    Returns CarawayProduct

    interface CarawayVariant {
      /** Shopify's numeric variant id as a string. */
      id: string;
      /** The variant's own label, e.g. "Cream" or "Default Title". */
      title: string;
      /** String verbatim from the storefront, "50.00" (dollars) on /products.json, "44500" (cents) on /products/<h>.js. */
      price: string;
      /** Same scale as price. Null when the product is not on sale. */
      compareAtPrice: string | null;
      /** The store's own SKU. Null on a product without one. */
      sku: string | null;
      /** Whether the variant is purchasable right now. */
      available: boolean;
      options: string[];
    }
    
    interface CarawayProduct {
      /** The handle is the only stable identifier across the catalogue. */
      handle: string;
      title: string;
      vendor: string;
      productType: string;
      url: string;
      descriptionHtml: string | null;
      optionNames: string[];
      variants: CarawayVariant[];
      /** Same scale as variants, see CarawayVariant.price. */
      priceRange: { min: string; max: string } | null;
      /** True if ANY variant is purchasable. */
      inStock: boolean;
      tags: string[];
      /** Caraway's own images, in the order the storefront publishes them. */
      images: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/caraway/getCarawayProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.caraway.getCarawayProduct("cookware-sets");
  • listCarawayProductsReads the live Caraway catalogue as Caraway publishes it.

    Arguments

    NameTypeRequired
    opts{ limit?: number }No

    Returns CarawayProduct[]

    interface CarawayVariant {
      /** Shopify's numeric variant id as a string. */
      id: string;
      /** The variant's own label, e.g. "Cream" or "Default Title". */
      title: string;
      /** String verbatim from the storefront, "50.00" (dollars) on /products.json, "44500" (cents) on /products/<h>.js. */
      price: string;
      /** Same scale as price. Null when the product is not on sale. */
      compareAtPrice: string | null;
      /** The store's own SKU. Null on a product without one. */
      sku: string | null;
      /** Whether the variant is purchasable right now. */
      available: boolean;
      options: string[];
    }
    
    interface CarawayProduct {
      /** The handle is the only stable identifier across the catalogue. */
      handle: string;
      title: string;
      vendor: string;
      productType: string;
      url: string;
      descriptionHtml: string | null;
      optionNames: string[];
      variants: CarawayVariant[];
      /** Same scale as variants, see CarawayVariant.price. */
      priceRange: { min: string; max: string } | null;
      /** True if ANY variant is purchasable. */
      inStock: boolean;
      tags: string[];
      /** Caraway's own images, in the order the storefront publishes them. */
      images: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/caraway/listCarawayProducts

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.caraway.listCarawayProducts({ limit: 50 });
  • runCarawayQuizRoutes a quiz's buyer-fit answers to a Caraway archetype and resolves the Recommended rail the quiz terminal page renders.

    Arguments

    NameTypeRequired
    answers{ archetype: string }Yes

    Returns CarawayQuizResult

    interface CarawayVariant {
      /** Shopify's numeric variant id as a string. */
      id: string;
      /** The variant's own label, e.g. "Cream" or "Default Title". */
      title: string;
      /** String verbatim from the storefront, "50.00" (dollars) on /products.json, "44500" (cents) on /products/<h>.js. */
      price: string;
      /** Same scale as price. Null when the product is not on sale. */
      compareAtPrice: string | null;
      /** The store's own SKU. Null on a product without one. */
      sku: string | null;
      /** Whether the variant is purchasable right now. */
      available: boolean;
      options: string[];
    }
    
    interface CarawayProduct {
      /** The handle is the only stable identifier across the catalogue. */
      handle: string;
      title: string;
      vendor: string;
      productType: string;
      url: string;
      descriptionHtml: string | null;
      optionNames: string[];
      variants: CarawayVariant[];
      /** Same scale as variants, see CarawayVariant.price. */
      priceRange: { min: string; max: string } | null;
      /** True if ANY variant is purchasable. */
      inStock: boolean;
      tags: string[];
      /** Caraway's own images, in the order the storefront publishes them. */
      images: string[];
    }
    
    interface CarawayQuizArchetype {
      /** The archetype slug (e.g. new-customer, 90s-baby). */
      slug: string;
      /** Caraway's own copy for the archetype. */
      label: string;
      /** Caraway's own one-line archetype blurb. */
      description: string;
      /** The product handles the quiz route marks as Recommended. */
      recommendedHandles: string[];
    }
    
    interface CarawayQuizResult {
      /** The archetype the quiz terminal page lands on, with the site copy. */
      archetype: CarawayQuizArchetype;
      /** The Recommended rail, in stock first. */
      recommended: CarawayProduct[];
      /** What the resolver DROPPED, in the same register the rest of the library uses. */
      warnings: string[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/caraway/runCarawayQuiz

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.caraway.runCarawayQuiz({ archetype: "new-customer" });

Use it from code