Printify MCP by usefulapi
Read shops, catalog blueprints, print providers, products and orders; create and publish products.
사용해야 할까요
품질 및 안전성
발견 사항 (5)
- HIGH
- MEDIUMprintify_create_product에서
- LOWprintify_write_operation_status에서
- LOWprintify_list_catalog_blueprints에서
- INFOprintify_create_product에서
도구 정의와 프로토콜 준수에 대한 자동 분석을 기반으로 합니다.
컨텍스트 비용
이는 서버의 도구가 모델의 컨텍스트에 로드될 때마다 소비되는 대략적인 토큰 수입니다. 수치가 높을수록 다른 작업에 사용할 수 있는 주의가 줄어듭니다.
설치
원클릭 설치
`claude_desktop_config.json` 파일에 다음을 추가하세요:
{
"mcpServers": {
"printify": {
"url": "https://printify.usefulapi.io/mcp"
}
}
}원격 엔드포인트
https://printify.usefulapi.io/mcpstreamable-http할 수 있는 일
도구 목록
도구 (25)
🔴printify_create_order(operation_id, shop_id, confirm, preview_hash, line_items, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,100}$"
},
"shop_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
]
},
"confirm": {
"type": "boolean"
},
"preview_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"line_items": {
"minItems": 1,
"maxItems": 20,
"type": "array",
"items": {
"type": "object",
"properties": {
"product_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"variant_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"quantity": {
"type": "integer",
"minimum": 1,
"maximum": 10000
}
},
"required": [
"product_id",
"variant_id",
"quantity"
]
}
},
"address_to": {
"type": "object",
"properties": {
"first_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"last_name": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"email": {
"type": "string",
"maxLength": 254,
"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,}$"
},
"phone": {
"type": "string",
"minLength": 1,
"maxLength": 50
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$"
},
"region": {
"type": "string",
"maxLength": 100
},
"address1": {
"type": "string",
"minLength": 1,
"maxLength": 200
},
"address2": {
"type": "string",
"maxLength": 200
},
"city": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"zip": {
"type": "string",
"minLength": 1,
"maxLength": 30
},
"company": {
"type": "string",
"maxLength": 100
}
},
"required": [
"first_name",
"last_name",
"email",
"phone",
"country",
"region",
"address1",
"city",
"zip"
]
},
"shipping_method": {
"type": "integer",
"minimum": 1,
"maximum": 4
},
"label": {
"type": "string",
"minLength": 1,
"maxLength": 100
},
"manual_approval_confirmed": {
"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.",
"type": "boolean"
}
},
"required": [
"operation_id",
"shop_id",
"line_items",
"address_to",
"shipping_method"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴printify_send_to_production(operation_id, shop_id, confirm, preview_hash, order_id, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,100}$"
},
"shop_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
]
},
"confirm": {
"type": "boolean"
},
"preview_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"order_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"production_charge_approved": {
"type": "boolean"
}
},
"required": [
"operation_id",
"shop_id",
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴printify_create_webhook(operation_id, shop_id, confirm, preview_hash, topic, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,100}$"
},
"shop_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
]
},
"confirm": {
"type": "boolean"
},
"preview_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"topic": {
"type": "string",
"enum": [
"order:created",
"order:updated",
"order:sent-to-production",
"order:shipment:created",
"order:shipment:delivered"
]
},
"url": {
"type": "string",
"maxLength": 2000,
"format": "uri"
}
},
"required": [
"operation_id",
"shop_id",
"topic",
"url"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴printify_delete_webhook(operation_id, shop_id, confirm, preview_hash, webhook_id, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,100}$"
},
"shop_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
]
},
"confirm": {
"type": "boolean"
},
"preview_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"webhook_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"expected_host": {
"type": "string",
"maxLength": 253,
"pattern": "^[A-Za-z0-9.-]+$"
}
},
"required": [
"operation_id",
"shop_id",
"webhook_id",
"expected_host"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴printify_update_product_prices(operation_id, shop_id, confirm, preview_hash, product_id, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,100}$"
},
"shop_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
]
},
"confirm": {
"type": "boolean"
},
"preview_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"product_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"prices": {
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "object",
"properties": {
"variant_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
"price": {
"type": "integer",
"minimum": 0,
"maximum": 100000000,
"description": "New retail price in cents, as an integer."
}
},
"required": [
"variant_id",
"price"
]
}
}
},
"required": [
"operation_id",
"shop_id",
"product_id",
"prices"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴printify_upload_image(operation_id, shop_id, confirm, preview_hash, file_name, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,100}$"
},
"shop_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
]
},
"confirm": {
"type": "boolean"
},
"preview_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"file_name": {
"type": "string",
"pattern": "^[^/\\\\\\x00-\\x1f]{1,200}$",
"description": "File name for the media library, e.g. hat-logo.png."
},
"url": {
"description": "Public HTTPS URL of the image. Printify downloads it; this server does not.",
"type": "string",
"maxLength": 2000,
"format": "uri"
},
"contents": {
"description": "The image as plain base64, up to about 2.9 MB. Use url for larger files.",
"type": "string",
"minLength": 4,
"maxLength": 3900000,
"pattern": "^[A-Za-z0-9+/]+={0,2}$"
}
},
"required": [
"operation_id",
"shop_id",
"file_name"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴printify_create_product(operation_id, shop_id, confirm, preview_hash, title, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,100}$"
},
"shop_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
]
},
"confirm": {
"type": "boolean"
},
"preview_hash": {
"type": "string",
"pattern": "^[a-f0-9]{64}$"
},
"title": {
"type": "string",
"minLength": 1,
"maxLength": 255
},
"description": {
"type": "string",
"maxLength": 20000,
"description": "Product description (HTML allowed by Printify)."
},
"blueprint_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Catalog blueprint id (printify_list_catalog_blueprints)."
},
"print_provider_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Print provider id for the blueprint (printify_get_print_providers)."
},
"variants": {
"minItems": 1,
"maxItems": 300,
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "Variant id from printify_get_variants."
},
"price": {
"type": "integer",
"minimum": 1,
"maximum": 100000000,
"description": "Retail price in cents, at least 1."
}
},
"required": [
"id",
"price"
]
},
"description": "The variants to sell, each with its retail price. Other variants of the blueprint are added disabled."
},
"placements": {
"minItems": 1,
"maxItems": 10,
"type": "array",
"items": {
"type": "object",
"properties": {
"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."
},
"image_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$",
"description": "Image id from printify_upload_image or printify_list_uploads."
},
"x": {
"description": "Horizontal center, 0-1 of the print area (default 0.5).",
"type": "number",
"minimum": 0,
"maximum": 1
},
"y": {
"description": "Vertical center, 0-1 of the print area (default 0.5).",
"type": "number",
"minimum": 0,
"maximum": 1
},
"scale": {
"description": "Image width relative to the print area width (default 1).",
"type": "number",
"exclusiveMinimum": 0,
"maximum": 10
},
"angle": {
"description": "Rotation in degrees (default 0).",
"type": "integer",
"minimum": -360,
"maximum": 360
}
},
"required": [
"position",
"image_id"
]
},
"description": "The artwork: one entry per image and position. Every selected variant gets the same placements."
}
},
"required": [
"operation_id",
"shop_id",
"title",
"description",
"blueprint_id",
"print_provider_id",
"variants",
"placements"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢printify_write_operation_status(shop_id, operation_id)
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.
입력 스키마
{
"type": "object",
"properties": {
"shop_id": {
"anyOf": [
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
},
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
]
},
"operation_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{8,100}$"
}
},
"required": [
"shop_id",
"operation_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴printify_copy_products(source_shop_id, target_shop_id, product_ids, all_products, job_id, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"source_shop_id": {
"description": "Source shop ID; the token must have access to both shops in the same Printify account.",
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
]
},
"target_shop_id": {
"description": "Different target shop ID. New products stay as drafts and are not published.",
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
]
},
"product_ids": {
"description": "Selected source product IDs; mutually exclusive with all_products:true. Omit when resuming job_id.",
"minItems": 1,
"maxItems": 100,
"type": "array",
"items": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
}
},
"all_products": {
"description": "Copy all source products with resumable pagination. Omit when resuming job_id.",
"type": "boolean"
},
"job_id": {
"description": "A previously returned job_id to resume; supply the same source and target shops.",
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"start_new_job": {
"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.",
"type": "boolean"
},
"batch_size": {
"description": "Maximum creates in this call (default 1). Calls are also bounded when skipping prior copies.",
"type": "integer",
"minimum": 1,
"maximum": 3
},
"confirm": {
"description": "False/omitted previews only. True authorizes creation of new draft products.",
"type": "boolean"
}
},
"required": [
"source_shop_id",
"target_shop_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢printify_copy_status(source_shop_id, target_shop_id, job_id, entry_cursor, entry_limit)
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.
입력 스키마
{
"type": "object",
"properties": {
"source_shop_id": {
"description": "Source shop ID; the token must have access to both shops in the same Printify account.",
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
]
},
"target_shop_id": {
"description": "Different target shop ID. New products stay as drafts and are not published.",
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
]
},
"job_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"entry_cursor": {
"description": "next_cursor from a previous status page; lists all entries including older failures.",
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"entry_limit": {
"description": "Job entries per status page (default 20).",
"type": "integer",
"minimum": 1,
"maximum": 100
}
},
"required": [
"source_shop_id",
"target_shop_id",
"job_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴printify_resolve_copy(source_shop_id, target_shop_id, job_id, source_product_id, target_product_id, ...)
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.
입력 스키마
{
"type": "object",
"properties": {
"source_shop_id": {
"description": "Source shop ID; the token must have access to both shops in the same Printify account.",
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
]
},
"target_shop_id": {
"description": "Different target shop ID. New products stay as drafts and are not published.",
"anyOf": [
{
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
{
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991
}
]
},
"job_id": {
"type": "string",
"pattern": "^[A-Za-z0-9_-]{1,100}$"
},
"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"
},
"confirm": {
"type": "boolean"
}
},
"required": [
"source_shop_id",
"target_shop_id",
"job_id",
"source_product_id",
"confirm"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢printify_list_shops
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.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢printify_list_products(shop_id, limit, page)
List products in a shop (paginated). Printify REST: GET /v1/shops/{shop_id}/products.json.
입력 스키마
{
"type": "object",
"properties": {
"shop_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Shop id (from printify_list_shops) — required."
},
"limit": {
"description": "Items per page (default 10, max 50).",
"type": "integer",
"minimum": 1,
"maximum": 50
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"required": [
"shop_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢printify_get_product(shop_id, product_id)
Get a single product's full details (variants, images, print areas, publish status). Printify REST: GET /v1/shops/{shop_id}/products/{product_id}.json.
입력 스키마
{
"type": "object",
"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."
}
},
"required": [
"shop_id",
"product_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢printify_list_orders(shop_id, limit, page, status, sku)
List orders in a shop (paginated), optionally filtered by status or SKU. Printify REST: GET /v1/shops/{shop_id}/orders.json.
입력 스키마
{
"type": "object",
"properties": {
"shop_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Shop id — required."
},
"limit": {
"description": "Items per page (default 10, max 10).",
"type": "integer",
"minimum": 1,
"maximum": 10
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
},
"status": {
"description": "Filter by fulfillment status, e.g. 'fulfilled'.",
"type": "string"
},
"sku": {
"description": "Filter to orders containing this SKU.",
"type": "string"
}
},
"required": [
"shop_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢printify_get_order(shop_id, order_id)
Get a single order's full details, including `shipments` (carrier + tracking numbers). Printify REST: GET /v1/shops/{shop_id}/orders/{order_id}.json.
입력 스키마
{
"type": "object",
"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."
}
},
"required": [
"shop_id",
"order_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢printify_calculate_shipping(shop_id, line_items, address_to)
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.
입력 스키마
{
"type": "object",
"properties": {
"shop_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Shop id — required."
},
"line_items": {
"minItems": 1,
"type": "array",
"items": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {}
},
"description": "Array of line items to price (see description for accepted shapes)."
},
"address_to": {
"type": "object",
"propertyNames": {
"type": "string"
},
"additionalProperties": {},
"description": "Destination address object."
}
},
"required": [
"shop_id",
"line_items",
"address_to"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢printify_list_catalog_blueprints
List all blueprints (product types, e.g. 'Unisex T-Shirt') available in the Printify catalog. Printify REST: GET /v1/catalog/blueprints.json.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢printify_get_blueprint(blueprint_id)
Get a single catalog blueprint's details. Printify REST: GET /v1/catalog/blueprints/{blueprint_id}.json.
입력 스키마
{
"type": "object",
"properties": {
"blueprint_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Blueprint id — required."
}
},
"required": [
"blueprint_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢printify_get_print_providers(blueprint_id)
List the print providers that can produce a given blueprint. Printify REST: GET /v1/catalog/blueprints/{blueprint_id}/print_providers.json.
입력 스키마
{
"type": "object",
"properties": {
"blueprint_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Blueprint id — required."
}
},
"required": [
"blueprint_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢printify_get_variants(blueprint_id, print_provider_id, show_out_of_stock)
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.
입력 스키마
{
"type": "object",
"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": {
"description": "Include out-of-stock variants (sent as show-out-of-stock=1).",
"type": "boolean"
}
},
"required": [
"blueprint_id",
"print_provider_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢printify_list_print_providers
List all print providers in the Printify catalog. Printify REST: GET /v1/catalog/print_providers.json.
입력 스키마
{
"type": "object",
"properties": {},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢printify_list_webhooks(shop_id)
List the webhooks configured for a shop. Printify REST: GET /v1/shops/{shop_id}/webhooks.json.
입력 스키마
{
"type": "object",
"properties": {
"shop_id": {
"anyOf": [
{
"type": "string",
"minLength": 1
},
{
"type": "number"
}
],
"description": "Shop id — required."
}
},
"required": [
"shop_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🟢printify_list_uploads(limit, page)
List images uploaded to the account's media library (paginated). Printify REST: GET /v1/uploads.json.
입력 스키마
{
"type": "object",
"properties": {
"limit": {
"description": "Items per page (default 10, max 100).",
"type": "integer",
"minimum": 1,
"maximum": 100
},
"page": {
"description": "1-based page number.",
"type": "integer",
"minimum": 1,
"maximum": 9007199254740991
}
},
"$schema": "https://json-schema.org/draft/2020-12/schema"
}🔴printify_publish_product(shop_id, product_id, title, description, images, ...)
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.
입력 스키마
{
"type": "object",
"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."
},
"title": {
"description": "Publish the title (default true).",
"type": "boolean"
},
"description": {
"description": "Publish the description (default true).",
"type": "boolean"
},
"images": {
"description": "Publish the images (default true).",
"type": "boolean"
},
"variants": {
"description": "Publish the variants (default true).",
"type": "boolean"
},
"tags": {
"description": "Publish the tags (default true).",
"type": "boolean"
},
"keyFeatures": {
"description": "Publish the key features (default true).",
"type": "boolean"
},
"shipping_template": {
"description": "Publish the shipping template (default true).",
"type": "boolean"
}
},
"required": [
"shop_id",
"product_id"
],
"$schema": "https://json-schema.org/draft/2020-12/schema"
}권장 프롬프트
printify_get_productprintify_get_productprintify_list_shopsprintify_list_shopsprintify_list_shopsprintify_get_product커뮤니티
증거