Interior Define MCP server for AI agents
Let Claude, ChatGPT or your own agent read Interior Define: 4 typed functions through one MCP server. No Interior Define API key needed.
- Functions
- 4
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Interior Define 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/interiordefineOne MCP server for Interior Define 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.
addToCartHands the shopper a link that opens their exact configuration on Interior Define's own product page, every matched choice preselected, on the site's…Arguments
Name Type Required skustringYes selectionsRecord<string, string>Yes Returns
InteriorDefineCartHandoffinterface InteriorDefinePriceLine { option: string; choice: string; priceDelta: number } interface InteriorDefineCartHandoff { sku: string; name: string; url: string; // the product page with every matched choice preselected, on the site's own Add to Cart button applied: InteriorDefinePriceLine[]; total: number; totalFormatted: string; missingRequired: string[]; // required categories left unpicked, the site defaults them, so total is a FLOOR unmatched: string[]; checkout: InteriorDefineCheckoutHandoff; // the product page, choices preselected; the person presses Add to Cart. Bowmark never pays } // The checkout handoff: where the PERSON finishes. Bowmark never pays, books or orders. // Switch on `status`; a status you do not recognise means "show the person `url` and stop". interface InteriorDefineCheckoutHandoff { status: "ready_to_checkout" | "needs_login" | "unavailable"; url: string; // the https page to open on the site urlKind?: "carries_items" | "signed_in_cart" | "product_page"; // ready_to_checkout only: does the link carry the items, or only open the item's page reason?: string; // unavailable only: out_of_stock | not_available_for_dates | not_sold_online | region_not_served | quantity_unavailable | empty_cart detail?: string; // unavailable only: one sentence saying why account: { site: string; hint: string; signedInAs?: string }; summary: { items: { title: string; variant: string | null; quantity: number; unitPrice: string | null; lineTotal: string | null; url?: string; id?: string }[]; total: string | null; currency: string } | null; warnings: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/interiordefine/addToCartCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.interiordefine.addToCart("SLON.FABRIC.SOFA.STNDRD", { Color: "Coconut", Finish: "Matte Black" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.interiordefine.addToCart("SLON.FABRIC.SOFA.STNDRD", {"Color": "Coconut", "Finish": "Matte Black"}))curl -X POST https://api.bowmark.ai/v1/sites/interiordefine/addToCart \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"sku":"SLON.FABRIC.SOFA.STNDRD","selections":{"Color":"Coconut","Finish":"Matte Black"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.interiordefine.addToCart("SLON.FABRIC.SOFA.STNDRD", { Color: "Coconut", Finish: "Matte Black" });getConfiguratorReads one product's whole customizer: every option category (fabric color, leg finish, length, depth, cushion fill, cushion count) with its exact…Arguments
Name Type Required skustringYes Returns
InteriorDefineConfiguratorinterface InteriorDefineOptionChoice { id: number; label: string; priceDelta: number } interface InteriorDefineOption { optionId: number; // Magento's own option_id, the key addToCart writes into the handoff URL title: string; // "Color" (fabric), "Finish" (legs), "Length", "Total Depth", "Cushion Fill", "Total Sofa Cushions" required: boolean; choices: InteriorDefineOptionChoice[]; } interface InteriorDefineConfigurator { sku: string; name: string; url: string; basePrice: number; basePriceFormatted: string; options: InteriorDefineOption[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/interiordefine/getConfiguratorCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.interiordefine.getConfigurator("SLON.FABRIC.SOFA.STNDRD");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.interiordefine.getConfigurator("SLON.FABRIC.SOFA.STNDRD"))curl -X POST https://api.bowmark.ai/v1/sites/interiordefine/getConfigurator \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"sku":"SLON.FABRIC.SOFA.STNDRD"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.interiordefine.getConfigurator("SLON.FABRIC.SOFA.STNDRD");priceConfigurationPrices a specific configuration (a choice per option category) against getConfigurator's live option data and returns the total plus the exact…Arguments
Name Type Required skustringYes selectionsRecord<string, string>Yes Returns
InteriorDefinePriceResultinterface InteriorDefinePriceLine { option: string; choice: string; priceDelta: number } interface InteriorDefinePriceResult { sku: string; total: number; totalFormatted: string; breakdown: InteriorDefinePriceLine[]; missingRequired: string[]; // required categories with no valid selection, total is a FLOOR until these are picked unmatched: string[]; // selections that didn't match a real option/choice, named so nothing mispriced silently handoffUrl: string; // the product's entry page, call addToCart for the same page with the choices PRESELECTED }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/interiordefine/priceConfigurationCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.interiordefine.priceConfiguration("SLON.FABRIC.SOFA.STNDRD", { Color: "Coconut", Finish: "Matte Black" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.interiordefine.priceConfiguration("SLON.FABRIC.SOFA.STNDRD", {"Color": "Coconut", "Finish": "Matte Black"}))curl -X POST https://api.bowmark.ai/v1/sites/interiordefine/priceConfiguration \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"sku":"SLON.FABRIC.SOFA.STNDRD","selections":{"Color":"Coconut","Finish":"Matte Black"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.interiordefine.priceConfiguration("SLON.FABRIC.SOFA.STNDRD", { Color: "Coconut", Finish: "Matte Black" });searchProductsSearches Interior Define's custom-furniture catalog (sofas, sectionals, chairs) by free text and returns each match's SKU, name, entry URL and…Arguments
Name Type Required querystringYes Returns
InteriorDefineProductSummary[]// Interior Define's OWN shapes, not a capability contract. interface InteriorDefineProductSummary { sku: string; // the key getConfigurator/priceConfiguration take name: string; urlKey: string; url: string; basePrice: number; basePriceFormatted: string; // "$1,630.00" }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/interiordefine/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.interiordefine.searchProducts("sofa");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.interiordefine.searchProducts("sofa"))curl -X POST https://api.bowmark.ai/v1/sites/interiordefine/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"sofa"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.interiordefine.searchProducts("sofa");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/interiordefine/<function> - OpenAPI
/v1/sites/interiordefine/openapi.json