API reference · beta

Bring StitchGrid into your tools.

StitchGrid runs a Model Context Protocol server, so Claude, ChatGPT, Cursor, and your own agents can price garments, find manufacturers, draft tech packs, and keep up with production in your workspace. It speaks Streamable HTTP and holds no session between calls.

ENDPOINThttps://www.stitchgrid.com/api/mcp

Without a key the server offers its public tools. With a key from your workspace it adds the tools that read and write your own styles, briefs, orders, and samples.

Authentication

An owner or admin creates keys in Integrations. The full key is shown once, so copy it before you leave the page. Send it as a bearer token on every request, and keep it out of browser and mobile code.

A key acts as the person who created it, with their current role. Removing someone from the workspace switches off every key they made, and a member whose role is read only can never write, whatever their key allows. Each key is read only or read and write, and expires after 30, 90, or 365 days. A workspace can hold 25 active keys. Every write a key makes is recorded in the workspace audit log, and resetting your password revokes every key you created. Revoke a key straight away if it is exposed.

Connecting

In Claude Code, run:

claude mcp add --transport http stitchgrid https://www.stitchgrid.com/api/mcp \
  --header "Authorization: Bearer sg_sk_your_key"

In Cursor, or in a project’s .mcp.json, add the endpoint with the same header:

{
  "mcpServers": {
    "stitchgrid": {
      "type": "http",
      "url": "https://www.stitchgrid.com/api/mcp",
      "headers": { "Authorization": "Bearer sg_sk_your_key" }
    }
  }
}

In claude.ai, Claude Desktop, and ChatGPT, add the endpoint as a custom connector with no authentication to use the public tools. Signing in to your workspace from those apps is not available yet.

To check a key from the command line, list the tools it can use:

curl https://www.stitchgrid.com/api/mcp \
  -H "Authorization: Bearer sg_sk_your_key" \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/list","params":{}}'

Tools

These need no key. Nothing on the public side names a factory or calls a model.

estimate_cost

What a garment costs to make, free on board, from StitchGrid’s cost tables.

compare_countries

The same garment priced across the countries that make it.

check_quote

Whether a factory’s quote is fair for what it covers.

find_manufacturers

Who can make a product, described as counts and ranges rather than names.

start_sourcing_request

Hands a request to the StitchGrid production office, with the person’s consent.

A key adds the tools below and sharpens the public ones. Write tools need a read and write key, a role that can edit, and the module named beside them.

READestimate_cost, compare_countries, check_quote

Calibrated by the quotes your workspace has received.

READfind_manufacturers

Names your own suppliers and shows network factories without identifying them. Needs Sourcing.

READneeds_attention, search, fetch

What is waiting on you, and your orders and samples.

WRITEstart_sourcing_request

Creates a brief in your workspace. Needs Sourcing.

WRITEdraft_tech_pack

Drafts a tech pack from a brief or a product page and saves it for review. Needs Sourcing or Studio, and uses AI credits.

WRITElog_factory_update

Turns a message from a factory into proposed updates in your Inbox. Nothing changes until someone approves them.

Errors and limits

A key that is missing its prefix, unknown, expired, or revoked gets a 401 rather than the public tools, so a revoked key never fails quietly.

{
  "error": "Invalid or revoked StitchGrid API key"
}

Requests are limited to 240 a minute for each key and 100 a minute for each address without one. Past either limit the server answers 429 with a Retry-After header. The tools that call a model, draft_tech_pack and log_factory_update, also allow 30 calls a minute for each person and 20 an hour for each key, so a key that leaks can only spend so much before you revoke it.

A tool that cannot run returns a result with isError set and a sentence the assistant can pass on, instead of failing the request. Its structuredContent.error names the reason, such as read_only_key, read_only_role, module_locked, or rate_limited.

Integration support

The server is in beta. Write to support@stitchgrid.com with what you are building, especially if you need something the tools do not cover yet.