Developers & Agents

Plixely is the output rail for AI images: your agent or app brings an image, Plixely turns it into a real, print-ready sticker and ships it (US & Canada, domestic). Plixely does not generate images. Two equal front doors: a REST API and MCP tools — same pipeline behind both.

The flow

1. create preview (image → preview + price + options) → 2. show it + confirm → 3. place order (charge + fulfill) → 4. track. We never charge or fulfill without a confirmed preview.

REST · 1) Create a preview

POST https://plixely.web.app/v1/stickers/preview
Content-Type: application/json

{
  "photo_b64": "<base64 image, data: prefix ok>",
  "size_in": 3,                 // longest edge, inches
  "fmt": "die-cut",             // die-cut | kiss-cut | sheet
  "finish": "glossy",            // matte | glossy | holographic
  "currency": "USD"             // USD | CAD
}

→ 200 {
  "ok": true, "preview_id": "pv_…", "preview_url": "…",
  "price_cents": 1599, "finish": "glossy", "eta_days": 4,
  "ladder": [ { "key":"sheet", "fmt":"sheet", "qty":1,
                "price_cents":1599, "per_unit_cents":133 }, … ]
}

ladder = the purchasable options for this design. Sheets (≈12 stickers each, best value) + a premium contour single & 3-pack. Pick one and pass its fmt/qty/finish to place_order.

REST · 2) Place the order

POST https://plixely.web.app/v1/stickers/order
{
  "preview_id": "pv_…",
  "fmt": "sheet", "qty": 3, "finish": "glossy",   // a ladder option
  "address": { "name":"Ada", "line1":"1 Main St", "city":"Boston",
               "state":"MA", "postal_code":"02101", "country":"US" }
}
→ 201 { "ok": true, "id": "…", "status": "in_production",
        "price_cents": 3099, "tracking_url": "…", "eta_days": 4 }

REST · 3) Track

GET https://plixely.web.app/v1/stickers/order/{order_id}
→ { "ok": true, "status": "shipped", "tracking_url": "…" }

MCP — callable by Claude (and any MCP client) directly

Add the server to your MCP client:

{ "mcpServers": { "plixely": {
    "command": "python", "args": ["mcp_server.py"],
    "cwd": "/path/to/plixely" } } }

Tools:

create_preview(photo_b64, size_in=3, finish="glossy", fmt="die-cut", currency="USD") → preview_id, price_cents, ladder. Show + confirm first.
place_order(preview_id, name, line1, city, postal_code, country="US", state="", fmt="", qty=0, finish="") → order id + tracking.
track_order(order_id) → status + tracking.

Options reference

Field	Values	Notes
fmt	die-cut · kiss-cut · sheet	die-cut = US only; kiss-cut = US+CA; sheet ≈ 12 stickers
size_in	die-cut 2–6 · kiss-cut 3/4/5.5	longest edge, inches
finish	glossy · holographic	glossy is the default; holographic is kiss-cut only
currency	USD · CAD	both ship domestically; Canada via the CA facility

Rules & notes

Confirm before charge — always create_preview → show price → then place_order.
US & Canada only, fulfilled domestically in each (no cross-border / duties). Die-cut is US-only.
Print-readiness — low-res/blurry images are flagged with the honest print DPI before order.
Sizes/finishes mirror the specs page; prices are live (USD/CAD).

Questions? Contact support · Sizes & specs