Automate Your Print-on-Demand Business with AI
šØ Printful MCP Server
**Automate Your Print-on-Demand Business with AI**
Connect Printful's powerful API to Claude, Cursor, and other AI assistants through the Model Context Protocol.
**š Quick Start** ā¢ **š§ Configuration** ā¢ **š Examples** ā¢ **š Documentation**
š **New to Printful?**
Start your print-on-demand business today ā¢ No upfront costs ā¢ 300+ products ā¢ Global fulfillment
āØ Features
šÆ **Complete API Coverage**
|
š”ļø **Production Ready**
|
š **Easy Integration**
|
š¤ **AI Skill Included**
|
š Bonus: This repo includes a Cursor AI skill that automatically teaches AI assistants how to use the Printful MCP effectively. Just open the project and start asking questions!
š Quick Start
š Prerequisites
- Python 3.10+ (Download)
- Printful API Key (Get one free)
ā” Installation (3 steps)
Step 1: Clone & Install
git clone https://github.com/Purple-Horizons/printful-ph-mcp.git
cd printful-ph-mcp
pip install -e .
Step 2: Set up API Key
cp .env.example .env
# Edit .env and add: PRINTFUL_API_KEY=your-key-here
Step 3: Configure Your AI Assistant
For Cursor
Add to ~/.cursor/mcp.json:
{
"mcpServers": {
"printful": {
"command": "python",
"args": ["-m", "printful_mcp"],
"cwd": "/path/to/printful-ph-mcp",
"env": {
"PRINTFUL_API_KEY": "your-api-key-here"
}
}
}
}
For Claude Desktop
Add to ~/Library/Application Support/Claude/claude_desktop_config.json:
{
"mcpServers": {
"printful": {
"command": "python",
"args": ["-m", "printful_mcp"],
"cwd": "/path/to/printful-ph-mcp",
"env": {
"PRINTFUL_API_KEY": "your-api-key-here"
}
}
}
}
ā That's it! Restart your AI assistant and start using Printful tools.
š Transport Options
By default, the server uses stdio transport (required for Cursor/Claude Desktop). For HTTP clients or tools like mcporter, you can use HTTP transport.
š” Available Transports
| Transport | Use Case | Command |
|---|---|---|
| stdio (default) | Cursor, Claude Desktop | python -m printful_mcp |
| http | HTTP clients, mcporter | python -m printful_mcp --transport http |
| sse | Legacy SSE clients | python -m printful_mcp --transport sse |
HTTP Transport Example:
# Start server on port 8000
python -m printful_mcp --transport http --port 8
Environment Variables
PRINTFUL_API_KEYrequiredPrintful API key required for authenticationConfiguration
{
"mcpServers": {
"printful": {
"command": "python",
"args": ["-m", "printful_mcp"],
"cwd": "/path/to/printful-ph-mcp",
"env": {
"PRINTFUL_API_KEY": "your-api-key-here"
}
}
}
}