mcp by Dynamic-Mockups - MCP Server

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

License

MIT

Dynamic-Mockups/mcp