Perennials & Sutherland MCP server for AI agents

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

Functions
3
Sign-in
For account actions
Works with
MCP, HTTP, Node, Python

Connect

Just Perennials & Sutherland

An MCP server for Perennials & Sutherland 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/perennialsandsutherland
Every site

One MCP server for Perennials & Sutherland 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 that need a login use the person's own account: how sign-in works.

Functions

Open a function to see its arguments, what it returns and how to call it.

Read 3
  • getRugVariantReads one rug product-page variant (design + colorway + size).

    Arguments

    NameTypeRequired
    urlstringYes

    Returns RugVariant

    interface RugVariantOption {
      sku: string;
      variationId: number;
      name: string;
    }
    
    interface RugVariant {
      sku: string;
      id: number;
      name: string;
      url: string;
      price: number;
      currency: string;
      colorways: RugVariantOption[];
      sizes: RugVariantOption[];
      explorugUrl: string | null;
      tearsheetUrl: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/perennialsandsutherland/getRugVariant

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.perennialsandsutherland.getRugVariant("<url>");
  • getTearsheetUrlReturns the direct, unauthenticated PDF tearsheet download URL for one rug variant (spec sheet keyed to that exact product id).

    Arguments

    NameTypeRequired
    productIdstringYes

    Returns TearsheetUrl

    interface TearsheetUrl {
      productId: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/perennialsandsutherland/getTearsheetUrl

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.perennialsandsutherland.getTearsheetUrl("30867");
  • searchRugsSearches Perennials & Sutherland's live public rug catalog and returns each match's product URL, sku, id and name.

    Arguments

    NameTypeRequired
    querystringYes

    Returns RugSearchResult[]

    interface RugSearchResult {
      sku: string;
      id: string;
      name: string;
      colorway: string;
      url: string;
    }

    HTTP endpoint

    POST https://api.bowmark.ai/v1/sites/perennialsandsutherland/searchRugs

    Call it

    import { bowmark } from "@bowmark/web";
    
    const result = await bowmark.providers.perennialsandsutherland.searchRugs("cercle");

Use it from code