Printify MCP by usefulapi is an MCP server published by io.usefulapi, hosted at printify.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 25 tools, including printify_create_order, printify_send_to_production, printify_create_webhook, printify_delete_webhook, printify_update_product_prices.
Read shops, catalog blueprints, print providers, products and orders; create and publish products.
4,046 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
WRITE: preview an order of existing enabled product variants in an API/custom-integration store. Set this exact store to Manual approval in Printify BEFORE confirmation, then pass manual_approval_confirmed:true, confirm:true and the approved preview_hash. The API cannot verify Manual approval; auto-approval can otherwise cause production/charges. Persistent operation_id prevents automatic duplicate creation. Does not submit production or send shipping notifications.
| Parameter | Type | Description |
|---|---|---|
| label | string | |
| confirm | boolean | |
| shop_id * | any | |
| address_to * |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| object |
| line_items * | array |
| operation_id * | string |
| preview_hash | string |
| shipping_method * | integer |
| manual_approval_confirmed | boolean | Confirm that this exact API store was set to Manual order approval in Printify before creating the order. The public API cannot verify this setting. |
{
"name": "printify_create_order",
"title": "Preview or create an unsubmitted order",
"description": "WRITE: preview an order of existing enabled product variants in an API/custom-integration store. Set this exact store to Manual approval in Printify BEFORE confirmation, then pass manual_approval_confirmed:true, confirm:true and the approved preview_hash. The API cannot verify Manual approval; auto-approval can otherwise cause production/charges. Persistent operation_id prevents automatic duplicate creation. Does not submit production or send shipping notifications.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"operation_id",
"shop_id",
"line_items",
"address_to",
"shipping_method"
],
"properties": {
"label": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"confirm": {
"type": "boolean"
},
"shop_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
]
},
"address_to": {
"type": "object",
"required": [
"first_name",
"last_name",
"email",
"phone",
"country",
"region",
"address1",
"city",
"zip"
],
"properties": {
"zip": {
"type": "string",
"maxLength": 30,
"minLength": 1
},
"city": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"email": {
"type": "string",
"format": "email",
"pattern": "^(?:[A-Za-z0-9_'+\\-]+\\.)*[A-Za-z0-9_'+\\-]*[A-Za-z0-9_+-]@(?:[A-Za-z0-9][A-Za-z0-9\\-]*\\.)+[A-Za-z]{2,}$",
"maxLength": 254
},
"phone": {
"type": "string",
"maxLength": 50,
"minLength": 1
},
"region": {
"type": "string",
"maxLength": 100
},
"company": {
"type": "string",
"maxLength": 100
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"address1": {
"type": "string",
"maxLength": 200,
"minLength": 1
},
"address2": {
"type": "string",
"maxLength": 200
},
"last_name": {
"type": "string",
"maxLength": 100,
"minLength": 1
},
"first_name": {
"type": "string",
"maxLength": 100,
"minLength": 1
}
}
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"product_id",
"variant_id",
"quantity"
],
"properties": {
"quantity": {
"type": "integer",
"maximum": 10000,
"minimum": 1
},
"product_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"variant_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"maxItems": 20,
"minItems": 1
},
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,100}$"
},
"preview_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"shipping_method": {
"type": "integer",
"maximum": 4,
"minimum": 1
},
"manual_approval_confirmed": {
"type": "boolean",
"description": "Confirm that this exact API store was set to Manual order approval in Printify before creating the order. The public API cannot verify this setting."
}
}
},
"annotations": {
"title": "Preview or create order",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: separately preview and approve production of an existing order, including its destination and fulfillment costs. Can charge your linked Printify payment method. Requires production_charge_approved:true, confirm:true and preview_hash; use the same operation_id for retries. Uncertain submissions are never replayed.
| Parameter | Type | Description |
|---|---|---|
| confirm | boolean | |
| shop_id * | any | |
| order_id * | string | |
| operation_id * | string | |
| preview_hash | string | |
| production_charge_approved | boolean |
{
"name": "printify_send_to_production",
"title": "Preview or submit an order to production",
"description": "WRITE: separately preview and approve production of an existing order, including its destination and fulfillment costs. Can charge your linked Printify payment method. Requires production_charge_approved:true, confirm:true and preview_hash; use the same operation_id for retries. Uncertain submissions are never replayed.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"operation_id",
"shop_id",
"order_id"
],
"properties": {
"confirm": {
"type": "boolean"
},
"shop_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
]
},
"order_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,100}$"
},
"preview_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"production_charge_approved": {
"type": "boolean"
}
}
},
"annotations": {
"title": "Submit order to production",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: preview an order/shipment topic and HTTPS receiver; confirm with preview_hash to register it. Uses the signing secret configured securely on the connection, never a tool argument or result. Shares event data with that receiver. Verify X-Pfy-Signature at your receiver; API acceptance is not proof of signature delivery. Duplicate/uncertain attempts are not blindly replayed.
| Parameter | Type | Description |
|---|---|---|
| url * | string | |
| topic * | string | one of ["order:created","order:updated","order:sent-to-production","order:shipment:created","order:shipment:delivered"] |
| confirm | boolean | |
| shop_id * | any | |
| operation_id * | string | |
| preview_hash | string |
{
"name": "printify_create_webhook",
"title": "Preview or create a signed order webhook",
"description": "WRITE: preview an order/shipment topic and HTTPS receiver; confirm with preview_hash to register it. Uses the signing secret configured securely on the connection, never a tool argument or result. Shares event data with that receiver. Verify X-Pfy-Signature at your receiver; API acceptance is not proof of signature delivery. Duplicate/uncertain attempts are not blindly replayed.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"operation_id",
"shop_id",
"topic",
"url"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2000
},
"topic": {
"enum": [
"order:created",
"order:updated",
"order:sent-to-production",
"order:shipment:created",
"order:shipment:delivered"
],
"type": "string"
},
"confirm": {
"type": "boolean"
},
"shop_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
]
},
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,100}$"
},
"preview_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
},
"annotations": {
"title": "Create signed order webhook",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: preview a shop's selected webhook, check expected_host against its destination, then confirm with preview_hash to delete only that webhook. Uses Printify's required host query safeguard and persistent operation deduplication.
| Parameter | Type | Description |
|---|---|---|
| confirm | boolean | |
| shop_id * | any | |
| webhook_id * | string | |
| operation_id * | string | |
| preview_hash | string | |
| expected_host * | string |
{
"name": "printify_delete_webhook",
"title": "Preview or delete a webhook",
"description": "WRITE: preview a shop's selected webhook, check expected_host against its destination, then confirm with preview_hash to delete only that webhook. Uses Printify's required host query safeguard and persistent operation deduplication.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"operation_id",
"shop_id",
"webhook_id",
"expected_host"
],
"properties": {
"confirm": {
"type": "boolean"
},
"shop_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
]
},
"webhook_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,100}$"
},
"preview_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"expected_host": {
"type": "string",
"pattern": "^[A-Za-z0-9.-]+$",
"maxLength": 253
}
}
},
"annotations": {
"title": "Delete webhook",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: preview integer-cent retail price changes on selected variants. Confirm with preview_hash to update Printify, preserving all other variants, flags, SKUs and defaults; verify readback. Does not publish to an external sales channel. Reuse operation_id rather than blindly repeating an uncertain update.
| Parameter | Type | Description |
|---|---|---|
| prices * | array | |
| confirm | boolean | |
| shop_id * | any | |
| product_id * | string | |
| operation_id * | string | |
| preview_hash | string |
{
"name": "printify_update_product_prices",
"title": "Preview or update variant retail prices",
"description": "WRITE: preview integer-cent retail price changes on selected variants. Confirm with preview_hash to update Printify, preserving all other variants, flags, SKUs and defaults; verify readback. Does not publish to an external sales channel. Reuse operation_id rather than blindly repeating an uncertain update.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"operation_id",
"shop_id",
"product_id",
"prices"
],
"properties": {
"prices": {
"type": "array",
"items": {
"type": "object",
"required": [
"variant_id",
"price"
],
"properties": {
"price": {
"type": "integer",
"maximum": 100000000,
"minimum": 0,
"description": "New retail price in cents, as an integer."
},
"variant_id": {
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
}
},
"maxItems": 100,
"minItems": 1
},
"confirm": {
"type": "boolean"
},
"shop_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
]
},
"product_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,100}$"
},
"preview_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
},
"annotations": {
"title": "Update product retail prices",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: add artwork to the account's Printify media library, from a public HTTPS url (Printify downloads it) or plain base64 contents up to about 2.9 MB. Preview first, then confirm with preview_hash; reuse operation_id on a retry. Returns the image id for printify_create_product. Printify: POST /v1/uploads/images.json.
| Parameter | Type | Description |
|---|---|---|
| url | string | Public HTTPS URL of the image. Printify downloads it; this server does not. |
| confirm | boolean | |
| shop_id * | any | |
| contents | string | The image as plain base64, up to about 2.9 MB. Use url for larger files. |
| file_name * | string | File name for the media library, e.g. hat-logo.png. |
| operation_id * | string | |
| preview_hash | string |
{
"name": "printify_upload_image",
"title": "Preview or upload an image",
"description": "WRITE: add artwork to the account's Printify media library, from a public HTTPS url (Printify downloads it) or plain base64 contents up to about 2.9 MB. Preview first, then confirm with preview_hash; reuse operation_id on a retry. Returns the image id for printify_create_product. Printify: POST /v1/uploads/images.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"operation_id",
"shop_id",
"file_name"
],
"properties": {
"url": {
"type": "string",
"format": "uri",
"maxLength": 2000,
"description": "Public HTTPS URL of the image. Printify downloads it; this server does not."
},
"confirm": {
"type": "boolean"
},
"shop_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
]
},
"contents": {
"type": "string",
"pattern": "^[A-Za-z0-9+/]+={0,2}$",
"maxLength": 3900000,
"minLength": 4,
"description": "The image as plain base64, up to about 2.9 MB. Use url for larger files."
},
"file_name": {
"type": "string",
"pattern": "^[^/\\\\\\x00-\\x1f]{1,200}$",
"description": "File name for the media library, e.g. hat-logo.png."
},
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,100}$"
},
"preview_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
}
}
},
"annotations": {
"title": "Upload image",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}WRITE: create a draft product from a catalog blueprint and print provider, with the variants to sell (retail price in cents) and the artwork placements. Positions come from printify_get_variants placeholders; an embroidery position (for example on caps) selects embroidery. The preview checks every variant, position and image against the catalog and media library. Confirm with preview_hash; reuse operation_id on a retry. Never publishes or orders: use printify_publish_product separately. Printify: POST /v1/shops/{shop_id}/products.json.
| Parameter | Type | Description |
|---|---|---|
| title * | string | |
| confirm | boolean | |
| shop_id * | any | |
| variants * | array | The variants to sell, each with its retail price. Other variants of the blueprint are added disabled. |
| placements * | array | The artwork: one entry per image and position. Every selected variant gets the same placements. |
| description * | string | Product description (HTML allowed by Printify). |
| blueprint_id * | integer | Catalog blueprint id (printify_list_catalog_blueprints). |
| operation_id * | string | |
| preview_hash | string | |
| print_provider_id * | integer | Print provider id for the blueprint (printify_get_print_providers). |
{
"name": "printify_create_product",
"title": "Preview or create a draft product",
"description": "WRITE: create a draft product from a catalog blueprint and print provider, with the variants to sell (retail price in cents) and the artwork placements. Positions come from printify_get_variants placeholders; an embroidery position (for example on caps) selects embroidery. The preview checks every variant, position and image against the catalog and media library. Confirm with preview_hash; reuse operation_id on a retry. Never publishes or orders: use printify_publish_product separately. Printify: POST /v1/shops/{shop_id}/products.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"operation_id",
"shop_id",
"title",
"description",
"blueprint_id",
"print_provider_id",
"variants",
"placements"
],
"properties": {
"title": {
"type": "string",
"maxLength": 255,
"minLength": 1
},
"confirm": {
"type": "boolean"
},
"shop_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
]
},
"variants": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"price"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Variant id from printify_get_variants.",
"exclusiveMinimum": 0
},
"price": {
"type": "integer",
"maximum": 100000000,
"minimum": 1,
"description": "Retail price in cents, at least 1."
}
}
},
"maxItems": 300,
"minItems": 1,
"description": "The variants to sell, each with its retail price. Other variants of the blueprint are added disabled."
},
"placements": {
"type": "array",
"items": {
"type": "object",
"required": [
"position",
"image_id"
],
"properties": {
"x": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Horizontal center, 0-1 of the print area (default 0.5)."
},
"y": {
"type": "number",
"maximum": 1,
"minimum": 0,
"description": "Vertical center, 0-1 of the print area (default 0.5)."
},
"angle": {
"type": "integer",
"maximum": 360,
"minimum": -360,
"description": "Rotation in degrees (default 0)."
},
"scale": {
"type": "number",
"maximum": 10,
"description": "Image width relative to the print area width (default 1).",
"exclusiveMinimum": 0
},
"image_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$",
"description": "Image id from printify_upload_image or printify_list_uploads."
},
"position": {
"type": "string",
"pattern": "^[a-z0-9_]{1,100}$",
"description": "Print position from printify_get_variants placeholders, e.g. front, or an embroidery position such as large_center_embroidery. The position decides the decoration method."
}
}
},
"maxItems": 10,
"minItems": 1,
"description": "The artwork: one entry per image and position. Every selected variant gets the same placements."
},
"description": {
"type": "string",
"maxLength": 20000,
"description": "Product description (HTML allowed by Printify)."
},
"blueprint_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Catalog blueprint id (printify_list_catalog_blueprints).",
"exclusiveMinimum": 0
},
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,100}$"
},
"preview_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"print_provider_id": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Print provider id for the blueprint (printify_get_print_providers).",
"exclusiveMinimum": 0
}
}
},
"annotations": {
"title": "Create draft product",
"readOnlyHint": false,
"idempotentHint": true,
"destructiveHint": true
}
}Read the persistent state and known resource IDs for an operation on this connection in a shop authorized by the current token. Does not create, submit, update or delete anything. Reconcile an uncertain attempt before doing further writes or rotating the token; operation history is scoped to the original connection identity.
| Parameter | Type | Description |
|---|---|---|
| shop_id * | any | |
| operation_id * | string |
{
"name": "printify_write_operation_status",
"title": "Check write operation",
"description": "Read the persistent state and known resource IDs for an operation on this connection in a shop authorized by the current token. Does not create, submit, update or delete anything. Reconcile an uncertain attempt before doing further writes or rotating the token; operation history is scoped to the original connection identity.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"shop_id",
"operation_id"
],
"properties": {
"shop_id": {
"anyOf": [
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
},
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
]
},
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,100}$"
}
}
},
"annotations": {
"title": "Check write operation",
"readOnlyHint": true
}
}Preview or copy selected products or a complete catalog between two Printify shops in the same account. Preserves title, description, blueprint/provider, variant IDs/prices/enabled flags, artwork IDs and print-area transforms. Preserves canvas side printing and image pattern rotation. This initial workflow does not copy tags, SKUs, channel IDs, publication state or generated mockups. Products with text/personalization layers are explicitly refused because their creation fields are read-only. Preview by default. confirm:true starts/resumes a durable bounded job; save job_id and keep calling with that job_id and confirm:true until complete. Duplicate prevention remembers copies made by this connector, including across restarts/jobs; pre-existing copies made elsewhere are not detected. An uncertain create is never automatically retried: inspect the target and use printify_resolve_copy. Do not change the source catalog during an all-products run. Requires shops.read/products.read/products.write. Confirmed copying requires the hosted connector's durable coordinator.
| Parameter | Type | Description |
|---|---|---|
| job_id | string | A previously returned job_id to resume; supply the same source and target shops. |
| confirm | boolean | False/omitted previews only. True authorizes creation of new draft products. |
| batch_size | integer | Maximum creates in this call (default 1). Calls are also bounded when skipping prior copies. |
| product_ids | array | Selected source product IDs; mutually exclusive with all_products:true. Omit when resuming job_id. |
| all_products | boolean | Copy all source products with resumable pagination. Omit when resuming job_id. |
| start_new_job | boolean | With confirm:true and a selection, restart enumeration after source-catalog changes; never combine with job_id. Permanent copied and uncertain mappings are retained. |
| source_shop_id * | any | Source shop ID; the token must have access to both shops in the same Printify account. |
| target_shop_id * | any | Different target shop ID. New products stay as drafts and are not published. |
{
"name": "printify_copy_products",
"title": "Copy products between shops",
"description": "Preview or copy selected products or a complete catalog between two Printify shops in the same account. Preserves title, description, blueprint/provider, variant IDs/prices/enabled flags, artwork IDs and print-area transforms. Preserves canvas side printing and image pattern rotation. This initial workflow does not copy tags, SKUs, channel IDs, publication state or generated mockups. Products with text/personalization layers are explicitly refused because their creation fields are read-only. Preview by default. confirm:true starts/resumes a durable bounded job; save job_id and keep calling with that job_id and confirm:true until complete. Duplicate prevention remembers copies made by this connector, including across restarts/jobs; pre-existing copies made elsewhere are not detected. An uncertain create is never automatically retried: inspect the target and use printify_resolve_copy. Do not change the source catalog during an all-products run. Requires shops.read/products.read/products.write. Confirmed copying requires the hosted connector's durable coordinator.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"source_shop_id",
"target_shop_id"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$",
"description": "A previously returned job_id to resume; supply the same source and target shops."
},
"confirm": {
"type": "boolean",
"description": "False/omitted previews only. True authorizes creation of new draft products."
},
"batch_size": {
"type": "integer",
"maximum": 3,
"minimum": 1,
"description": "Maximum creates in this call (default 1). Calls are also bounded when skipping prior copies."
},
"product_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"maxItems": 100,
"minItems": 1,
"description": "Selected source product IDs; mutually exclusive with all_products:true. Omit when resuming job_id."
},
"all_products": {
"type": "boolean",
"description": "Copy all source products with resumable pagination. Omit when resuming job_id."
},
"start_new_job": {
"type": "boolean",
"description": "With confirm:true and a selection, restart enumeration after source-catalog changes; never combine with job_id. Permanent copied and uncertain mappings are retained."
},
"source_shop_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Source shop ID; the token must have access to both shops in the same Printify account."
},
"target_shop_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Different target shop ID. New products stay as drafts and are not published."
}
}
},
"annotations": {
"title": "Copy products between shops",
"idempotentHint": true,
"destructiveHint": true
}
}Read a durable product-copy job's progress, target mappings, failures and uncertain writes. Verifies that the current token can access both shops. Does not create or retry products.
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | |
| entry_limit | integer | Job entries per status page (default 20). |
| entry_cursor | string | next_cursor from a previous status page; lists all entries including older failures. |
| source_shop_id * | any | Source shop ID; the token must have access to both shops in the same Printify account. |
| target_shop_id * | any | Different target shop ID. New products stay as drafts and are not published. |
{
"name": "printify_copy_status",
"title": "Check product copy progress",
"description": "Read a durable product-copy job's progress, target mappings, failures and uncertain writes. Verifies that the current token can access both shops. Does not create or retry products.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"source_shop_id",
"target_shop_id",
"job_id"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"entry_limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Job entries per status page (default 20)."
},
"entry_cursor": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$",
"description": "next_cursor from a previous status page; lists all entries including older failures."
},
"source_shop_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Source shop ID; the token must have access to both shops in the same Printify account."
},
"target_shop_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Different target shop ID. New products stay as drafts and are not published."
}
}
},
"annotations": {
"title": "Check product copy progress",
"readOnlyHint": true
}
}Resolve one failed or uncertain source product in a durable copy job. Provide an existing target_product_id to verify the exact supported fields against the checkpoint and record it as copied. Or set verified_not_created:true only after checking the target shop manually; this allows one future retry through printify_copy_products. Requires confirm:true, never creates/publishes/deletes anything itself. An ambiguous write must never be blindly retried.
| Parameter | Type | Description |
|---|---|---|
| job_id * | string | |
| confirm * | boolean | |
| source_shop_id * | any | Source shop ID; the token must have access to both shops in the same Printify account. |
| target_shop_id * | any | Different target shop ID. New products stay as drafts and are not published. |
| source_product_id * | string | |
| target_product_id | string | |
| verified_not_created | boolean |
{
"name": "printify_resolve_copy",
"title": "Resolve an uncertain product copy",
"description": "Resolve one failed or uncertain source product in a durable copy job. Provide an existing target_product_id to verify the exact supported fields against the checkpoint and record it as copied. Or set verified_not_created:true only after checking the target shop manually; this allows one future retry through printify_copy_products. Requires confirm:true, never creates/publishes/deletes anything itself. An ambiguous write must never be blindly retried.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"source_shop_id",
"target_shop_id",
"job_id",
"source_product_id",
"confirm"
],
"properties": {
"job_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"confirm": {
"type": "boolean"
},
"source_shop_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Source shop ID; the token must have access to both shops in the same Printify account."
},
"target_shop_id": {
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
{
"type": "integer",
"maximum": 9007199254740991,
"exclusiveMinimum": 0
}
],
"description": "Different target shop ID. New products stay as drafts and are not published."
},
"source_product_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"target_product_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"verified_not_created": {
"type": "boolean"
}
}
},
"annotations": {
"title": "Resolve an uncertain product copy",
"idempotentHint": true,
"destructiveHint": true
}
}List all shops connected to the Printify account. This is the entry point — each shop's `id` is required by the product, order and webhook tools. Printify REST: GET /v1/shops.json.
No parameters.
{
"name": "printify_list_shops",
"title": "List shops",
"description": "List all shops connected to the Printify account. This is the entry point — each shop's `id` is required by the product, order and webhook tools. Printify REST: GET /v1/shops.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List shops",
"readOnlyHint": true
}
}List products in a shop (paginated). Printify REST: GET /v1/shops/{shop_id}/products.json.
| Parameter | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Items per page (default 10, max 50). |
| shop_id * | any | Shop id (from printify_list_shops) — required. |
{
"name": "printify_list_products",
"title": "List products",
"description": "List products in a shop (paginated). Printify REST: GET /v1/shops/{shop_id}/products.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"shop_id"
],
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"limit": {
"type": "integer",
"maximum": 50,
"minimum": 1,
"description": "Items per page (default 10, max 50)."
},
"shop_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Shop id (from printify_list_shops) — required."
}
}
},
"annotations": {
"title": "List products",
"readOnlyHint": true
}
}Get a single product's full details (variants, images, print areas, publish status). Printify REST: GET /v1/shops/{shop_id}/products/{product_id}.json.
| Parameter | Type | Description |
|---|---|---|
| shop_id * | any | Shop id — required. |
| product_id * | any | Product id — required. |
{
"name": "printify_get_product",
"title": "Get product",
"description": "Get a single product's full details (variants, images, print areas, publish status). Printify REST: GET /v1/shops/{shop_id}/products/{product_id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"shop_id",
"product_id"
],
"properties": {
"shop_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Shop id — required."
},
"product_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Product id — required."
}
}
},
"annotations": {
"title": "Get product",
"readOnlyHint": true
}
}List orders in a shop (paginated), optionally filtered by status or SKU. Printify REST: GET /v1/shops/{shop_id}/orders.json.
| Parameter | Type | Description |
|---|---|---|
| sku | string | Filter to orders containing this SKU. |
| page | integer | 1-based page number. |
| limit | integer | Items per page (default 10, max 10). |
| status | string | Filter by fulfillment status, e.g. 'fulfilled'. |
| shop_id * | any | Shop id — required. |
{
"name": "printify_list_orders",
"title": "List orders",
"description": "List orders in a shop (paginated), optionally filtered by status or SKU. Printify REST: GET /v1/shops/{shop_id}/orders.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"shop_id"
],
"properties": {
"sku": {
"type": "string",
"description": "Filter to orders containing this SKU."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"limit": {
"type": "integer",
"maximum": 10,
"minimum": 1,
"description": "Items per page (default 10, max 10)."
},
"status": {
"type": "string",
"description": "Filter by fulfillment status, e.g. 'fulfilled'."
},
"shop_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Shop id — required."
}
}
},
"annotations": {
"title": "List orders",
"readOnlyHint": true
}
}Get a single order's full details, including `shipments` (carrier + tracking numbers). Printify REST: GET /v1/shops/{shop_id}/orders/{order_id}.json.
| Parameter | Type | Description |
|---|---|---|
| shop_id * | any | Shop id — required. |
| order_id * | any | Order id — required. |
{
"name": "printify_get_order",
"title": "Get order",
"description": "Get a single order's full details, including `shipments` (carrier + tracking numbers). Printify REST: GET /v1/shops/{shop_id}/orders/{order_id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"shop_id",
"order_id"
],
"properties": {
"shop_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Shop id — required."
},
"order_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Order id — required."
}
}
},
"annotations": {
"title": "Get order",
"readOnlyHint": true
}
}Get a shipping price quote for a set of line items to a destination address. Non-destructive — it only prices, it does NOT place an order. `line_items` is an array where each item is one of {product_id, variant_id, quantity}, {print_provider_id, blueprint_id, variant_id, quantity}, or {sku, quantity}. `address_to` is the destination (first_name, last_name, email, phone, country, region, address1, address2, city, zip, company). Printify REST: POST /v1/shops/{shop_id}/orders/shipping.json.
| Parameter | Type | Description |
|---|---|---|
| shop_id * | any | Shop id — required. |
| address_to * | object | Destination address object. |
| line_items * | array | Array of line items to price (see description for accepted shapes). |
{
"name": "printify_calculate_shipping",
"title": "Calculate shipping",
"description": "Get a shipping price quote for a set of line items to a destination address. Non-destructive — it only prices, it does NOT place an order. `line_items` is an array where each item is one of {product_id, variant_id, quantity}, {print_provider_id, blueprint_id, variant_id, quantity}, or {sku, quantity}. `address_to` is the destination (first_name, last_name, email, phone, country, region, address1, address2, city, zip, company). Printify REST: POST /v1/shops/{shop_id}/orders/shipping.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"shop_id",
"line_items",
"address_to"
],
"properties": {
"shop_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Shop id — required."
},
"address_to": {
"type": "object",
"description": "Destination address object.",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"minItems": 1,
"description": "Array of line items to price (see description for accepted shapes)."
}
}
},
"annotations": {
"title": "Calculate shipping",
"readOnlyHint": true
}
}List all blueprints (product types, e.g. 'Unisex T-Shirt') available in the Printify catalog. Printify REST: GET /v1/catalog/blueprints.json.
No parameters.
{
"name": "printify_list_catalog_blueprints",
"title": "List catalog blueprints",
"description": "List all blueprints (product types, e.g. 'Unisex T-Shirt') available in the Printify catalog. Printify REST: GET /v1/catalog/blueprints.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List catalog blueprints",
"readOnlyHint": true
}
}Get a single catalog blueprint's details. Printify REST: GET /v1/catalog/blueprints/{blueprint_id}.json.
| Parameter | Type | Description |
|---|---|---|
| blueprint_id * | any | Blueprint id — required. |
{
"name": "printify_get_blueprint",
"title": "Get blueprint",
"description": "Get a single catalog blueprint's details. Printify REST: GET /v1/catalog/blueprints/{blueprint_id}.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"blueprint_id"
],
"properties": {
"blueprint_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Blueprint id — required."
}
}
},
"annotations": {
"title": "Get blueprint",
"readOnlyHint": true
}
}List the print providers that can produce a given blueprint. Printify REST: GET /v1/catalog/blueprints/{blueprint_id}/print_providers.json.
| Parameter | Type | Description |
|---|---|---|
| blueprint_id * | any | Blueprint id — required. |
{
"name": "printify_get_print_providers",
"title": "Get blueprint print providers",
"description": "List the print providers that can produce a given blueprint. Printify REST: GET /v1/catalog/blueprints/{blueprint_id}/print_providers.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"blueprint_id"
],
"properties": {
"blueprint_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Blueprint id — required."
}
}
},
"annotations": {
"title": "Get blueprint print providers",
"readOnlyHint": true
}
}List the variants (sizes, colors) a print provider offers for a blueprint. Printify REST: GET /v1/catalog/blueprints/{blueprint_id}/print_providers/{print_provider_id}/variants.json.
| Parameter | Type | Description |
|---|---|---|
| blueprint_id * | any | Blueprint id — required. |
| print_provider_id * | any | Print provider id — required. |
| show_out_of_stock | boolean | Include out-of-stock variants (sent as show-out-of-stock=1). |
{
"name": "printify_get_variants",
"title": "Get variants",
"description": "List the variants (sizes, colors) a print provider offers for a blueprint. Printify REST: GET /v1/catalog/blueprints/{blueprint_id}/print_providers/{print_provider_id}/variants.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"blueprint_id",
"print_provider_id"
],
"properties": {
"blueprint_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Blueprint id — required."
},
"print_provider_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Print provider id — required."
},
"show_out_of_stock": {
"type": "boolean",
"description": "Include out-of-stock variants (sent as show-out-of-stock=1)."
}
}
},
"annotations": {
"title": "Get variants",
"readOnlyHint": true
}
}List all print providers in the Printify catalog. Printify REST: GET /v1/catalog/print_providers.json.
No parameters.
{
"name": "printify_list_print_providers",
"title": "List print providers",
"description": "List all print providers in the Printify catalog. Printify REST: GET /v1/catalog/print_providers.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
},
"annotations": {
"title": "List print providers",
"readOnlyHint": true
}
}List the webhooks configured for a shop. Printify REST: GET /v1/shops/{shop_id}/webhooks.json.
| Parameter | Type | Description |
|---|---|---|
| shop_id * | any | Shop id — required. |
{
"name": "printify_list_webhooks",
"title": "List webhooks",
"description": "List the webhooks configured for a shop. Printify REST: GET /v1/shops/{shop_id}/webhooks.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"shop_id"
],
"properties": {
"shop_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Shop id — required."
}
}
},
"annotations": {
"title": "List webhooks",
"readOnlyHint": true
}
}List images uploaded to the account's media library (paginated). Printify REST: GET /v1/uploads.json.
| Parameter | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Items per page (default 10, max 100). |
{
"name": "printify_list_uploads",
"title": "List uploads",
"description": "List images uploaded to the account's media library (paginated). Printify REST: GET /v1/uploads.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "1-based page number."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Items per page (default 10, max 100)."
}
}
},
"annotations": {
"title": "List uploads",
"readOnlyHint": true
}
}Publish a product to the shop's connected sales channel (e.g. Shopify, Etsy). STATE-CHANGING: this locks the product and pushes the selected fields to the external store. The body is an object of booleans controlling which fields are published; all default to true. Printify REST: POST /v1/shops/{shop_id}/products/{product_id}/publish.json.
| Parameter | Type | Description |
|---|---|---|
| tags | boolean | Publish the tags (default true). |
| title | boolean | Publish the title (default true). |
| images | boolean | Publish the images (default true). |
| shop_id * | any | Shop id — required. |
| variants | boolean | Publish the variants (default true). |
| product_id * | any | Product id — required. |
| description | boolean | Publish the description (default true). |
| keyFeatures | boolean | Publish the key features (default true). |
| shipping_template | boolean | Publish the shipping template (default true). |
{
"name": "printify_publish_product",
"title": "Publish product",
"description": "Publish a product to the shop's connected sales channel (e.g. Shopify, Etsy). STATE-CHANGING: this locks the product and pushes the selected fields to the external store. The body is an object of booleans controlling which fields are published; all default to true. Printify REST: POST /v1/shops/{shop_id}/products/{product_id}/publish.json.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"shop_id",
"product_id"
],
"properties": {
"tags": {
"type": "boolean",
"description": "Publish the tags (default true)."
},
"title": {
"type": "boolean",
"description": "Publish the title (default true)."
},
"images": {
"type": "boolean",
"description": "Publish the images (default true)."
},
"shop_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Shop id — required."
},
"variants": {
"type": "boolean",
"description": "Publish the variants (default true)."
},
"product_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Product id — required."
},
"description": {
"type": "boolean",
"description": "Publish the description (default true)."
},
"keyFeatures": {
"type": "boolean",
"description": "Publish the key features (default true)."
},
"shipping_template": {
"type": "boolean",
"description": "Publish the shipping template (default true)."
}
}
},
"annotations": {
"title": "Publish product",
"destructiveHint": true
}
}Tools for Printify, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Which orders in my shop are still in production?"; "Show tracking numbers for shipped orders in my shop."; "Which products do I have in my shop, and which are not published yet?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes Printify data. Free plan: 50 tool calls per month. Run printify_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run printify_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run printify_upgrade without a plan: it returns both plans, each with a payment link for the user to open. printify_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.