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.
- Site
- carawayhome.com
- 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/carawayEvery 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/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
getCarawayProductReads one product by its handle.Arguments
Name Type Required handlestringYes Returns
CarawayProductinterface 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/getCarawayProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.caraway.getCarawayProduct("cookware-sets");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.caraway.getCarawayProduct("cookware-sets"))curl -X POST https://api.bowmark.ai/v1/sites/caraway/getCarawayProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"handle":"cookware-sets"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.caraway.getCarawayProduct("cookware-sets");listCarawayProductsReads the live Caraway catalogue as Caraway publishes it.Arguments
Name Type Required 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/listCarawayProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.caraway.listCarawayProducts({ limit: 50 });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.caraway.listCarawayProducts({"limit": 50}))curl -X POST https://api.bowmark.ai/v1/sites/caraway/listCarawayProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"opts":{"limit":50}}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required answers{ archetype: string }Yes Returns
CarawayQuizResultinterface 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/runCarawayQuizCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.caraway.runCarawayQuiz({ archetype: "new-customer" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.caraway.runCarawayQuiz({"archetype": "new-customer"}))curl -X POST https://api.bowmark.ai/v1/sites/caraway/runCarawayQuiz \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"answers":{"archetype":"new-customer"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.caraway.runCarawayQuiz({ archetype: "new-customer" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/caraway/<function> - OpenAPI
/v1/sites/caraway/openapi.json