Dynamic Mockups MCP Server
Official MCP server for Dynamic Mockups — a product mockup generator API. Create professional mockups directly from AI assistants like Claude, Cursor, and Windsurf.
Requirements
- Node.js 18 or higher
- Dynamic Mockups API key — get one here
Installation
Add the following to your MCP client configuration file:
{
"mcpServers": {
"dynamic-mockups": {
"command": "npx",
"args": ["-y", "@dynamic-mockups/mcp"],
"env": {
"DYNAMIC_MOCKUPS_API_KEY": "your_api_key_here"
}
}
}
}
Lovable
For Lovable, simply enter:
- Server URL:
https://mcp.dynamicmockups.com - API Key: Your Dynamic Mockups API key (get one here)
HTTP Transport
If you want to connect via HTTP instead of NPX, use:
{
"mcpServers": {
"dynamic-mockups": {
"type": "http",
"url": "https://mcp.dynamicmockups.com",
"headers": {
"x-api-key": "your_api_key_here"
}
}
}
}
Config File Locations
| Client | Config File Path |
|---|---|
| Claude Desktop (macOS) | ~/Library/Application Support/Claude/claude_desktop_config.json |
| Claude Desktop (Windows) | %APPDATA%\Claude\claude_desktop_config.json |
| Claude Code (CLI) | .mcp.json in project root |
| Cursor | .cursor/mcp.json in project |
| Windsurf | ~/.codeium/windsurf/mcp_config.json |
Tools
| Tool | Description |
|---|---|
get_api_info | Get API knowledge base (billing, rate limits, formats, best practices, support) |
embed_mockup_editor | Implement embeddable mockup editor in your app |
get_catalogs | Retrieve all available catalogs |
get_collections | Retrieve collections (optionally filter by catalog) |
create_collection | Create a new collection |
get_mockups | Get list of available mockups with optional filters |
get_mockup_by_uuid | Retrieve a specific mockup by UUID |
create_render | Create a single mockup render with design assets (1 credit) |
create_batch_render | Render multiple mockups in one request (1 credit per image) |
export_print_files | Export high-resolution print files for production |
upload_psd | Upload a PSD file and optionally create a mockup template |
delete_psd | Delete a PSD file with optional related mockups deletion |
tool_create_embroidery_effect | Transform any image into a realistic embroidery/stitched effect |
Usage Examples
Ask your AI assistant:
| Use Case | Example Prompt |
|---|---|
| Embed editor | "Add the full mockup editor to my web application" |
| List catalogs | "Get my Dynamic Mockups catalogs" |
| Browse mockups | "Show me all mockups in my T-shirt collection" |
| Single render | "Create a mockup render using any T-shirt mockup with my artwork from url: https://example.com/my-design.png" |
| Batch render | "Render my artwork from url: https://example.com/my-design.png on all mockups in the Winter T-shirt collection" |
| Create collection | "Create a new collection called Summer 2025 Hoodies" |
| Upload PSD | "Upload my PSD mockup from url: https://example.com/my-mockup.psd and create a template from it" |
| API info | "What are the rate limits and supported file formats for Dynamic Mockups?" |
| Print files | "Export print-ready files at 300 DPI for my poster mockup" |
| Embroidery effect | "Transform my logo into an embroidery effect from url: https://example.com/my-logo.png" |
Error Handling
The server returns clear error messages for common issues:
- API key not configured - Set
DYNAMIC_MOCKUPS_API_KEYin your environment - Invalid UUID - Ensure UUIDs are in correct format
- API errors - Check the returned message for details
Links
License
MIT