Developer docs

Run your storefronts from your chat app.

Install our MCP server. Get 26 tools to create, edit, and ship storefronts from any MCP client — desktop chat apps, Cursor, your own agent.

Install the MCP server Browse the 26 tools

Install

Three steps. ~2 minutes.

1

Install the package

Stateless stdio server. ~3MB. Zero side effects on import.

terminal

npm i -g @threadzshops/mcp

2

Wire it into your MCP client

Open your MCP client's settings, add the block below to its mcpServers config, then restart the app.

mcp config (json)

{
  "mcpServers": {
    "threadzshops": {
      "command": "npx",
      "args": ["@threadzshops/mcp"],
      "env": {
        "THREADZSHOPS_API_KEY": "ts_pat_…"
      }
    }
  }
}

3

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.

Open API keys

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 docs

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.

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

mcp client · threadzshops MCP

you

Build me a store called BRAVO. Streetwear vibe. Add three tees in black.

assistant

On it. Picking the drop template and seeding three black tees.

tool · store_create

→ { "name": "Bravo", "slug": "bravo", "template": "drop" }
← { "id": "8a1b…", "slug": "bravo", "next_url": "/admin/stores/bravo/editor" }

tool · catalog_search

→ { "q": "tee", "color_hex": "#000000", "limit": 3 }
← { "results": [ {id: "b1a4…"}, {id: "c2b5…"}, {id: "d3c6…"} ] }

tool · store_add_products

→ { "slug": "bravo", "product_ids": ["b1a4…", "c2b5…", "d3c6…"] }
← { "added": [ … 3 rows … ] }

assistant

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.

Mint a PAT Browse the tools