Details
Overview
Printful MCP (Purple-Horizons/printful-mcp) is a Python Model Context Protocol server for Printful's print-on-demand API. It targets Claude Desktop, Cursor, and other MCP hosts that need catalog browsing, order management, mockup generation, shipping helpers, and store analytics without hand-writing Printful REST calls.
The README describes production-oriented touches: Pydantic validation, rate-limit handling, dual JSON/Markdown outputs, stdio (default) plus HTTP/SSE transports, and an optional Cursor skill that teaches the agent how to use the tools.
Key Features
- Printful API v2 coverage: Broad tool set across catalog, orders, fulfillment, and analytics (README cites on the order of 17 tools).
- Mockups & catalog: Browse products and generate mockups for POD merchandising workflows.
- Order automation: Create and manage Printful orders from the assistant thread.
- Shipping helpers: Rate/shipping oriented tools for fulfillment planning.
- Transport options: stdio for desktop editors; HTTP/SSE for remote clients.
- Cursor skill: Bundled guidance so agents apply Printful workflows more reliably.
How to Use
- Install an MCP-compatible host (Claude Desktop, Cursor, Claude Code, etc.).
- Clone or install the server from https://github.com/Purple-Horizons/printful-mcp and follow the README for build /
npx/ Docker commands. - Create API credentials for the underlying platform and put them in the MCP
envblock — never commit secrets. - Register the server in your client MCP config (Claude Desktop
claude_desktop_config.jsonor Cursormcp.json), then restart the client. - Start with read-only prompts; enable write tools only after you understand scopes and confirmation settings.
Pricing
| Plan | Billing | Price | Notes |
|---|---|---|---|
| printful-mcp | — | Free (OSS, MIT per README badges) | Python 3.10+; needs PRINTFUL_API_KEY |
| Printful | Per Printful product/fulfillment | Varies | POD manufacturing & shipping billed by Printful |
Best For
Print-on-demand sellers and agencies running Printful who want Claude/Cursor to stand up products, check stock/pricing, or push orders during merchandising sessions.
FAQ
Official Printful MCP?
Community project by Purple Horizons using Printful's public API — not presented as Printful's first-party MCP in the README branding.
How do I install?
Clone, pip install -e ., set PRINTFUL_API_KEY, then register the python -m printful_mcp command in Cursor/Claude MCP config.
v1 vs v2?
README claims API v2 support with smart v1 fallback for legacy features.
Affiliate note?
The upstream README may include Printful signup referral links; FlowCay does not add affiliate parameters unless you supply them.