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

Just Interior Define

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

One 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/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 4
  • 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

    NameTypeRequired
    skustringYes
    selectionsRecord<string, string>Yes

    Returns InteriorDefineCartHandoff

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

    Call it

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

    NameTypeRequired
    skustringYes

    Returns InteriorDefineConfigurator

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

    Call it

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

    NameTypeRequired
    skustringYes
    selectionsRecord<string, string>Yes

    Returns InteriorDefinePriceResult

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

    Call it

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

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.interiordefine.searchProducts("sofa");

Use it from code