Maiden Home MCP server for AI agents

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

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

Connect

Just Maiden Home

An MCP server for Maiden 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/maidenhome
Every site

One MCP server for Maiden 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
  • getProductReads one configurable product's complete Size x Wood Finish variant grid.

    Arguments

    NameTypeRequired
    handlestringYes

    Returns MaidenHomeConfiguratorProduct

    // Maiden Home's OWN shapes, not a capability contract.
    interface MaidenHomeVariant {
      productHandle: string;
      productTitle: string;
      productType: string;      // e.g. "Sofa", "Modular Component", "Dining Table"
      size: string;              // e.g. "85\" Width", or a non-numeric value like "Right-Facing Chaise"
      woodFinish: string;        // e.g. "Driftwood Ash"
      sku: string;
      price: number;
      priceFormatted: string;
      available: boolean;
      url: string;               // the product page, preselecting this exact variant
    }
    
    interface MaidenHomeConfiguratorProduct {
      handle: string;
      title: string;
      productType: string;
      url: string;
      sizeOptions: string[];
      woodFinishOptions: string[];
      priceRange: { min: number; max: number };
      variants: MaidenHomeVariant[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/maidenhome/getProduct

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.maidenhome.getProduct("<handle>");
  • resolveVariantResolves a free-text product + size + wood finish to the exact priced variant and its product/checkout URL, mirroring the on-page configurator's own…

    Arguments

    NameTypeRequired
    productQuerystringYes
    sizestringYes
    woodFinishstringYes

    Returns MaidenHomeVariantResolution

    // Maiden Home's OWN shapes, not a capability contract.
    interface MaidenHomeVariant {
      productHandle: string;
      productTitle: string;
      productType: string;      // e.g. "Sofa", "Modular Component", "Dining Table"
      size: string;              // e.g. "85\" Width", or a non-numeric value like "Right-Facing Chaise"
      woodFinish: string;        // e.g. "Driftwood Ash"
      sku: string;
      price: number;
      priceFormatted: string;
      available: boolean;
      url: string;               // the product page, preselecting this exact variant
    }
    
    interface MaidenHomeVariantResolution {
      productQuery: string;
      size: string;
      woodFinish: string;
      matched: boolean;
      variant: MaidenHomeVariant | null;
      candidates: MaidenHomeVariant[]; // populated when not narrowed to exactly one real variant
      message: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/maidenhome/resolveVariant

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.maidenhome.resolveVariant("<productQuery>", "<size>", "<woodFinish>");
  • searchConfigurationsLists every Maiden Home product configurable by Size x Wood Finish (sofas, sectionals/modular components, tables) from the storefront's own live…

    Arguments

    NameTypeRequired
    querystringNo

    Returns MaidenHomeConfiguratorProduct[]

    // Maiden Home's OWN shapes, not a capability contract.
    interface MaidenHomeVariant {
      productHandle: string;
      productTitle: string;
      productType: string;      // e.g. "Sofa", "Modular Component", "Dining Table"
      size: string;              // e.g. "85\" Width", or a non-numeric value like "Right-Facing Chaise"
      woodFinish: string;        // e.g. "Driftwood Ash"
      sku: string;
      price: number;
      priceFormatted: string;
      available: boolean;
      url: string;               // the product page, preselecting this exact variant
    }
    
    interface MaidenHomeConfiguratorProduct {
      handle: string;
      title: string;
      productType: string;
      url: string;
      sizeOptions: string[];
      woodFinishOptions: string[];
      priceRange: { min: number; max: number };
      variants: MaidenHomeVariant[];
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/maidenhome/searchConfigurations

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.maidenhome.searchConfigurations("chelsea");

Use it from code