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.
- Site
- maidenhome.com
- 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/maidenhomeEvery 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/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
getProductReads one configurable product's complete Size x Wood Finish variant grid.Arguments
Name Type Required 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/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.maidenhome.getProduct("<handle>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.maidenhome.getProduct("<handle>"))curl -X POST https://api.bowmark.ai/v1/sites/maidenhome/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"handle":"<handle>"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/resolveVariantCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.maidenhome.resolveVariant("<productQuery>", "<size>", "<woodFinish>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.maidenhome.resolveVariant("<productQuery>", "<size>", "<woodFinish>"))curl -X POST https://api.bowmark.ai/v1/sites/maidenhome/resolveVariant \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"productQuery":"<productQuery>","size":"<size>","woodFinish":"<woodFinish>"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/searchConfigurationsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.maidenhome.searchConfigurations("chelsea");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.maidenhome.searchConfigurations("chelsea"))curl -X POST https://api.bowmark.ai/v1/sites/maidenhome/searchConfigurations \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"chelsea"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.maidenhome.searchConfigurations("chelsea");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/maidenhome/<function> - OpenAPI
/v1/sites/maidenhome/openapi.json