Carpetland USA MCP server for AI agents
Let Claude, ChatGPT or your own agent read Carpetland USA: 3 typed functions through one MCP server. No Carpetland USA API key needed.
- Functions
- 3
- Sign-in
- Not needed
- Works with
- MCP, HTTP, Node, Python
Connect
An MCP server for Carpetland USA 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/carpetlandusaOne MCP server for Carpetland USA 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.
getProductOne product's own catalog page: style, color, material, coverage per carton, and.Arguments
Name Type Required slugOrUrlstringYes Returns
CarpetlandProductDetailinterface CarpetlandProductSummary { slug: string; title: string; url: string } interface CarpetlandProductDetail extends CarpetlandProductSummary { style: string | null; color: string | null; material: string | null; // e.g. "Rigid – Plank" sqFtPerCarton: number | null; roomDescription: string | null; // e.g. "12'x9' Room / 108 sq ft" installedPrice: string | null; // e.g. "$722" installedPriceValue: number | null; callForPricing: boolean; // true when the site has no posted price for this SKU }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/carpetlandusa/getProductCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.carpetlandusa.getProduct("us-floors-coretec-elster-oak");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.carpetlandusa.getProduct("us-floors-coretec-elster-oak"))curl -X POST https://api.bowmark.ai/v1/sites/carpetlandusa/getProduct \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"slugOrUrl":"us-floors-coretec-elster-oak"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.carpetlandusa.getProduct("us-floors-coretec-elster-oak");listCategoriesThe site's own product-catalog taxonomy (Carpet, Waterproof/LVP, Hardwood, Tile, …), one row per category with its live product count.Arguments
None.
Returns
CarpetlandCategory[]// Carpetland USA's OWN shapes, not a capability contract. interface CarpetlandCategory { id: number; name: string; slug: string; count: number }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/carpetlandusa/listCategoriesCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.carpetlandusa.listCategories();import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.carpetlandusa.listCategories())curl -X POST https://api.bowmark.ai/v1/sites/carpetlandusa/listCategories \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.carpetlandusa.listCategories();searchProductsThe first page (up to 100) of one category's live catalog listing, optionally filtered by a keyword against style/color/brand.Arguments
Name Type Required categorySlugstringNo keywordstringNo Returns
{ products: CarpetlandProductSummary[]; category: CarpetlandCategory | null }// Carpetland USA's OWN shapes, not a capability contract. interface CarpetlandCategory { id: number; name: string; slug: string; count: number } interface CarpetlandProductSummary { slug: string; title: string; url: string }HTTP endpoint
POST https://api.bowmark.ai/v1/sites/carpetlandusa/searchProductsCall it
import { bowmark } from "@bowmark/web"; const result = await bowmark.providers.carpetlandusa.searchProducts("waterproof-lvp");import asyncio from bowmark_web import bowmark result = asyncio.run(bowmark.providers.carpetlandusa.searchProducts("waterproof-lvp"))curl -X POST https://api.bowmark.ai/v1/sites/carpetlandusa/searchProducts \ -H "Authorization: Bearer $BOWMARK_API_KEY" \ -H "Content-Type: application/json" \ -d '{"categorySlug":"waterproof-lvp"}'// The body of a run: the MCP run tool, or POST /v1/run return await bowmark.providers.carpetlandusa.searchProducts("waterproof-lvp");
Use it from code
- Node
npm i @bowmark/web - Python
pip install bowmark-web - HTTP
POST /v1/sites/carpetlandusa/<function> - OpenAPI
/v1/sites/carpetlandusa/openapi.json