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 |

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" |

Error Handling

The server returns clear error messages for common issues:

• API key not configured - Set DYNAMIC_MOCKUPS_API_KEY in your environment
• Invalid UUID - Ensure UUIDs are in correct format
• API errors - Check the returned message for details

Links

• Dynamic Mockups Website
• API Documentation
• Get API Key
• GitHub Repository
• GitHub Issues

License

MIT