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/account/api-keys
Generate a token starting with ts_pat_. Paste it into the env block above. Done.
Owner API
Run your store from your own platform.
Store owners get a scoped API key (Settings → API keys) to pull orders, fulfillment, financials, and payouts, issue gift cards, and receive signed webhooks — over REST or MCP. Full reference with copy-paste recipes:
Read the Owner API docsTool 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.