Carpetstory
Search Carpetstory's hand-knotted Jaipur rug catalogue by motif, colour and collection
- Pricing
- Open source
- Platforms
- API, Web, CLI
- Runs
- Locally or Remotely
- Version
- 1.1.0
- Listing updated
- 3 days ago
About Carpetstory
Carpetstory is an open-source MCP server for e-commerce. It can run locally on your machine or as a hosted remote server.
Carpetstory is a rug atelier in Jaipur, India, making hand-knotted rugs to order since 2001. The server reads its live catalogue, so rugs, images and links are current. It is read-only and needs no API key.
Three tools cover the catalogue. list_collections returns each collection's story, materials, knot density, lead time and piece count. search_rugs finds rugs by words such as motif, mood, colour or place, optionally within a collection or colour family. get_rug returns one rug's description, size, colours, materials, knot density, image and product page.
Rugs are made in any size and priced by enquiry, and designers and architects can use a trade programme. The site's pricing guide gives ranges per square foot, for example $20 to $40 for hand-knotted wool. Connect to the hosted endpoint or install locally via an MCPB bundle or npx, which needs Node.js 18 or newer. The code is MIT licensed.
Install
Run in a terminal
claude mcp add --transport http carpetstory https://carpetstory.one/mcpAdd to Settings → Connectors → Add custom connector
https://carpetstory.one/mcpAdd to ~/.cursor/mcp.json
{
"mcpServers": {
"carpetstory": {
"url": "https://carpetstory.one/mcp"
}
}
}Add to .vscode/mcp.json
{
"servers": {
"carpetstory": {
"type": "http",
"url": "https://carpetstory.one/mcp"
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"carpetstory": {
"serverUrl": "https://carpetstory.one/mcp"
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"carpetstory": {
"type": "http",
"url": "https://carpetstory.one/mcp"
}
}
}Tools this server provides (3)
Taken from the project documentation; the running server may differ.
- list_collections
- Lists current collections with story, materials, knot density, lead time and piece count.
- search_rugs
- Finds rugs by words, optionally within a collection or colour family.
- get_rug
- Returns full details for one rug.
What it does
- Collection overview
- Lists collections with story, materials, knot density, lead time and piece count.
- Rug search
- Finds rugs by motif, mood, colour or place, within a collection or colour family.
- Rug detail
- Returns size, colours, materials, knot density, image and product page.
- Live catalogue
- Reads the current catalogue behind the site.
- Hosted or local
- Use the remote endpoint or install locally with an MCPB bundle or npx.
Good for
- Find a rug with a given motif or colour
- Compare materials and knot density across collections
- Match an ivory silk rug to a room size
- Check lead times before enquiring
Pricing
Open source
Server is free and MIT licensed; rugs are priced by enquiry
Prices change. Check carpetstory.one before you buy.
Carpetstory FAQ
Does it need an API key?
No. It is read-only and needs no key.
Can I order through it?
No. Pricing is by enquiry through the website, with a trade programme for designers.
What are the tools?
list_collections, search_rugs and get_rug.
What licence is it under?
MIT.
Is Carpetstory free?
Yes. Carpetstory is open source, so you can use and self-host it for free.
How do I add Carpetstory to Claude Code?
Run this command in your terminal: claude mcp add --transport http carpetstory https://carpetstory.one/mcp
What are the best alternatives to Carpetstory?
The closest alternatives to Carpetstory are HyperFrames by HeyGen, ffmpeg-skill, O'So MCP Server for PrestaShop, SecureCloud and AvatarSay — Fictional Character & Talking Video MCP.
Alternatives to Carpetstory

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media
O'So MCP Server for PrestaShop
MCP serverLet Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions
Not checked yet- Remote
- Open source
- 2 GitHub stars
- E-commerce

SecureCloud
MCP serverSentinelOne and IT security catalog, prices, quotes and checkout links for Israel
- 7 tools
- Remote
- Free
- Security

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

MadMax Trade Supply parts
MCP serverSearch replacement filters, alarms and batteries, check fit and build a cart link
- 7 tools
- Remote
- Free
- E-commerce