Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@printful-mcp-server create a t-shirt with my logo"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MCP server for Printful API. Create print-on-demand products with your designs.
Get API key from Printful Settings
Create config file:
cp printful_mcp_settings.example.json printful_mcp_settings.jsonAdd your API key to the config
Install and build:
npm install
npm run buildRelated MCP server: OpenPrints MCP
Add to claude_desktop_config.json:
{
"mcpServers": {
"printful": {
"command": "node",
"args": ["path/to/printful-mcp-server/build/index.js"]
}
}
}npm run inspectorgetProducts - Browse all printable products (shirts, mugs, etc)
getProduct - Get product details with all variants (sizes, colors)
getProductVariant - Get specific variant info
getCategories - List product categories
getPrintfiles - Get print area dimensions for a product
uploadFile - Upload design from local file
uploadFileFromUrl - Upload design from URL
getFile - Get file info
getFiles - List all files in library
getSyncProducts - List your created products
getSyncProduct - Get product with variants
createSyncProduct - Create new product listing
updateSyncProduct - Update product
deleteSyncProduct - Delete product
getSyncVariant - Get variant details
updateSyncVariant - Update variant (price, files)
deleteSyncVariant - Delete variant
createMockupTask - Generate mockup images
getMockupTask - Check mockup generation status
getMockupTemplates - Get available mockup styles
getStore - Get current store info
getStores - List all stores
changeStore - Switch to different store
Browse catalog:
getProducts → find product ID (e.g. 71 for Unisex Staple T-Shirt)
getProduct(71) → find variant IDs for sizes/colors you wantUpload design:
uploadFileFromUrl({ url: "https://example.com/my-design.png" })
→ returns file IDCreate product:
createSyncProduct({
name: "My Awesome Shirt",
variants: [
{
variant_id: 4012,
retail_price: "24.99",
files: [{ type: "front", url: "https://example.com/my-design.png" }]
}
]
})Generate mockups (optional):
createMockupTask({
product_id: 71,
files: [{ placement: "front", image_url: "https://..." }]
})
getMockupTask({ task_key: "..." }) → get mockup image URLsAlternative to config file:
PRINTFUL_API_KEY - Your API key
PRINTFUL_STORE_ID - Optional store ID
Switch to a different store (for accounts with multiple stores)
Inputs: store_id (required).
Generate product mockup images with your design. Returns a task ID to check status.
Inputs: files (required), product_id (required), format, options, +2 more.
Create a new sync product with variants. This creates a listing draft in your Printful store.
Inputs: name (required), variants (required), thumbnail, external_id.
Delete a sync product from your store
Inputs: sync_product_id (required).
Delete a sync variant
Inputs: sync_variant_id (required).
Get list of product categories
Inputs: no named parameters.
Get info about a previously uploaded file
Inputs: file_id (required).
Get list of all files in your Printful library
Inputs: limit, offset, status.
Check status of a mockup generation task and get result URLs
Inputs: task_key (required).
Get available mockup templates for a product
Inputs: product_id (required).
Get printfile info for a product (dimensions, DPI, placement areas)
Inputs: product_id (required).
Get detailed info about a specific product including all variants (sizes, colors)
Inputs: product_id (required).
Get list of all printable products in the Printful catalog (t-shirts, mugs, posters, etc)
Inputs: category_id.
Get info about a specific product variant
Inputs: variant_id (required).
Get information about your Printful store
Inputs: no named parameters.
Get list of all stores linked to your Printful account
Inputs: no named parameters.
Get a single sync product with all its variants
Inputs: sync_product_id (required).
Get list of all sync products (your created products) in your Printful store
Inputs: limit, offset, search, status.
Get a single sync variant
Inputs: sync_variant_id (required).
Update an existing sync product
Inputs: sync_product_id (required), name, thumbnail.
Update a sync variant (price, files, etc)
Inputs: sync_variant_id (required), files, retail_price.
Upload a design file (image) to Printful. Returns file ID to use when creating products.
Inputs: file_path (required), type.
Add a file to Printful library from a URL
Inputs: url (required), filename.
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Scored across 23 tools
Each tool targets a distinct resource and action. Catalog, file, sync product, mockup, and store tools are clearly separated. There is no overlap between tools like getProducts (catalog) and getSyncProducts (store products).
Tool names follow a consistent verb_noun pattern (e.g., getProducts, createSyncProduct, updateSyncVariant, deleteSyncProduct). All use camelCase with descriptive verbs, and even uploadFileFromUrl is predictable. No mixed naming conventions.
23 tools is on the higher end but appropriate for the broad scope of Printful's API: catalog browsing, file management, product lifecycle, mockups, and store management. Each tool covers a distinct function, so the count feels justified rather than excessive.
The tool set covers the core workflow: browse catalog, upload designs, create/update/delete sync products and variants, generate mockups, and manage stores. Minor gaps exist, such as no file deletion or order management tools, but the primary product creation and management lifecycle is well covered.
Browse the Printful catalog, orders, shipping quotes and stats, and create draft orders and mockups.
Design print-on-demand products, publish them to your shops, and draft and track orders.
Create, write and publish Printify products from chat, after a preview you approve.
Print-on-demand catalog, listings, and fulfillment for AI agents.
