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.studio/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",            // glossy | holographic (kiss-cut only)
  "currency": "USD"             // USD | CAD
}

→ 200 {
  "ok": true, "preview_id": "pv_…", "preview_url": "…",
  "price_cents": 1299, "finish": "glossy", "eta_days": 4,
  "share_url": "https://plixely.studio/s/pv_…",   // public share page — creator earns their set markup on every order
  "ladder": [ { "key":"sheet", "fmt":"sheet", "qty":1,
                "price_cents":1299, "per_unit_cents":108 }, … ]
}

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.studio/v1/stickers/order
{
  "preview_id": "pv_…",
  "fmt": "sheet", "qty": 3, "finish": "glossy",   // a ladder option
  "email": "ada@example.com",     // buyer email — confirmation + tracking (always pass it)
  "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": 2499, "tracking_url": "…", "eta_days": 4 }

REST · 3) Track

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

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

Remote server (recommended) — live, nothing to install. Add it as a custom connector:

https://plixely.studio/mcp

In Claude: Settings → Connectors → Add custom connector → paste the URL. Works with any Streamable-HTTP MCP client.

Local/dev (stdio) alternative:

{ "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, share_url. Show + confirm first.
place_order(preview_id, name, line1, city, postal_code, country="US", state="", fmt="", qty=0, finish="", email="") → order id + tracking. Always pass the buyer's email — it delivers their confirmation & shipping updates, and lets them claim the order into an account later.
track_order(order_id) → status + tracking.

Errors & quality signals

Failures return { "ok": false, "error": "human-readable reason" } (HTTP 422 on REST). Previews include print_dpi, quality, and — for low-resolution sources — quality_warning (e.g. "this will print at ~150 DPI"). Surface the warning before ordering: blurry stickers are the #1 refund cause, and we'd rather lose the order than ship a bad one.

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