Skip to main content
Glama
Purple-Horizons

Printful MCP Server

by Purple-Horizons
OverviewSchemaSourceRelated ServersDiscussionsAdmin
Python
Remote

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
PRINTFUL_API_KEYYesYour Printful API key used to authenticate with the Printful API v2.

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
printful_list_catalog_productsB
Browse Printful's product catalog with optional filters.

Returns a list of available products including t-shirts, mugs, posters, etc.
Use filters to narrow down by category, color, technique, or product type.
printful_get_productA
Get detailed information about a specific catalog product.

Returns placements (where designs can be printed), techniques (DTG, embroidery, etc.),
available sizes/colors, and design requirements.
printful_get_product_variantsA
Get all variants (size/color combinations) for a product.

Each variant has a unique ID needed for ordering. Returns variant IDs,
names, sizes, colors, and preview images.
printful_get_variant_pricesA
Get pricing information for a specific variant.

Returns base prices by technique, placement costs, and quantity discounts.
Helps calculate total order costs before ordering.
printful_get_product_availabilityA
Check stock availability for a product's variants.

Returns in-stock/out-of-stock status for each variant and technique
by selling region. Critical for displaying product availability.
printful_create_orderA
Create a new order in draft status.

Creates an empty order with recipient info. Add items separately, then
confirm to start fulfillment. Draft orders are not charged.
printful_get_orderA
Get details of a specific order.

Returns order status, recipient, costs, items, and shipment info.
Use order ID or external ID (prefix with @).
printful_confirm_orderA
Confirm an order to start production and fulfillment.

Moves order from draft to pending status. Order will be charged and
sent to production. Cannot be undone easily.
printful_list_ordersB
List all orders from the store.

Returns paginated list of orders with status, costs, and item counts.
printful_calculate_shippingB
Calculate shipping rates for an order.

Returns available shipping methods, costs, and estimated delivery times
based on recipient location and order items.
printful_list_countriesA
List all countries where Printful ships.

Returns country codes and state codes needed for creating orders.
Essential for address validation.
printful_create_mockup_taskA
Generate product mockup images.

Creates an async task to generate mockup images showing your design
on the product. Returns task ID to check status and get URLs.
printful_get_mockup_taskA
Check mockup generation status and get results.

Returns task status (pending/completed/failed) and mockup image URLs
if completed. Typically takes 10-30 seconds to generate.
printful_add_fileA
Add a design file to the Printful file library.

Uploads file from URL for reuse across orders. Files are processed
asynchronously. Returns file ID for use in orders.
printful_get_fileA
Get information about a file in the library.

Returns file status, dimensions, DPI, and URLs. Check processing
status before using in orders.
printful_list_storesA
List all stores available to your API token.

Returns store IDs and names. Needed for multi-store accounts.
printful_get_store_statsA
Get store statistics for a date range.

Returns sales, costs, profit, order counts, and fulfillment metrics.
Date range cannot exceed 6 months.
printful_list_sync_productsA
List sync products using v1 API (not available in v2 yet).

Sync products are pre-configured templates with saved designs.
Currently only available via v1 API.
printful_get_sync_productA
Get sync product details using v1 API (not available in v2 yet).

Returns full sync product info including variants and designs.
Currently only available via v1 API.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

Deploy Server
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

TDQS

A3.9/5.0

Scored across 19 tools

Disambiguation5/5

Every tool has a clearly distinct purpose targeting specific resources and actions in the Printful ecosystem. Tools like printful_get_product, printful_get_product_variants, and printful_get_product_availability all serve different but complementary purposes without overlap. The descriptions clearly differentiate between file management, order processing, product catalog operations, and administrative functions.

Naming Consistency5/5

All tools follow a perfect verb_noun pattern with the 'printful_' prefix, using consistent snake_case throughout. The naming convention is highly predictable: action verbs (add, calculate, confirm, create, get, list) followed by specific nouns (file, shipping, order, mockup_task, etc.). This makes it easy for agents to understand what each tool does from its name alone.

Tool Count4/5

With 19 tools, the server provides comprehensive coverage of the Printful API surface. While slightly on the higher side, each tool serves a distinct purpose in the e-commerce/print-on-demand domain. The count is reasonable given the complexity of managing products, orders, files, and mockups in a fulfillment platform. A few tools could potentially be consolidated, but overall the scope is appropriate.

Completeness4/5

The tool set provides excellent coverage of the Printful domain with clear CRUD operations for orders, files, and products. There's comprehensive support for the order lifecycle (create, confirm, get, list), product catalog exploration, and administrative functions. Minor gaps include the lack of order update/cancellation tools and limited sync product support (noted as v1-only), but agents can accomplish most workflows with the available tools.

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources