Developer docs
Make Claude your storefront ops engineer.
Install our MCP server. Get 26 tools to create, edit, and ship storefronts from any MCP client — Claude Desktop, Cursor, your own agent.
Install
Three steps. ~2 minutes.
Install the package
Stateless stdio server. ~3MB. Zero side effects on import.
npm i -g @threadzshops/mcpWire it into Claude Desktop
Open ⌘, in Claude Desktop, edit claude_desktop_config.json, then restart Claude.
{
"mcpServers": {
"threadzshops": {
"command": "npx",
"args": ["@threadzshops/mcp"],
"env": {
"THREADZSHOPS_API_KEY": "ts_pat_…"
}
}
}
}Mint a Personal Access Token
One PAT per agent. Scoped to your account. Revoke anytime.
/admin/api-keys
Generate a token starting with ts_pat_. Paste it into the env block above. Done.
Tool inventory
26 tools, grouped by what they do.
Every tool returns structured JSON. Mutations are idempotent wherever possible. Every reference page has a copy-pasteable example call.
Store lifecycle
Create, list, fetch, update settings on, and delete stores.
store_create
Create a new ThreadzShops store.
Read docsstore_list_mine
List stores accessible to the caller.
Read docsstore_publish
Publish the store's draft customization to live.
Read docsstore_get
Get a single store's summary.
Read docsstore_update_settings
Update store settings (name, markup, status, etc.).
Read docsstore_delete
Soft-delete a store (with confirmation guard).
Read docs
Products
Add, remove, and re-price products on a store.
Logos
Upload, manage, and clean up the store's logo library.
Mockups
Generate and curate AI mockups that become the storefront's hero images.
Customization
Palette, typography, template, and free-form customization patches — then publish.
Reads
Analytics + order reads. No mutations.
Catalog
Browse the unbranded master catalog before publishing products into a store.
Live example
One prompt. Real tools. Real store.
Build me a store called BRAVO. Streetwear vibe. Add three tees in black.
On it. Picking the drop template and seeding three black tees.
→ { "name": "Bravo", "slug": "bravo", "template": "drop" }
← { "id": "8a1b…", "slug": "bravo", "next_url": "/admin/stores/bravo/editor" }→ { "q": "tee", "color_hex": "#000000", "limit": 3 }
← { "results": [ {id: "b1a4…"}, {id: "c2b5…"}, {id: "d3c6…"} ] }→ { "slug": "bravo", "product_ids": ["b1a4…", "c2b5…", "d3c6…"] }
← { "added": [ … 3 rows … ] }Bravo is live at threadzshops.com/bravo with three products. Want me to upload your logo and generate front-chest mockups?
Get a PAT and start.
The package is open source. The platform is real. The PATs are free.