Ruggable MCP server for AI agents
Let Claude, ChatGPT or your own agent read Ruggable: 2 typed functions through one MCP server. No Ruggable API key needed.
- Site
- ruggable.com
- Functions
- 2
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
Just Ruggable
An MCP server for Ruggable 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/ruggableEvery site
One MCP server for Ruggable 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 2
getRugReads one Ruggable rug by handle or url and returns its price range plus every size × construction variant (Rug + Pad System, Rug + Cushioned Pad…Arguments
Name Type Required handleGetRugArgsYes type GetRugArgs = string;Returns
RuggableRuginterface RuggableVariant { id: string; sku: string | null; construction: string | null; size: string | null; price: number | null; compareAtPrice: number | null; currency: string | null; available: boolean; } interface RuggableRug { handle: string; title: string; url: string; productType: string | null; description: string | null; available: boolean; minPrice: number | null; maxPrice: number | null; currency: string | null; options: { name: string; values: string[] }[]; variants: RuggableVariant[]; collections: string[]; tags: string[]; imageUrls: string[]; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/ruggable/getRugCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ruggable.getRug("vintage-daisy-bordered-blue");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ruggable.getRug("vintage-daisy-bordered-blue"))curl -X POST https://api.bowmark.ai/v1/sites/ruggable/getRug \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"handle":"vintage-daisy-bordered-blue"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.ruggable.getRug("vintage-daisy-bordered-blue");searchRugsSearches Ruggable's whole washable-rug catalog (rugs, runners, doormats, rug pads) by words in the product name.Arguments
Name Type Required querystringYes limitnumberNo Returns
RuggableListing[]interface RuggableListing { handle: string; title: string; url: string; imageUrl: string | null; }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/ruggable/searchRugsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.ruggable.searchRugs({ query: "vintage daisy" });import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.ruggable.searchRugs({"query": "vintage daisy"}))curl -X POST https://api.bowmark.ai/v1/sites/ruggable/searchRugs \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"args":{"query":"vintage daisy"}}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.ruggable.searchRugs({ query: "vintage daisy" });
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/ruggable/<function> - OpenAPI
/v1/sites/ruggable/openapi.json