Skip to content
MCP server

Carpetstory

Search Carpetstory's hand-knotted Jaipur rug catalogue by motif, colour and collection

Install
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/mcp

Add to Settings → Connectors → Add custom connector

https://carpetstory.one/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "carpetstory": {
      "url": "https://carpetstory.one/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

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

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. Let Claude, ChatGPT or Cursor manage a PrestaShop shop with per-employee permissions

    Not checked yet
    • Remote
    • Open source
    • 2 GitHub stars
    • E-commerce
  4. SecureCloud

    MCP server

    SentinelOne and IT security catalog, prices, quotes and checkout links for Israel

    • 7 tools
    • Remote
    • Free
    • Security
  5. Search replacement filters, alarms and batteries, check fit and build a cart link

    • 7 tools
    • Remote
    • Free
    • E-commerce