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
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/perennialsandsutherlandOne 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/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 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.
getRugVariantReads one rug product-page variant (design + colorway + size).Arguments
Name Type Required urlstringYes Returns
RugVariantinterface 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/getRugVariantCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.perennialsandsutherland.getRugVariant("<url>");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.perennialsandsutherland.getRugVariant("<url>"))curl -X POST https://api.bowmark.ai/v1/sites/perennialsandsutherland/getRugVariant \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"url":"<url>"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required productIdstringYes Returns
TearsheetUrlinterface TearsheetUrl { productId: string; url: string; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/perennialsandsutherland/getTearsheetUrlCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.perennialsandsutherland.getTearsheetUrl("30867");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.perennialsandsutherland.getTearsheetUrl("30867"))curl -X POST https://api.bowmark.ai/v1/sites/perennialsandsutherland/getTearsheetUrl \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"productId":"30867"}'// The body of a run: the MCP run tool, or POST /v1/run return 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
Name Type Required 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/searchRugsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.perennialsandsutherland.searchRugs("cercle");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.perennialsandsutherland.searchRugs("cercle"))curl -X POST https://api.bowmark.ai/v1/sites/perennialsandsutherland/searchRugs \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"query":"cercle"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.perennialsandsutherland.searchRugs("cercle");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/perennialsandsutherland/<function> - OpenAPI
/v1/sites/perennialsandsutherland/openapi.json