Skip to main content

MCP Server for AI-Assisted Development

Learn everything about Dynamic Mockups' MCP server.

Written by Dynamic Mockups Support
Updated over 2 months ago

Overview

The Dynamic Mockups MCP (Model Context Protocol) server enables AI assistants like Claude, ChatGPT, and development tools like Cursor to interact directly with your Dynamic Mockups account.

This allows AI agents to automate mockup workflows, implement integrations, and perform complex API operations through natural language commands.

What is MCP?

MCP (Model Context Protocol) is an open standard that allows AI assistants to access external tools and services. By connecting to the Dynamic Mockups MCP server, your AI assistant gains the ability to generate mockups, manage templates, create collections, and implement entire workflows, all through conversational requests.

Perfect for:

  • Developers building mockup automation with AI assistance

  • Teams using AI-powered development tools (Claude Code, Cursor)

  • ChatGPT Pro/Plus users automating mockup workflows

  • Agencies implementing client mockup systems with AI help

  • Anyone wanting to control Dynamic Mockups through AI conversations

MCP Server URL: https://mcp.dynamicmockups.com

Docs: https://docs.dynamicmockups.com/ai-assisted-development/mcp

What Can the MCP Server Do?

The MCP server provides AI assistants with comprehensive access to Dynamic Mockups functionality:

Mockup Generation

  • Create single mockup renders

  • Generate batch mockups across collections

  • Export production-ready print files

  • Apply designs to multiple templates simultaneously

Template Management

  • Browse and search mockup catalogs

  • Retrieve specific mockups by UUID

  • Upload custom Photoshop templates

  • Delete PSD files and related mockups

Organization

  • Create and manage collections

  • Organize mockups by catalog

  • Filter templates by category

  • Structure mockup libraries

Integration

  • Implement embeddable mockup editors

  • Generate integration code

  • Set up API workflows

  • Configure editor options

Special Effects

  • Transform images into embroidery effects

  • Apply realistic stitched patterns

  • Create unique design treatments

Knowledge Base

  • Get API documentation and best practices

  • Learn about rate limits and billing

  • Understand supported file formats

  • Access troubleshooting information

Supported AI Platforms

Claude Code

Claude Code is Anthropic's AI-powered coding assistant that works directly in your terminal.

Setup:

  1. Create a .mcp.json file in your project root

  2. Add the Dynamic Mockups server configuration:

{
  "mcpServers": {
    "dynamic-mockups": {
      "command": "npx",
      "args": ["-y", "@dynamic-mockups/mcp"],
      "env": {
        "DYNAMIC_MOCKUPS_API_KEY": "your_api_key_here"
      }
    }
  }
}

  1. Replace your_api_key_here with your actual API key from the API Dashboard

  2. Claude Code will automatically detect and connect to the server

Cursor

Cursor is an AI-powered code editor built on VS Code.

Setup:

  1. Create a .cursor/mcp.json file in your project directory

  2. Add the Dynamic Mockups server configuration:

{
  "mcpServers": {
    "dynamic-mockups": {
      "command": "npx",
      "args": ["-y", "@dynamic-mockups/mcp"],
      "env": {
        "DYNAMIC_MOCKUPS_API_KEY": "your_api_key_here"
      }
    }
  }
}

  1. Replace your_api_key_here with your API key

  2. Restart Cursor to load the MCP server

ChatGPT

ChatGPT (Pro, Plus, Business, Enterprise, or Education accounts) supports custom MCP servers.

Setup:

  1. Open ChatGPT settings

  2. Navigate to Custom Connectors or MCP Servers section

  3. Add a new server with these parameters:

Server URL: https://mcp.dynamicmockups.com

Authentication: API Key

API Key: Your Dynamic Mockups API key from the API Dashboard

  1. Save and activate the connector

Note: MCP server access requires a paid ChatGPT plan (Pro, Plus, Business, Enterprise, or Education).

Lovable

Lovable is a platform for building applications with AI assistance. MCP support is available on Business and Enterprise accounts.

Setup:

  1. Access your Lovable project settings

  2. Navigate to Custom Connectors

  3. Add Dynamic Mockups MCP server:

Server URL: https://mcp.dynamicmockups.com

Authentication: API Key

API Key: Your Dynamic Mockups API key

  1. Activate the connector in your project

Other MCP-Compatible Tools

MCP is an open protocol supported by many AI development tools. For platforms not specifically listed above:

Generic Configuration:

{ "dynamic-mockups": { "url": "https://mcp.dynamicmockups.com", "headers": { "x-api-key": "your_api_key_here" } } }

Authentication Method: API Key

Header Name: x-api-key

Refer to your specific tool's documentation for detailed MCP server configuration instructions.

Available Tools

The MCP server exposes 12 tools that AI assistants can use to interact with Dynamic Mockups:

API Information

Tool: get_api_info

Description: Retrieves comprehensive API documentation, including billing information, rate limits, supported file formats, best practices, and support resources.

AI Prompt Example:

  • "What are the rate limits for Dynamic Mockups?"

  • "Which file formats are supported?"

  • "How does credit billing work?"

Mockup Editor Integration

Tool: embed_mockup_editor

Description: Generates code and configuration for implementing the embeddable mockup editor in web applications.

AI Prompt Example:

  • "Add the full mockup editor to my web application"

  • "Implement a product customizer on my site"

  • "Show me how to embed the mockup editor"

Catalog Management

Tool: get_catalogs

Description: Retrieves all available mockup catalogs in your account.

AI Prompt Example:

  • "Get my Dynamic Mockups catalogs"

  • "List all my mockup categories"

  • "Show me available template catalogs"

Collection Operations

Tool: get_collections

Description: Retrieves collections, optionally filtered by catalog UUID.

AI Prompt Example:

  • "Show me all collections"

  • "Get collections in my T-shirt catalog"

  • "List my mockup collections"

Tool: create_collection

Description: Creates a new collection for organizing mockup templates.

AI Prompt Example:

  • "Create a new collection called Winter 2025 Hoodies"

  • "Make a collection for coffee mug mockups"

  • "Set up a Spring collection"

Mockup Discovery

Tool: get_mockups

Description: Retrieves list of available mockups with optional filtering by catalog or collection.

AI Prompt Example:

  • "Show me all mockups in my T-shirt collection"

  • "List available hoodie mockups"

  • "Get all mockups from my apparel catalog"

Tool: get_mockup_by_uuid

Description: Retrieves detailed information about a specific mockup using its UUID.

AI Prompt Example:

  • "Get mockup details for UUID abc123..."

  • "Show me information about this specific mockup"

  • "What smart objects does this mockup have?"

Mockup Generation

Tool: create_render

Description: Generates a single mockup with your design asset.

AI Prompt Example:

  • "Create a mockup render using any T-shirt mockup with my artwork from url: https://example.com/my-design.png"

  • "Generate a mockup with my logo on a coffee mug"

  • "Render my design on a phone case template"

Tool: create_batch_render

Description: Renders multiple mockups in a single operation, typically across a collection.

AI Prompt Example:

  • "Render my artwork from url: https://example.com/my-design.png on all mockups in the Winter T-shirt collection"

  • "Generate mockups for my logo across all coffee mug templates"

  • "Create batch renders for this design on every hoodie mockup"

Print File Export

Tool: export_print_files

Description: Exports high-resolution, production-ready print files at specified DPI.

AI Prompt Example:

  • "Export print-ready files at 300 DPI for my poster mockup"

  • "Generate production files for printing"

  • "Create high-res print files for this design"

PSD Template Management

Tool: upload_psd

Description: Uploads a Photoshop file and optionally creates a mockup template from it.

AI Prompt Example:

  • "Upload my PSD mockup from url: https://example.com/my-mockup.psd and create a template from it"

  • "Add this custom Photoshop file as a template"

  • "Upload PSD and make it available for rendering"

Tool: delete_psd

Description: Deletes a PSD file with optional deletion of related mockup templates.

AI Prompt Example:

  • "Delete PSD file with UUID xyz789..."

  • "Remove this Photoshop template and all related mockups"

  • "Delete the PSD but keep the generated mockups"

Special Effects

Tool: tool_create_embroidery_effect

Description: Transforms any image into a realistic embroidery or stitched effect.

AI Prompt Example:

  • "Transform my logo into an embroidery effect from url: https://example.com/my-logo.png"

  • "Create a stitched version of this design"

  • "Apply embroidery effect to my artwork"

Common Use Cases

Automated Mockup Workflows

Ask your AI assistant to implement complete mockup generation pipelines:

Example Conversation:

You: "When a new order comes in with a custom design, automatically generate mockups on all my T-shirt templates and email them to the customer."

AI Assistant: Uses MCP tools to:

  • Retrieve T-shirt collection (get_collections)

  • Create batch render (create_batch_render)

  • Generate implementation code with error handling

  • Set up email notification system

Dynamic Catalog Management

Let AI help organize your growing template library:

Example Conversation:

You: "Organize all my apparel mockups into seasonal collections: Spring, Summer, Fall, Winter."

AI Assistant: Uses MCP tools to:

  • Get all apparel mockups (get_mockups)

  • Create four new collections (create_collection)

  • Categorize mockups by characteristics

  • Provide summary of organization

Integration Implementation

Have AI build custom integrations:

Example Conversation:

You: "Add a product customizer to my e-commerce site where customers can upload designs and see instant previews."

AI Assistant: Uses MCP tools to:

  • Generate embed code (embed_mockup_editor)

  • Configure editor options

  • Implement callback handling

  • Create customer preview system

Batch Processing

Process multiple designs efficiently:

Example Conversation:

You: "Take all PNG files in my /designs folder and generate mockups on every coffee mug template I have."

AI Assistant: Uses MCP tools to:

  • Scan directory for PNG files

  • Retrieve coffee mug templates (get_mockups)

  • Create batch renders for each design (create_batch_render)

  • Organize outputs by design name

Print Production

Prepare files for manufacturing:

Example Conversation:

You: "Export print-ready files for all mockups in my Summer catalog at 300 DPI."

AI Assistant: Uses MCP tools to:

  • Get Summer catalog mockups (get_mockups)

  • Export print files for each (export_print_files)

  • Organize by product type

  • Create production-ready package

Setup Instructions

Step 1: Get Your API Key

  1. Log in to Dynamic Mockups

  2. Navigate to the API Dashboard

  3. Click "Create new API key"

  4. Copy your API key securely

Step 2: Choose Your Platform

Select your AI development tool or assistant:

  • Claude Code

  • Cursor

  • ChatGPT Pro/Plus/Business/Enterprise/Education

  • Lovable (Business/Enterprise)

  • Other MCP-compatible tools

Step 3: Configure MCP Server

Follow the platform-specific instructions above to add the Dynamic Mockups MCP server with your API key.

Step 4: Test the Connection

Verify the connection by asking your AI assistant:

"What tools do you have access to from Dynamic Mockups?"

Your AI should list the 12 available MCP tools.

Step 5: Start Building

Begin using natural language to interact with Dynamic Mockups:

"Show me all my mockup templates."

"Create a mockup with this design: [URL]"

"Set up a batch workflow for my product catalog."

Example Workflows

Workflow 1: Product Launch Automation

Scenario: Launching a new product line with multiple design variations.

Conversation:

You: 

"I'm launching a new hoodie line with 5 designs.  Create mockups for all designs on every hoodie template  in my Winter collection."  

AI: 

[Uses get_collections to find Winter collection]     [Uses get_mockups to get hoodie templates]     [Uses create_batch_render for each design]     "I've generated mockups for all 5 designs across      12 hoodie templates. That's 60 mockup variations      ready for your launch."

Workflow 2: Client Portal Integration

Scenario: Building a client portal where customers customize products.

Conversation:

You: 

"Add a mockup editor to my client portal at  /customize. Use dark theme and only show my  brand color palette."  

AI: 

[Uses embed_mockup_editor tool]     [Generates configuration code]     [Implements theme and color settings]     "I've added the embeddable editor to your portal      with dark theme and your brand colors. Here's the      implementation code..."

Workflow 3: Print File Preparation

Scenario: Preparing files for manufacturing partner.

Conversation:

You: 

"Generate 300 DPI print files for all mockups  used in today's orders."  

AI: 

[Retrieves order mockups]     [Uses export_print_files for each]     [Organizes by order number]     "Print files exported at 300 DPI for 47 mockups      across 12 orders. Files are organized by order ID      and ready for production."

Workflow 4: Template Organization

Scenario: Cleaning up and organizing a large template library.

Conversation:

You: 

"Organize my mockups into collections by product  type and create a summary report."  

AI: 

[Uses get_mockups to retrieve all templates]     [Analyzes mockup types]     [Creates collections with create_collection]     [Generates report]     "Created 8 collections: T-Shirts (127), Hoodies (45),      Mugs (89), Phone Cases (34), Pillows (23), Blankets (18),      Wall Art (67), Tote Bags (31). All mockups organized."

Best Practices

Be Specific with Prompts

✅ Good: "Create a mockup using the blue t-shirt template with my logo from https://example.com/logo.png"

❌ Vague: "Make a mockup"

Provide URLs for Assets

Always include full URLs when referencing design files:

✅ Good: "Use my artwork from url: https://example.com/design.png"

❌ Bad: "Use my design from the folder"

Name Collections Clearly

Use descriptive names for collections:

✅ Good: "Create a collection called 'Spring 2025 T-Shirts - Floral Collection'"

❌ Bad: "Make a new collection"

Verify Complex Workflows

For multi-step operations, ask the AI to explain the plan first:

"Before you start, explain what steps you'll take to batch render all my designs."

Monitor Credit Usage

Remember that MCP server operations consume credits from your account:

"How many credits will this batch operation use?"

Handle Errors Gracefully

If something fails, provide context:

"The render failed. Here's the error message: [error]. What went wrong?"

Limitations

Rate Limits: MCP server operations follow standard API rate limits

File Access: AI can only access publicly available URLs for design assets

Credit Consumption: All rendering operations consume credits as normal

Authentication Required: Valid API key must be configured

Network Dependent: Requires active internet connection

Platform Restrictions: Some platforms require paid plans for MCP access

Troubleshooting

MCP Server Not Connecting

Symptoms:

  • AI doesn't recognize Dynamic Mockups tools

  • Connection errors in console

Solutions:

✅ Verify API Key: Ensure API key is correctly entered in configuration

✅ Check File Location: Confirm .mcp.json is in correct directory

✅ Restart Tool: Restart your AI development environment

✅ Test API Key: Verify key works with direct API call

✅ Review Logs: Check console for connection error messages

Tool Not Working as Expected

Solutions:

✅ Be More Specific: Provide detailed prompts with full context

✅ Check Tool Availability: Ask AI "What Dynamic Mockups tools do you have?"

✅ Verify Parameters: Ensure URLs and UUIDs are correct

✅ Review Error Messages: AI should relay any API errors

Credits Not Being Used Correctly

Solutions:

✅ Check Account Balance: Verify sufficient credits available

✅ Monitor Usage: Review credit consumption in dashboard

✅ Understand Costs: Different operations use different credit amounts

Technical Details

Protocol: Model Context Protocol (MCP)

Server URL: https://mcp.dynamicmockups.com

Authentication: API Key via x-api-key header

Available Tools: 12 tools covering full API functionality

NPM Package: @dynamic-mockups/mcp

Supported Platforms: Claude Code, Cursor, ChatGPT, Lovable, and other MCP-compatible tools

Security Considerations

✅ Protect API Keys: Never commit API keys to version control

✅ Use Environment Variables: Store keys in .env files or secure vaults

✅ Rotate Keys Regularly: Generate new keys periodically

✅ Monitor Usage: Watch for unexpected API activity

✅ Limit Permissions: Only share keys with authorized team members

Getting Help

Documentation

Support

Feedback

We're actively expanding MCP server capabilities. If you have feedback or want to see additional tools added, please contact our support team.

Additional Resources

Related Articles
What is Dynamic Mockups?
Make Integration Guide
Zapier Integration Guide
Dynamic Mockups API: Complete Guide
Photoshop Integration
Did this answer your question?