printful_list_stores
List stores
List the stores this token can reach (id, name, platform type). A cheap way to confirm the token works, and where to find the store_id an ACCOUNT-level token needs. Printful: GET /stores.
Takes no parameters.
io.usefulapiPublished by usefulapi.ioOfficial publisherv1.39.1Updated Nov 14, 2026
Browse the Printful catalog, orders, shipping quotes and stats, and create draft orders and mockups.
The publisher's own server: Ably MCP by usefulapi
Hosted Printful MCP server that lets an assistant browse the print-on-demand catalog, orders, shipping quotes and sales stats, and create draft orders and…
Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.
Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.
Read https://sourceweft.com/mcp/io.usefulapi%2Fprintful/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.Add this to your client's mcpServers config.
{
"mcpServers": {
"printful-by-usefulapi": {
"type": "http",
"url": "https://printful.usefulapi.io/mcp"
}
}
}Use Printful from Claude, Cursor, or any MCP client — browse the catalog, orders, shipping rates and sales stats, and create draft orders, files and mockups. Hosted, no local install: connect with your own Printful credentials.
Live endpoint: https://printful.usefulapi.io/mcp · Homepage: https://usefulapi.io/printful
https://printful.usefulapi.io/mcp.claude mcp add --transport http printful https://printful.usefulapi.io/mcp, then run /mcp to log in.Add only the URL. Do not add an Authorization header or an API key to the client config: the server signs you in with OAuth, and the login page asks for your Printful credentials.
Step-by-step setup, where to find your credentials, and FAQ: https://usefulapi.io/printful/
On first connect you'll provide your Printful Private Token (developers.printful.com > Your tokens), plus an optional default store ID. They're validated, stored per-user, and scoped to you — no keys in config files.
read tools are read-only; write tools mutate data (clients should confirm them); meta tools report usage, manage your subscription or send a feature request.
Each paid plan covers this server only. Ask your AI to run printful_upgrade and choose Pro or Pro+, billed monthly or yearly (it returns a Stripe Checkout link). If you already have Pro, ask to change it to Pro+. The change requires your confirmation, keeps your billing interval and charges the price difference for the rest of the period immediately. Cancel any time with printful_cancel_subscription: your paid plan continues to the end of the paid period, with no refund for the current period, and asking to resume the same plan with printful_upgrade before then undoes the cancel. Or write to [email protected].
MIT © usefulapi. Not affiliated with or endorsed by Printful.
Source: servers/printful/README.md at commit f22f848
List stores
List the stores this token can reach (id, name, platform type). A cheap way to confirm the token works, and where to find the store_id an ACCOUNT-level token needs. Printful: GET /stores.
Takes no parameters.
List catalog categories
List Printful's catalog categories (T-shirts, Mugs, Posters…) with their ids and parent ids — the filter for printful_list_catalog_products. Printful: GET /categories.
Takes no parameters.
List catalog products
List the blank products Printful can print on (id, title, brand, model, variant count, print-file placements), optionally filtered by category. Printful: GET /products.
category_idGet a catalog product
Fetch one catalog product with ALL its variants (size, color, variant_id, price, stock). Use the variant_id values when quoting shipping or building an order. Printful: GET /products/{id}.
product_idrequiredGet a catalog variant
Fetch one catalog variant and its parent product. Printful: GET /products/variant/{id}.
variant_idrequiredList store products (Manual/API store)
List the Sync Products in a Manual-order / API store. For a Shopify, Etsy, WooCommerce or other integrated store use printful_list_sync_products instead. Printful: GET /store/products.
statusstore_idcategory_idGet a store product (Manual/API store)
Fetch one product of a Manual-order / API store with all its Sync Variants — catalog variant, print files, retail price. For a Shopify, Etsy, WooCommerce or other integrated store use printful_get_sync_product instead. Printful: GET /store/products/{id}.
store_idproduct_idrequiredList synced products (integrated store)
List the products Printful has imported from an integrated store (Shopify, Etsy, WooCommerce…), with how many variants are synced. Filter by status=unsynced to find products that still need a design or catalog variant. Printful: GET /sync/products.
limitoffsetsearchstatusstore_idGet a synced product (integrated store)
Fetch one product imported from an integrated store (Shopify, Etsy, WooCommerce…) with all its Sync Variants — catalog variant, print files, retail price, sync status. Ids come from printful_list_sync_products. Printful: GET /sync/products/{id}.
store_idproduct_idrequiredList orders
List the store's orders, newest first, optionally by status (draft, pending, failed, canceled, inprocess, onhold, partial, fulfilled, archived). Printful: GET /orders.
limitoffsetstatusstore_idGet an order
Fetch one order: status, recipient, items, costs, and shipments with carrier and tracking links — the answer to 'where is my order?'. Printful: GET /orders/{id}.
order_idrequiredstore_idCalculate shipping rates
Quote the shipping options (method id, name, rate, delivery-day estimate) for a set of items to an address. Only country_code is required (plus state_code for US/CA/AU). Changes nothing. Printful: POST /shipping/rates.
itemsrequiredlocalecurrencystore_idrecipientrequiredEstimate order costs
Price an order WITHOUT creating it: item, print, shipping and tax costs, plus retail totals. Same item shape as printful_create_draft_order. Changes nothing. Printful: POST /orders/estimate-costs.
itemsrequiredshippingstore_idrecipientrequiredretail_costsGet a file
Fetch one File Library entry — processing status (ok / waiting / failed), dimensions, DPI and preview URLs. Poll this after printful_add_file. Printful: GET /files/{id}.
file_idrequiredstore_idGet printfile specs for a product
List the print areas (placements) and required print-file pixel sizes/DPI for each variant of a catalog product — what a design must match before mockups or orders. DTG is assumed unless technique is given. Printful: GET /mockup-generator/printfiles/{id}.
store_idtechniqueproduct_idrequiredorientationGet a mockup task result
Check a mockup-generation task: status (pending / completed / failed) and, when done, the mockup image URLs per placement and variant. Printful: GET /mockup-generator/task.
store_idtask_keyrequiredGet store statistics
Sales, costs, profit and order-count reports for a period of at most 6 months. Printful: GET /reports/statistics.
date_torequiredcurrencystore_iddate_fromrequiredreport_typesrequiredCreate a draft order
Create an order as a DRAFT — nothing is charged or produced. It must be confirmed later in the Printful dashboard, where the charge is shown. Each item needs one of variant_id (+ files), sync_variant_id, external_variant_id, warehouse_product_variant_id or product_template_id (+ variant_id). Printful: POST /orders (never with confirm).
giftitemsrequiredshippingstore_idrecipientrequiredexternal_idpacking_slipretail_costsUpdate a draft order
Change a DRAFT order (unsubmitted orders only) — send only the fields to change. CAUTION: if you send `items`, it replaces the list: existing items not included (by id or external_id) are removed. The order stays a draft; nothing is charged. Printful: PUT /orders/{id} (never with confirm).
giftitemsorder_idrequiredshippingstore_idrecipientexternal_idpacking_slipretail_costsAdd a file to the File Library
Add a print file to the File Library from a public URL (PNG/JPG recommended). If a file with the same URL already exists it is returned instead. Processing is async — poll printful_get_file until status is ok. Printful: POST /files.
urlrequiredtypeoptionsvisiblefilenamestore_idCreate a mockup generation task
Start generating product mockups for a design on a catalog product — returns a task_key; poll printful_get_mockup_task for the images. Heavily rate-limited (about 10/min for established stores, 2/min for new ones). Printful: POST /mockup-generator/create-task/{id}.
fileswidthformatoptionsstore_idproduct_idrequiredvariant_idsrequiredoption_groupsproduct_optionsproduct_template_id100% of the applicable checks met
How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.
io.usefulapiOfficial publisher
Hosted MCP server for Ably that lets an assistant inspect realtime channels, presence and usage stats, publish messages, and review app configuration.
io.usefulapiOfficial publisher
Remote MCP server for Oyster that lets an assistant read team, time off, expense, contract and invoice data and approve or decline requests.
io.usefulapiOfficial publisher
Reads Avirato hotel PMS data — reservations, availability, rates, prices and meal plans — and records cash payments on bookings.
io.usefulapiOfficial publisher
Hosted read-only MCP server that lets an assistant list interview, participant and department metadata from a Willo account.
io.usefulapiOfficial publisher
Hosted MCP server that lets an assistant read Testlify hiring workspace details, assessments and assessment candidates.
{ "mcpServers": { "printful": { "url": "https://printful.usefulapi.io/mcp" } }}