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 create a draft order for a black t-shirt with my design to California"
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.
Open-source Model Context Protocol server for the official Printful REST API. It is generic: no store is hard-coded, and the private token stays in the environment.
create_order always creates a draft. It sends confirm=false and drops any confirm flag. Printful charges the store payment method and starts fulfillment only when you call confirm_order with confirm set to true.
Author: Bootheel Faith Co. License: MIT.
Repository and homepage: https://github.com/jwlpt45/printful-mcp
Logo: https://raw.githubusercontent.com/jwlpt45/printful-mcp/main/assets/logo.png
Requires Node.js 20 or newer.
In the Printful Developer Portal, create a private token. A store-level token is enough for one store. An account-level token can see every store; set PRINTFUL_STORE_ID to the store you want (list them with list_stores).
Export the token in the environment that launches the server. Do not commit it, and do not paste it into chat logs.
export PRINTFUL_API_TOKEN="your-private-token"
# Optional. Required for account-level tokens on store-specific calls.
export PRINTFUL_STORE_ID="your-store-id"Run the server over stdio:
npx -y printful-mcpFrom a checkout:
npm install
npm run build
npm start{
"mcpServers": {
"printful": {
"command": "npx",
"args": ["-y", "printful-mcp"],
"env": {
"PRINTFUL_API_TOKEN": "your-private-token"
}
}
}
}Add "PRINTFUL_STORE_ID": "your-store-id" inside env when the token is account-level. The same block is in .mcp.json and in .cursor-plugin/plugin.json, .codex-plugin/plugin.json, and .claude-plugin/plugin.json.
The server never writes the token to logs. Errors that echo it are redacted.
Related MCP server: OpenPrints MCP
Tool | What it does |
| Prices a shipment. Creates nothing. |
| Saves a draft. Never confirms. |
| Submits that draft for fulfillment. Requires |
| Cancels a draft or pending order when Printful allows it. |
Give create_order your own external_id so a retry after a timeout cannot create a second draft.
Printful allows about 120 requests per minute on the general API, and much less for mockup generation and sync-product writes. A 429 includes how many seconds to wait. This server retries once when that wait is 5 seconds or less. Longer lockouts are returned as an error so the caller can wait and try again.
Tool | API |
|
|
|
|
|
|
| Product variants, or |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
Recipient fields below are fictional.
{
"shipping": "STANDARD",
"recipient": {
"name": "Jane Doe",
"address1": "Address line 1",
"city": "Sample City",
"state_code": "CA",
"country_code": "US",
"zip": "00000"
},
"items": [
{
"variant_id": 4012,
"quantity": 1,
"files": [{ "type": "front", "url": "https://example.com/art.png" }]
}
]
}Pass that object to estimate_order_costs, then to create_order. Stop there until someone explicitly agrees to pay. Then call confirm_order with { "order_id": 44, "confirm": true }.
skills/publish-print-on-demand-product/ — catalog variant, print file, mockup, sync product.
skills/place-printful-order/ — estimate, draft, then confirm only after an explicit yes.
Tests mock HTTP with MSW. They do not call Printful.
npm test
npm run buildMIT, Copyright 2026 Bootheel Faith Co. See LICENSE.
This server cannot be deployed
Browse the Printful catalog, orders, shipping quotes and stats, and create draft orders and mockups.
Print-on-demand fulfillment: manage orders, catalog and account from AI clients. Writes ask first.
Print-on-demand catalog, listings, and fulfillment for AI agents.
Create, write and publish Printify products from chat, after a preview you approve.
