Developers — the Stichii agent API

Stichii has a public API built for AI agents. Give it an image or a line of text and it returns a finished embroidery file — the same digitizing engine the web app uses, running server-side. No other embroidery software can be called by an agent at all.

Get an API key

Sign in, open your account, and create a key. The key is shown once and stored only as a hash, so save it somewhere safe. Every request carries it as a bearer token:

Authorization: Bearer sk_stichii_...

Claude (MCP)

Stichii speaks the Model Context Protocol over streamable HTTP. Add this to your MCP client config and the tools appear automatically:

{
  "mcpServers": {
    "stichii": {
      "type": "http",
      "url": "https://stichii.com/api/v1/mcp",
      "headers": {
        "Authorization": "Bearer sk_stichii_..."
      }
    }
  }
}

Six tools are exposed:

  • digitize_image — PNG artwork to a stitched design.
  • text_to_embroidery — a line of text to lettering.
  • preview_design — render without exporting. Free; does not touch your quota.
  • export_design — produce one named machine format.
  • list_fonts / list_styles — the available options.

Tools that produce a file return a download link plus an inline PNG preview, so the model can see what it made. Start with preview_design while you iterate on size and wording — it costs nothing — then export once you are happy.

ChatGPT (Actions) and other tool-callers

The OpenAPI 3.1 spec is public, so a tool-caller can configure itself from it:

https://stichii.com/api/v1/agent/openapi.json

Import that URL as an Action, set authentication to “API Key / Bearer”, and paste your key.

curl

Creating a design returns a job id, because digitizing takes a few seconds. Poll the job until it finishes:

# 1. Submit
curl -X POST https://stichii.com/api/v1/agent/designs \
  -H "Authorization: Bearer $STICHII_KEY" \
  -H "Content-Type: application/json" \
  -d '{"kind":"text","text":"HELLO","sizeMm":25,"formats":["pes","dst"]}'
# → {"job_id":"...","status":"queued"}

# 2. Poll
curl https://stichii.com/api/v1/agent/designs/$JOB_ID \
  -H "Authorization: Bearer $STICHII_KEY"
# → {"status":"succeeded","report":{...},"files":[{"format":"pes","url":"https://..."}]}

To digitize artwork, send it base64-encoded with the finished width in millimetres:

curl -X POST https://stichii.com/api/v1/agent/designs \
  -H "Authorization: Bearer $STICHII_KEY" \
  -H "Content-Type: application/json" \
  -d "{\"kind\":\"image\",\"widthMm\":80,\"imageBase64\":\"$(base64 -w0 logo.png)\"}"

What you get back

Every finished job carries a report alongside the files, so an agent can judge the result rather than guess at it:

{
  "stitches": 5583,       "colors": 2,
  "sizeMm": {"width": 67.7, "height": 64.7},
  "trims": 4,             "jumps": 6,
  "maxStitchMm": 4.53,    "fidelity": 68.4,
  "warnings": []
}

fidelity scores the stitched result against your original artwork (0–100). Designs that score too low are rejected outright rather than returned as a broken file. maxStitchMm is a machine-safety check — anything above about 12 mm will not sew cleanly, and we warn you before it reaches a machine.

Formats

pes (Brother), dst (Tajima), jef (Janome), exp (Melco), vp3 (Pfaff/Husqvarna), xxx (Singer), u01 (Barudan), pec, and svg for a vector preview. Every binary format is verified against pyembroidery, the reference library used by Ink/Stitch and others.

Limits and pricing

API exports count against the same export allowance as the app — an export is an export, wherever it comes from. Each format counts separately: asking for PES and DST in one request uses two of your exports. See pricing for the current tiers.

  • Uploads: PNG, up to 32 MB and 2400 px per side. Convert JPEG or WebP to PNG first.
  • Text: up to 200 characters, 3–200 mm cap height.
  • Rate limits: 20 design requests per minute; 120 reads per minute.
  • Download links expire 15 minutes after they are issued.
  • Previews are free — they produce no machine file, so they never consume quota.

Errors

Every error uses the same envelope, with a stable machine-readable code:

{"error": {"code": "QUOTA_EXCEEDED", "message": "...", "request_id": "..."}}

UNAUTHENTICATED (401), QUOTA_EXCEEDED (402), FORBIDDEN (403), NOT_FOUND (404), VALIDATION (422), RATE_LIMITED (429). Include the request_id if you need to ask us about a specific call.

Questions? Get in touch.