How to integrate Printful MCP with Atomic Agent

Connect Atomic Agent to Printful MCP. List your printful stores and product catalogs, check printful orders awaiting fulfillment today, and more using natural language, with authentication handled for you.

Printful logoPrintful
Oauth2Api Key

Printful is an on-demand printing and fulfillment platform for products, stores, and orders. It helps businesses sell custom goods without holding inventory or managing shipping.

107 Tools

Introduction

Atomic Agent is an open-source AI agent that runs on your machine and supports local models through llama.cpp. Connect it to 1,700+ apps through Composio, including Printful.

This guide uses Atomic Agent's built-in Composio integration. You need Atomic Agent v0.5.6 or later, your own Composio API key, and a Printful account. See the Atomic Agent documentation for installation instructions.

For exact tool slugs and parameter tables, see the tool catalog in the Composio docs.

Also integrate Printful with

How Atomic Agent connects to Printful

Atomic Agent connects to Composio's Tool Router over Streamable HTTP MCP. It discovers the tools needed for your request, and Composio handles account authentication.

Execution and account-connection tools follow Atomic Agent's configured approval policy. Review any approval prompt before allowing an action on your connected account.

Connect Printful to Atomic Agent

  1. Sign up or sign in to the Composio dashboard. Copy your API key.
  2. In Atomic Agent, open the Integrations tab and select Composio. Select API key, press e, paste the key, and press Enter. The tools become available immediately, without a restart.
  3. Ask Atomic Agent to do something in Printful. It searches Composio for the right tool.
  4. On first use, open the sign-in link returned in the chat. Connect your Printful account, then return to Atomic Agent to continue.

Headless setup

Add the following line to ~/.atomic-agent/.env, replacing YOUR_COMPOSIO_API_KEY with your key. Start Atomic Agent after saving the file.

bash
COMPOSIO_API_KEY=YOUR_COMPOSIO_API_KEY

What is the Printful MCP server, and what's possible with it?

The Printful MCP server is an implementation of the Model Context Protocol that connects your AI agent and assistants like Claude, Cursor, etc directly to your Printful account. It provides structured and secure access to your product catalog, stores, orders, files, mockups, shipping rates, and store settings, so your agent can create products, prepare and manage orders, estimate fulfillment costs, generate mockups, and review store information on your behalf.

  • Catalog and product research: Have your agent browse catalog categories and products, retrieve variant details and size guides, and check available print files before creating merchandise.
  • Store product management: Let the agent create, inspect, and remove store products and variants, or retrieve product templates for managing your Printful storefront.
  • Order and fulfillment workflows: Direct your agent to create draft orders, estimate item and fulfillment costs, calculate shipping rates, retrieve orders, cancel pending orders, or submit drafts for fulfillment.
  • Files and mockup generation: Instruct your agent to add design files from public URLs, inspect file details, create mockup tasks, check their results, and retrieve mockup templates.
  • Store operations and settings: Have your agent review store details and statistics, inspect webhook settings, disable webhook configurations, list approval sheets, or approve designs for held orders.

Use Printful from Atomic Agent

With your account connected, ask Atomic Agent to work with Printful in natural language. You can connect more apps through the same Composio integration as you need them.

Visit the Atomic Agent website or inspect the Atomic Agent source code.

Troubleshooting

Why is my API key rejected?

Copy the key directly from the Composio dashboard. Atomic Agent requires ASCII characters because it sends the key in an HTTP header. Remove any extra characters introduced when copying.

Why are Composio tools unavailable after saving a key?

Check that you use Atomic Agent v0.5.6 or later and that Composio is enabled in your configuration. A "composio": { "enabled": false } setting disables the integration while keeping the saved key on disk.

Does Composio have a free plan?

The Hobby plan includes 100,000 tool calls per month. Composio-managed OAuth apps have a lower included allowance. See Composio pricing for the current limits that apply to your connection.

TOOLS

Supported Tools

Every Printful action and event your agent gets out of the box.

V1 Add File

Add a file to the Printful v1 file library from a public URL.

V1 Approve Design

Approves a design using its approval-sheet confirm hash and removes the order hold.

V1 Calculate Shipping Rates

Calculate Printful v1 shipping methods and rates for a recipient and products.

V1 Cancel Order

Cancel a pending or draft Printful v1 order and return charged funds when applicable.

V1 Confirm Order

Irreversibly submit a Printful v1 draft order for fulfillment; this may incur charges.

V1 Create Mockup Task

Creates an asynchronous Printful v1 mockup generation task.

V1 Create Order

Create a Printful v1 order as a draft or immediately submit it for fulfillment.

V1 Create Store Product

Create a Printful v1 store sync product together with its configured variants and print files.

V1 Create Store Variant

Create a Printful v1 sync variant under an existing store sync product.

V1 Delete Ecommerce Sync Product

Delete a Printful v1 sync product and all of its sync variants.

V1 Delete Ecommerce Sync Variant

Delete configuration and disable automatic importing for a Printful v1 sync variant.

V1 Delete Product Template

Permanently delete an account-level Printful v1 product template.

V1 Delete Store Product

Permanently delete a Printful v1 store sync product and its variants.

V1 Delete Store Variant

Permanently delete a Printful v1 store sync variant.

V1 Disable Webhook Configuration

Removes the webhook URL and all enabled event types from the authorized Printful store.

V1 Estimate Order Costs

Estimate Printful v1 item, print, shipping, and tax costs without creating an order.

V1 Get Catalog Category

Get one Printful v1 catalog category by category ID.

V1 Get Catalog Product

Get a Printful v1 catalog product and all of its variants by product ID.

V1 Get Catalog Product Size Guide

Get the Printful v1 size guide for a catalog product in selected units.

V1 Get Catalog Variant

Get a Printful v1 catalog variant and its parent product by variant ID.

V1 Get Ecommerce Sync Product

Get a Printful v1 sync product and its sync variants.

V1 Get Ecommerce Sync Variant

Get one Printful v1 ecommerce sync variant.

V1 Get File

Return information about a Printful v1 file-library file.

V1 Get Mockup Task

Returns the state and generated output of a Printful v1 mockup task.

V1 Get Mockup Templates

Retrieves Printful v1 templates for client-side mockup positioning.

V1 Get Order

Get a Printful v1 order by its Printful or external ID.

V1 Get Product Printfiles

Lists Printful v1 printfiles available for a product's variants.

V1 Get Product Template

Get an account-level Printful v1 product template by internal or external product ID.

V1 Get Store

Gets basic information about a Printful store by ID.

V1 Get Store Product

Get a Printful v1 store sync product and its variants by internal or external ID.

V1 Get Store Statistics

Returns Printful store statistics for selected report types and date range.

V1 Get Store Variant

Get a Printful v1 store sync variant by internal or external ID.

V1 Get Warehouse Product

Returns a Printful warehouse product by ID.

V1 Get Webhook Configuration

Returns the webhook URL and enabled event types for the authorized Printful store.

V1 List Approval Sheets

Lists approval sheets for suggested changes to files on held Printful orders.

V1 List Catalog Categories

List the hierarchy of Printful v1 catalog categories.

V1 List Catalog Products

List all Printful v1 catalog products, optionally filtered by category IDs.

V1 List Countries

Return the Printful v1 list of accepted countries and states.

V1 List Ecommerce Sync Products

Return one page of Printful v1 ecommerce sync products.

V1 List OAuth Scopes

List permission names associated with the connected Printful token without returning the token itself.

V1 List Orders

Return one page of orders from the connected Printful v1 store.

V1 List Product Templates

Return one page of account-level Printful v1 product templates.

V1 List Store Products

Return one page of Printful v1 store sync products with status and category filters.

V1 List Stores

Gets basic information about stores available to the connected Printful credential.

V1 List Tax Countries

Return the Printful v1 countries and states that require sales-tax calculation.

V1 List Warehouse Products

Returns warehouse products from the authorized Printful store.

V1 Set Webhook Configuration

Enables or replaces the webhook URL and event types for the authorized Printful store.

V1 Submit Approval Sheet Bulk Changes

Submits alternative changes in bulk for approval sheets sharing a design group hash.

V1 Submit Approval Sheet Changes

Submits alternative changes for a design with a Printful approval sheet.

V1 Suggest Thread Colors

Suggest Printful embroidery thread colors that closely match an image.

V1 Update Ecommerce Sync Variant

Update writable fields of a Printful v1 ecommerce sync variant.

V1 Update Order

Update a Printful v1 unsubmitted order and optionally submit it for fulfillment.

V1 Update Store Packing Slip

Modifies packing slip information of the currently authorized Printful store using the v1 API.

V1 Update Store Product

Update writable fields of a Printful v1 store sync product and optionally replace its retained variant set.

V1 Update Store Variant

Update writable fields of a Printful v1 store sync variant.

V2 Add File

Add a URL-hosted file to the Printful v2 file library, or return the existing file for an identical URL.

V2 Calculate Shipping Rates

Calculate Printful v2 shipping services, prices, and delivery estimates for up to 100 typed items.

V2 Confirm Order

Irreversibly submit a Printful v2 draft order for fulfillment; this may incur charges.

V2 Create Mockup Tasks

Create one or more asynchronous Printful v2 mockup-generation tasks.

V2 Create Order

Create a Printful v2 draft order with fully typed recipient, item, design, customization, and retail-cost data.

V2 Create Order Estimation Task

Create an asynchronous Printful v2 cost-estimation task for typed catalog or product-template items.

V2 Create Order Item

Add a typed catalog or product-template item to an existing Printful v2 order.

V2 Delete Order

Permanently delete an eligible draft, failed, or cancelled Printful v2 order.

V2 Delete Order Item

Remove one item from a Printful v2 order.

V2 Disable Webhook Configuration

Remove the Printful v2 webhook URL and all enabled event types.

V2 Disable Webhook Event

Disable one Printful v2 webhook event while preserving other event settings.

V2 Download Approval Sheet PDF

Download a Printful v2 approval sheet as a PDF file.

V2 Get Catalog Category

Get one Printful v2 catalog category by ID.

V2 Get Catalog Product

Get one Printful v2 catalog product by ID.

V2 Get Catalog Product Availability

Get paginated v2 stock availability for a Printful catalog product.

V2 Get Catalog Product Prices

Get paginated v2 pricing for a Printful catalog product and its variants.

V2 Get Catalog Product Size Guide

Get the v2 size guide for a Printful catalog product.

V2 Get Catalog Variant

Get one Printful v2 catalog variant by ID.

V2 Get Catalog Variant Availability

Get v2 stock availability for one Printful catalog variant.

V2 Get Catalog Variant Prices

Get v2 pricing for one Printful catalog variant and its parent product.

V2 Get File

Retrieve metadata and processing status for a Printful v2 file-library entry.

V2 Get Order

Retrieve one Printful v2 order by its Printful or external ID.

V2 Get Order Estimation Task

Retrieve a Printful v2 order cost estimation task; completed results remain available for one hour.

V2 Get Order Invoice

Retrieve a Printful v2 order invoice as base64-encoded PDF content.

V2 Get Order Item

Retrieve one fully detailed item from a Printful v2 order.

V2 Get Store

Retrieve one Printful v2 store by its resource ID.

V2 Get Store Statistics

Retrieve selected Printful v2 statistics for one store over a period of at most six months.

V2 Get Warehouse Product

Retrieve one Printful v2 warehouse product with its variants and stock locations.

V2 Get Webhook Configuration

Return the Printful v2 webhook configuration for the connected store.

V2 Get Webhook Event Configuration

Return one Printful v2 webhook event configuration.

V2 List Approval Sheets

Return one page of Printful v2 approval sheets awaiting or recording design review.

V2 List Catalog Categories

List categories in Printful's v2 catalog.

V2 List Catalog Product Categories

List the v2 catalog categories associated with a Printful product.

V2 List Catalog Product Images

List and filter blank images for a Printful v2 catalog product.

V2 List Catalog Product Mockup Styles

List available mockup styles for a Printful v2 catalog product.

V2 List Catalog Product Mockup Templates

List positional mockup template data for a Printful v2 catalog product.

V2 List Catalog Products

List and filter products in Printful's v2 catalog.

V2 List Catalog Product Shipping Countries

List countries to which a Printful v2 catalog product can be shipped.

V2 List Catalog Product Variants

List one page of v2 catalog variants belonging to a Printful product.

V2 List Catalog Variant Images

List and filter images for a Printful v2 catalog variant.

V2 List Countries

List countries and states where Printful is available using the v2 API.

V2 List Mockup Tasks

Return one page of asynchronous Printful v2 mockup tasks and their current results.

V2 List OAuth Scopes

List permission names associated with the connected Printful token using the v2 API without returning the token itself.

V2 List Order Items

Retrieve one page of items belonging to a Printful v2 order.

V2 List Orders

Retrieve one page of Printful v2 orders from the connected store.

V2 List Order Shipments

Retrieve one page of fulfillment shipments for a Printful v2 order.

V2 List Stores

Return one page of Printful v2 stores available to the connected credential.

V2 List Warehouse Products

Return one page of detailed Printful v2 warehouse products and variants.

V2 Set Webhook Configuration

Create or replace the Printful v2 webhook configuration for the connected store.

V2 Set Webhook Event Configuration

Create or replace one Printful v2 webhook event configuration.

V2 Update Order

Partially update writable fields of a Printful v2 order; omitted fields remain unchanged.

V2 Update Order Item

Update a Printful v2 catalog or product-template order item without changing its source.

FAQ

Frequently asked questions

Start with Printful.It takes 30 seconds.

Managed auth, hosted MCP servers, and every Printful tool your agent needs.Free to start.

Start building