Classic Home MCP server for AI agents

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

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

Connect

Just Classic Home

An MCP server for Classic 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/classichome
Every site

One MCP server for Classic 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
  • addToCartResolves one exact fabric/leather choice to Classic Home's own real price, availability and SKU for that exact variant, plus the product page to…

    Arguments

    NameTypeRequired
    handlestringYes
    optionValuestringYes

    Returns ClassicHomeCartHandoff

    interface ClassicHomeCartHandoff {
      handle: string;
      optionValue: string;
      sku: string;
      price: number;         // dollars, the real price for this exact fabric/leather
      available: boolean;
      productUrl: string;    // finish add-to-cart/checkout on the real product page
      checkout: ClassicHomeCheckoutHandoff; // a Shopify cart link carrying this choice; 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 ClassicHomeCheckoutHandoff {
      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/classichome/addToCart

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classichome.addToCart("aspen-sofa-pacific-blue", "Pacific Blue");
  • getProductReads one product's real live fabric/leather picker: every real color/material choice with its own real price and availability, keyed by the site's…

    Arguments

    NameTypeRequired
    handlestringYes

    Returns ClassicHomeProductDetail

    interface ClassicHomeVariant {
      optionValue: string;   // e.g. "Soft Olive", "Dawn-Flax", "ElPaso-Saddle"
      sku: string;
      price: number;         // dollars, this exact fabric/leather's own real price
      available: boolean;
    }
    
    interface ClassicHomeProductDetail {
      handle: string;
      title: string;
      url: string;
      optionName: string;      // usually "Color" (fabric/leather); "Title" if no real picker
      variants: ClassicHomeVariant[];
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.classichome.getProduct("aspen-sofa-pacific-blue");
  • searchProductsSearches Classic Home's real Made-to-Order catalog (sofas, chairs, ottomans) via the site's own Shopify collection JSON, optionally filtered by a…

    Arguments

    NameTypeRequired
    querystringNo

    Returns ClassicHomeSearchResult

    // Classic Home's OWN shapes, not a capability contract.
    interface ClassicHomeProduct {
      handle: string;        // the key getProduct/addToCart take
      title: string;
      url: string;
      priceMin: number;      // dollars, the cheapest real fabric/leather choice
      priceMax: number;      // dollars, the most expensive (usually top-grain leather)
      variantCount: number;  // >1 means a real fabric/leather choice exists
    }
    
    interface ClassicHomeSearchResult {
      products: ClassicHomeProduct[];
      offset: number;
      hasMore: boolean;
      nextOffset: number | null;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/classichome/searchProducts

    Call it

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

Use it from code