Skip to main content
Glama
Tunbi313

printify_mcp

by Tunbi313
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Hybrid

Printify MCP Server — Sunfade Co

A small, purpose-built MCP server that lets Claude create and publish print-on-demand products on Printify from reusable SKU templates.

The whole idea: you never hand-assemble Printify's 200-line product JSON. Claude calls create_from_template with ~5 fields and the server expands it.

1. Install

cd printify-mcp
pip install -r requirements.txt

Related MCP server: printify-mcp

2. Set your token (never hard-code it)

Create your token at: Printify → Account → Connections → API → Generate. Scopes needed: shops.read, products.read, products.write, uploads.read, uploads.write, print_providers.read.

export PRINTIFY_TOKEN="your_token_here"
export PRINTIFY_SHOP_ID="21788377"   # optional default shop

On Windows PowerShell:

$env:PRINTIFY_TOKEN="your_token_here"
$env:PRINTIFY_SHOP_ID="21788377"

3. Run standalone (sanity test)

python server.py

4. Connect to Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "printify-sunfade": {
      "command": "python",
      "args": ["/ABSOLUTE/PATH/printify-mcp/server.py"],
      "env": {
        "PRINTIFY_TOKEN": "your_token_here",
        "PRINTIFY_SHOP_ID": "21788377"
      }
    }
  }
}

Restart Claude Desktop. The tools appear automatically.

Tools

Tool

What it does

list_shops

List connected shops (id, title, channel)

list_templates

Show available SKU templates + artwork spec

upload_artwork(image_url, file_name)

Upload a PNG from a public URL → image_id

upload_artwork_file(file_path, file_name)

Upload a PNG from a local file (base64) → image_id

create_from_template(...)

Core. Make one product from a template (draft)

batch_create(template_name, items)

Make many products from already-uploaded images (paced)

scan_folder(folder_path)

List local image files in a folder, without uploading

batch_from_folder(template_name, items)

Upload local files and create products in one call (paced)

publish_product(product_id)

Push a product to the connected storefront

get_product(product_id)

Verify a product

list_print_providers(blueprint_id)

For adding new SKU templates

Typical flow

  1. Claude generates artwork → gets a public PNG URL (or saves a local file)

  2. upload_artwork(url, "Yosemite.png") or upload_artwork_file(path, "Yosemite.png") → image_id

  3. create_from_template("poster_matte_2x3", image_id, title, desc, tags) → draft

  4. Review with get_product

  5. publish_product(product_id) when ready

batch_create chains step 3 for a list of already-uploaded designs. scan_folder + batch_from_folder chain steps 2–3 for a whole folder of local files.

Current templates

Template

Product

Blueprint / Provider

Sizes / Price

Artwork spec

poster_matte_2x3

Satin & Archival Matte Poster

1309 / 234 (Today's Graphics)

12×18 $29, 20×30 $42, 24×36 $52

7200×10800 px PNG, 2:3, sRGB, full-bleed

canvas_2x3

Classic Stretched Canvas (1.5")

1238 / 48 (Colorway)

12×18 $69 … 24×36 $129

7200×10800 px PNG, 2:3, sRGB, full-bleed (same file as poster)

sticker

Square Sticker (die-cut, UV)

384 / 1 (SPOKE)

2×2 $5.99 … 6×6 $9.99

1800×1800 px PNG, 1:1, transparent bg

mug

Ceramic Mug 11oz (dye-sub)

68 / 1 (SPOKE)

11oz $21.99

2700×1119 px PNG, wraparound

tshirt

Unisex Softstyle Tee (Gildan 64000)

145 / 99

5 colors × 5 sizes, $29.99–$32.99

3852×4398 px PNG, transparent, front/back

hat

Trucker Hat (DTF)

1128 / 41 (Duplium)

5 colors, $28.99

1650×750 px PNG, 2.2:1, transparent

hat_vintage_a

Embroidery Dad Hat

1729 / 99

3 colors, $31.99

Text-only embroidery, front 1650×600, back 600×300

hat_vintage_b

Embroidery Vintage Cap

1736 / 99

4 colors, $35.99

Text-only embroidery, front 1650×600, back 600×300

candle

Scented Soy Candle 9oz

1048 / 219

3 scents, $26.99

900×600 px PNG, 3:2 label

tumbler

SPOKE Tumbler 20oz

353 / 1

20oz $40.83

2795×2100 px PNG, wraparound

stein_mug

Ceramic Stein Mug 22oz (dye-sub)

891 / 41 (Duplium)

22oz $25.50

2250×900 px PNG, 2.5:1 wraparound, full-bleed

pillow_damask

Outdoor Pillow, double-sided

1007 / 10

16×16/18×18/20×20 $33.99

1254–3225 px square PNG, full-bleed, no transparency

pillow_woven

Boho Woven Pillow

1650 / 10

17×18 $47.99

1728×1824 px, bold color-blocks only (no gradients/fine detail)

pillow_body

Body Pillow 20×54, double-sided

2758 / 10

Microfiber $95.43, Fleece $108.23

8325×3225 px JPEG, ~2.58:1, pattern spans full width

can_glass_engraved

Can Glass 16oz (laser engraving)

2759 / 228

16oz $24.25

1200×1800 px PNG, transparent = not engraved, line art only

Full spec per template (finish options, decoration method, placeholder transform, style notes) lives in the TEMPLATES dict in server.py.

Adding a new SKU template (mug, sticker, etc.)

  1. Create ONE product of that type manually in Printify, enable only the variants you want, save as draft.

  2. GET its JSON:

    curl.exe -H "Authorization: Bearer $TOKEN" \
  "https://api.printify.com/v1/shops/SHOP_ID/products/PRODUCT_ID.json" > sku.json

  3. From the JSON, copy: blueprint_id, print_provider_id, the enabled variant ids, and the print_areas[0].placeholders[0].images[0] transform (x, y, scale, angle).

  4. Add an entry to TEMPLATES in server.py following the poster example.

  5. Restart the server.

Notes / gotchas

  • Prices are in cents (2900 = $29.00).

  • Products are created as drafts (unpublished). Nothing goes live until you call publish_product.

  • publish_product only works against a real connected storefront (Shopify), not the API custom_integration placeholder shop. Connect Sunfade Co in Printify → Add store → Shopify first.

  • Rate limits: global 600 req/min; publish 200/30min. batch_create paces at ~1/sec, well under both. 429s are retried with backoff automatically.

  • Base costs shown are Free-plan. Printify Premium (~20% off) improves margins.

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivitySlowing
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Printify MCP

    Plaaasma
    A
    license
    Not graded
    quality
    C
    maintenance
    Enables AI assistants to run a print-on-demand store by creating products on Printify, pricing from production cost, publishing to Shopify and its sales channels, and generating ad creative from mockups.
    1
    ISC