Pottery Barn MCP server for AI agents

Let Claude, ChatGPT or your own agent read Pottery Barn: 1 typed function through one MCP server. No Pottery Barn API key needed.

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

Connect

Just Pottery Barn

An MCP server for Pottery Barn 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/potterybarn
Every site

One MCP server for Pottery Barn 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 1
  • searchProductsSearches the Pottery Barn catalog the way its own search box does ("sofa") and returns products with current and regular price, the price range…

    Arguments

    NameTypeRequired
    querystring
    What the store's own search box takes, e.g. "stand mixer".
    Yes
    sort"relevance" | "price_ascending" | "price_descending"No
    pagenumber
    From 1.
    No
    limitnumber
    1-100, default 24.
    No

    Returns WsgcSearch

    interface WsgcProduct {
      id: string;                    // the store's product slug
      name: string;
      url: string;                   // the product page
      price: number | null;          // lowest current price across its sizes/colours, USD
      maxPrice: number | null;       // highest current price, a range when it differs from price
      regularPrice: number | null;   // lowest regular (non-sale) price
      maxRegularPrice: number | null;
      onSale: boolean;
      priceType: string | null;      // the store's own word: "Regular", "Discount", "Clearance"
      maxDiscountPercent: number | null;
      description: string;
      imageUrl: string | null;
      flags: string[];               // the store's badges, e.g. "freeShip", "bestseller"
    }
    
    interface WsgcSearch {
      products: WsgcProduct[];
      total: number;                 // matches across all pages
      page: number;
      // Set when the store maps this term to a category page instead of searching it; the
      // products then come from the store's own autocomplete and there is no next page.
      redirect: string | null;
    }

    HTTP endpoint

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

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.potterybarn.searchProducts({ query: "sofa", limit: 5 });

Use it from code