# io.usefulapi/printful (remote · printful.usefulapi.io)

Browse the Printful catalog, orders, shipping quotes and stats, and create draft orders and mockups.

- Trust score: 33/100 (low)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-10-04

## Components

- remote · `printful.usefulapi.io`: 33/100 (this document), [markdown](https://verifymcp.io/servers/io-usefulapi-printful/printful.md), [page](https://verifymcp.io/servers/io-usefulapi-printful/printful)

## Channel facts

- Endpoint: `https://printful.usefulapi.io/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `1.0.0`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-10-04.

- **Endpoint Security**: 57/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - Authorisation not fully verified: no authorisation is required to connect, but we couldn't read the whole tool list to see what that exposes.
  - HTTPS is enforced; there's no plaintext access path.
  - HSTS check failed: the Strict-Transport-Security header is absent.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 0/100
  - Schema not yet verified: we couldn't read the endpoint's schema, or could read only part of its tool list.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 0/100
  - Tool coverage not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Tool Safety**: 0/100
  - Tool safety not yet verified: we couldn't read the endpoint's tools, or could read only part of the list.
- **Capabilities**: 0/100
  - Capabilities not yet verified: we couldn't read the endpoint's capabilities.

**Unverified: 5 categories.** Categories scored 0 because we could not verify them: authentication we do not have, an unreachable endpoint, or not enough scan history. We only credit what we can confirm.

## Install

### How do I install the io.usefulapi/printful MCP server?

io.usefulapi/printful is a hosted endpoint at https://printful.usefulapi.io/mcp, so there is nothing to install locally. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

### Claude

```bash
claude mcp add --transport http io-usefulapi-printful 'https://printful.usefulapi.io/mcp'
```

### Cursor

```json
{
  "mcpServers": {
    "io-usefulapi-printful": {
      "url": "https://printful.usefulapi.io/mcp"
    }
  }
}
```

### VS Code

```json
{
  "servers": {
    "io-usefulapi-printful": {
      "type": "http",
      "url": "https://printful.usefulapi.io/mcp"
    }
  }
}
```

### Codex

```toml
[mcp_servers.io-usefulapi-printful]
url = "https://printful.usefulapi.io/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "io-usefulapi-printful": {
      "type": "remote",
      "url": "https://printful.usefulapi.io/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add io-usefulapi-printful --url 'https://printful.usefulapi.io/mcp' --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  io-usefulapi-printful:
    url: "https://printful.usefulapi.io/mcp"
```

### Netclaw

```json
{
  "McpServers": {
    "io-usefulapi-printful": {
      "Transport": "http",
      "Url": "https://printful.usefulapi.io/mcp"
    }
  }
}
```

### Vellum

```bash
assistant mcp add io-usefulapi-printful -t streamable-http -u 'https://printful.usefulapi.io/mcp'
```

### Other

```json
{
  "mcpServers": {
    "io-usefulapi-printful": {
      "type": "http",
      "url": "https://printful.usefulapi.io/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-10-04 (score 33, +15)

- [security improvement] HTTPS: unverified → pass
- [security improvement] Transport: fail → pass
- [security] Authorization: Authorisation not fully verified: no authorisation is required to connect, but we couldn't read the whole tool list to see what that exposes.

### 2026-10-03 (score 18, −58)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Stability: 0.07 → unverified
- [security regression] Tool safety: pass → unverified
- [security regression] HTTPS: pass → unverified
- [security regression] Authorization: pass → unverified
- [security regression] Transport: pass → fail
- [functional regression] Capabilities: fail → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-10-02 (score 76, +58)

- [security improvement] HTTPS: unverified → pass
- [security improvement] Authorization: unverified → pass
- [security improvement] Injection markers: unverified → pass
- [security improvement] Transport: fail → pass
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Endpoint reachability: not serving MCP → reachable
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Stability: unverified → 0.07
- [functional] Server version: 1.0.0 → 1.5.1

### 2026-10-01 (score 18, −53)

- [security regression] Endpoint reachability: reachable → not serving MCP
- [security regression] Tool safety: pass → unverified
- [security regression] Authorization: pass → unverified
- [security regression] Transport: pass → fail
- [functional regression] Capabilities: fail → unverified
- [functional regression] Tool coverage: 100 → unverified

### 2026-09-30 (score 71, +53)

- [security improvement] Authorization: unverified → pass
- [security improvement] Injection markers: unverified → pass
- [security improvement] Transport: fail → pass
- [security] First check of Judged manipulation: pass
- [security] First check of Authorization: partial
- [functional regression] MCP protocol: unverified → fail
- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: fail
- [functional] First check of Tool coverage: 96
- [functional] First check of Schema quality: excellent
- [functional] First check of Destructive annotations: pass
- [functional] First check of Schema quality: fail

### 2026-09-29 (score 18)

First indexed and scored.

## MCP tools (20)

### `printful_list_stores` (~55 tokens)

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.

### `printful_list_catalog_categories` (~49 tokens)

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.

### `printful_list_catalog_products` (~79 tokens)

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.

Input parameters:

- `category_id` (string): Comma-separated category ids, e.g. 24 or 24,55 (see printful_list_catalog_categories).

### `printful_get_catalog_product` (~70 tokens)

Get 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}.

Input parameters:

- `product_id` (integer, required): Catalog product id, e.g. 71.

### `printful_get_catalog_variant` (~49 tokens)

Get a catalog variant

Fetch one catalog variant and its parent product. Printful: GET /products/variant/{id}.

Input parameters:

- `variant_id` (integer, required): Catalog variant id, e.g. 4012.

### `printful_list_store_products` (~108 tokens)

List 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.

Input parameters:

- `category_id` (string): Comma-separated catalog category ids.
- `status` (string): Filter by sync status.
- `store_id` (string): Store id (numeric) for an ACCOUNT-level token; overrides PRINTFUL_STORE_ID. Not needed with a store-level token.

### `printful_get_store_product` (~109 tokens)

Get a store product

Fetch one Sync Product with all its Sync Variants — catalog variant, print files, retail price. Works for any store type. Printful: GET /store/products/{id}.

Input parameters:

- `product_id` (string, required): Numeric Printful id, or your platform's External ID prefixed with @ (e.g. @988123).
- `store_id` (string): Store id (numeric) for an ACCOUNT-level token; overrides PRINTFUL_STORE_ID. Not needed with a store-level token.

### `printful_list_sync_products` (~147 tokens)

List 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.

Input parameters:

- `limit` (integer): Items per page, 1-100.
- `offset` (integer): Result set offset (items to skip).
- `search` (string): Product name search.
- `status` (string): Filter by sync status.
- `store_id` (string): Store id (numeric) for an ACCOUNT-level token; overrides PRINTFUL_STORE_ID. Not needed with a store-level token.

### `printful_list_orders` (~131 tokens)

List orders

List the store's orders, newest first, optionally by status (draft, pending, failed, canceled, inprocess, onhold, partial, fulfilled, archived). Printful: GET /orders.

Input parameters:

- `limit` (integer): Items per page, 1-100.
- `offset` (integer): Result set offset (items to skip).
- `status` (string): Order status, e.g. draft, pending, fulfilled, failed.
- `store_id` (string): Store id (numeric) for an ACCOUNT-level token; overrides PRINTFUL_STORE_ID. Not needed with a store-level token.

### `printful_get_order` (~112 tokens)

Get 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}.

Input parameters:

- `order_id` (string, required): Numeric Printful order id, or your External ID prefixed with @ (e.g. @SHOP-1001).
- `store_id` (string): Store id (numeric) for an ACCOUNT-level token; overrides PRINTFUL_STORE_ID. Not needed with a store-level token.

### `printful_calculate_shipping_rates` (~171 tokens)

Calculate 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.

Input parameters:

- `currency` (string): 3-letter currency to quote in (default: store currency).
- `items` (array, required): Items to ship — give one of the variant ids per item.
- `locale` (string): Locale for rate names: en_US (default) or es_ES.
- `recipient` (object, required): Destination; more detail can return more precise rates.
- `store_id` (string): Store id (numeric) for an ACCOUNT-level token; overrides PRINTFUL_STORE_ID. Not needed with a store-level token.

### `printful_estimate_order_costs` (~146 tokens)

Estimate 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.

Input parameters:

- `items` (array, required): Order items.
- `recipient` (object, required): Ship-to address.
- `retail_costs` (object): Retail costs to show on the packing slip.
- `shipping` (string): Shipping method id from printful_calculate_shipping_rates (default STANDARD).
- `store_id` (string): Store id (numeric) for an ACCOUNT-level token; overrides PRINTFUL_STORE_ID. Not needed with a store-level token.

### `printful_get_file` (~91 tokens)

Get 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}.

Input parameters:

- `file_id` (integer, required): File id.
- `store_id` (string): Store id (numeric) for an ACCOUNT-level token; overrides PRINTFUL_STORE_ID. Not needed with a store-level token.

### `printful_get_printfiles` (~156 tokens)

Get 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}.

Input parameters:

- `orientation` (string): For wall art: orientation.
- `product_id` (integer, required): Catalog product id.
- `store_id` (string): Store id (numeric) for an ACCOUNT-level token; overrides PRINTFUL_STORE_ID. Not needed with a store-level token.
- `technique` (string): Printing technique for multi-technique products, e.g. DTG, EMBROIDERY, SUBLIMATION, DTFILM.

### `printful_get_mockup_task` (~103 tokens)

Get 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.

Input parameters:

- `store_id` (string): Store id (numeric) for an ACCOUNT-level token; overrides PRINTFUL_STORE_ID. Not needed with a store-level token.
- `task_key` (string, required): The task_key returned by printful_create_mockup_task.

### `printful_get_statistics` (~162 tokens)

Get store statistics

Sales, costs, profit and order-count reports for a period of at most 6 months. Printful: GET /reports/statistics.

Input parameters:

- `currency` (string): 3-letter currency, or display_currency for the account's display currency (default: store currency).
- `date_from` (string, required): Start date, YYYY-MM-DD.
- `date_to` (string, required): End date, YYYY-MM-DD (max 6 months after date_from).
- `report_types` (array, required): Reports to include, e.g. ["sales_and_costs_summary", "profit", "total_paid_orders"].
- `store_id` (string): Store id (numeric) for an ACCOUNT-level token; overrides PRINTFUL_STORE_ID. Not needed with a store-level token.

### `printful_create_draft_order` (~237 tokens)

Create 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).

Input parameters:

- `external_id` (string): Your own order id; the order is then also addressable as @<external_id>.
- `gift` (object): Gift message for the packing slip.
- `items` (array, required): Order items.
- `packing_slip` (object): Custom packing slip.
- `recipient` (object, required): Ship-to address (name, address1, city, country_code, zip are normally needed).
- `retail_costs` (object): Retail costs to show on the packing slip.
- `shipping` (string): Shipping method id from printful_calculate_shipping_rates (default STANDARD).
- `store_id` (string): Store id (numeric) for an ACCOUNT-level token; overrides PRINTFUL_STORE_ID. Not needed with a store-level token.

### `printful_update_draft_order` (~209 tokens)

Update 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).

Input parameters:

- `external_id` (string): New external id.
- `gift` (object)
- `items` (array): Full replacement item list (see caution).
- `order_id` (string, required): Numeric Printful order id, or External ID prefixed with @.
- `packing_slip` (object)
- `recipient` (object): New ship-to address fields.
- `retail_costs` (object)
- `shipping` (string): New shipping method id.
- `store_id` (string): Store id (numeric) for an ACCOUNT-level token; overrides PRINTFUL_STORE_ID. Not needed with a store-level token.

### `printful_add_file` (~170 tokens)

Add 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.

Input parameters:

- `filename` (string): File name to store it under.
- `options` (array): Additional file options.
- `store_id` (string): Store id (numeric) for an ACCOUNT-level token; overrides PRINTFUL_STORE_ID. Not needed with a store-level token.
- `type` (string): Role of the file, e.g. default or preview.
- `url` (string, required): Public URL Printful downloads the file from.
- `visible` (boolean): Show the file in the dashboard's File Library (default true).

### `printful_create_mockup_task` (~251 tokens)

Create 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}.

Input parameters:

- `files` (array): Design files per placement. Give files or product_template_id.
- `format` (string): Output format (png is transparent).
- `option_groups` (array): Mockup option groups to generate.
- `options` (array): Mockup option names to generate (see printfiles).
- `product_id` (integer, required): Catalog product id.
- `product_options` (object): Product options, e.g. embroidery thread colors.
- `product_template_id` (integer): Use a saved Product Template instead of files.
- `store_id` (string): Store id (numeric) for an ACCOUNT-level token; overrides PRINTFUL_STORE_ID. Not needed with a store-level token.
- `variant_ids` (array, required): Catalog variant ids to render.
- `width` (integer): Mockup width in px, 50-2000 (default 1000).

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/io-usefulapi-printful/printful#diagnostics

## Score history

- 2026-10-04: 33
- 2026-10-03: 18
- 2026-10-02: 76
- 2026-10-01: 18
- 2026-09-30: 71
- 2026-09-29: 18

## Common questions

### What is the io.usefulapi/printful MCP server?

io.usefulapi/printful is an MCP server listed in the public MCP registry as io.usefulapi/printful. Browse the Printful catalog, orders, shipping quotes and stats, and create draft orders and mockups. This page covers its hosted endpoint (https://printful.usefulapi.io/mcp).

### Is the io.usefulapi/printful MCP server safe to use?

io.usefulapi/printful scores 33 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the io.usefulapi/printful MCP server expose?

io.usefulapi/printful exposes 20 tools: printful_list_stores, printful_list_catalog_categories, printful_list_catalog_products, printful_get_catalog_product, printful_get_catalog_variant, and 15 more. Their descriptions and schemas cost roughly 2,605 tokens of context every time the server is loaded.

### Does the io.usefulapi/printful MCP server require authentication?

No. We connected to io.usefulapi/printful without credentials and it answered, so anything it exposes is reachable by anyone who knows the address.

### Is the io.usefulapi/printful MCP server still maintained?

io.usefulapi/printful is still listed as active in the MCP registry. We last reached this channel on 4 October 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

## Links

- Remote endpoint: https://printful.usefulapi.io/mcp
- Repository: https://github.com/m190/usefulapi-mcp
- Changelog RSS feed: https://verifymcp.io/servers/io-usefulapi-printful/printful.xml
- Changelog JSON feed: https://verifymcp.io/servers/io-usefulapi-printful/printful.json
- HTML version of this page: https://verifymcp.io/servers/io-usefulapi-printful/printful