# Carpetstory

> Carpetstory is an open-source MCP server for e-commerce. Search Carpetstory's hand-knotted Jaipur rug catalogue by motif, colour and collection. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** API, Web, CLI
- **Website:** https://carpetstory.one
- **Repository:** https://github.com/houseofdotone/carpetstory-mcp
- **MCP Registry name:** io.github.houseofdotone/carpetstory
- **Categories:** e-commerce, design and media
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http carpetstory https://carpetstory.one/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://carpetstory.one/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "carpetstory": {
      "url": "https://carpetstory.one/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "carpetstory": {
      "type": "http",
      "url": "https://carpetstory.one/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "carpetstory": {
      "serverUrl": "https://carpetstory.one/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "carpetstory": {
      "type": "http",
      "url": "https://carpetstory.one/mcp"
    }
  }
}
```

## Tools

- `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.

## 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

- [HyperFrames by HeyGen](https://ai-powered.com/mcp/hyperframes-by-heygen): HyperFrames by HeyGen is a freemium MCP server for design and media.
- [ffmpeg-skill](https://ai-powered.com/mcp/ffmpeg-skill): ffmpeg-skill is an open-source MCP server for design and media.
- [O'So MCP Server for PrestaShop](https://ai-powered.com/mcp/o-so-mcp-server-for-prestashop): O'So MCP Server for PrestaShop is an open-source MCP server for e-commerce.
- [SecureCloud](https://ai-powered.com/mcp/securecloud): SecureCloud is a free MCP server for security.
- [AvatarSay — Fictional Character & Talking Video MCP](https://ai-powered.com/mcp/avatarsay-fictional-character-and-talking-video-mcp): AvatarSay — Fictional Character & Talking Video MCP is a freemium MCP server for design and media.
- [MadMax Trade Supply parts](https://ai-powered.com/mcp/madmax-trade-supply-parts): MadMax Trade Supply parts is a free MCP server for e-commerce.
- [ChartAnt](https://ai-powered.com/mcp/chartant): ChartAnt is a freemium MCP server for design and media.
- [VfxSmith](https://ai-powered.com/mcp/vfxsmith): VfxSmith is a freemium MCP server for design and media.

---
Source: https://ai-powered.com/mcp/carpetstory
