MCP Setup

Let your AI agents interact with the Dynamic Mockups API by using our MCP server.

The Model Context Protocol (MCP) server provides a set of tools that AI agents can use to interact with the Dynamic Mockups account and implement entire workflows into your system.

Connect to Dynamic Mockups MCP server

Lovable

You can enable MCP servers on Lovable if you have a Business or Enterprise account.

Use the following parameters when setting up your custom connector:

• The server URL is https://mcp.dynamicmockups.com.

• Use “Api key” as the authentication mechanism and use the Dynamic Mockups API key from your account.

Claude Code

In a file .mcp.json in the project root, add the following:

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

Cursor

In a file .cursor/mcp.json in the project, add the following:

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

ChatGPT

You can enable MCP servers on ChatGPT if you have a Pro, Plus, Business, Enterprise or Education account.

Use the following parameters when setting up your custom connector:

• The server URL is https://mcp.dynamicmockups.com.

• Use “Api key” as the authentication mechanism and use the Dynamic Mockups API key from your account.

Other

MCP is an open protocol supported by many clients. Your specific client documentation can advise you on how to connect.

Use the server URL https://mcp.dynamicmockups.com and “API key” as the authentication mechanism if possible.

Example:

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

Tools

The server exposes the following MCP tools. If you have feedback or want to see more tools, contact us.

Tool	Description	API reference
get_api_info	Get API knowledge base (billing, rate limits, formats, best practices, support)	API Info
embed_mockup_editor	Implement embeddable mockup editor in your app	Embed Editor SDK
get_catalogs	Retrieve all available catalogs	Get Catalogs
get_collections	Retrieve collections (optionally filter by catalog)	Get Collections
create_collection	Create a new collection	Create Collection
get_mockups	Get list of available mockups with optional filters	Get Mockups
get_mockup_by_uuid	Retrieve a specific mockup by UUID	Get Specific Mockup
create_mockup	Create a new AI mockup template from a prompt or image URL	MockAnything AI API
get_mockup_creation_status	Poll the status of a mockup creation task	MockAnything AI API
search_products	Search the POD product catalog used to ground AI Mockup creations	MockAnything AI API
get_product_details	Get a product's decoration areas (locations), colors and sizes - use a location to place artwork on a specific spot	MockAnything AI API
get_styles	Get visual styles available for MockAnything AI mockup generation	MockAnything AI API
create_render	Create a single mockup render with design assets	Create a Mockup Render
create_batch_render	Render multiple mockups in one request	Render Multiple Mockups
export_print_files	Export high-resolution print files for production	Export Print Files
get_video_models	List MotionMockups AI (image-to-video) models with durations, credit costs and aspect ratios	MotionMockups AI API
get_video_status	Poll the status of a MotionMockups AI video request; returns the video URL when complete	MotionMockups AI API
create_video	Generate a AI video from a product image URL (MotionMockups AI) - returns a request_id to poll	MotionMockups AI API
upload_psd	Upload a PSD file and optionally create a mockup template	Upload a PSD File
delete_psd	Delete a PSD file with optional related mockups deletion	Delete a PSD File
tool_create_embroidery_effect	Transform any image into a realistic embroidery/stitched effect	Tool Create Embroidery Effect

Use cases

Ask your AI assistant to:

Use Case	Example Prompt
Embed mockup 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"
Create a Mockup from Prompt	"Create a mockup of a guy wearing a Gildan 5000 t-shirt while running, then render my logo from url: https://example.com/my-logo.png on it"
Create a Mockup from Image URL	"Turn this product photo into a mockup: https://example.com/product.jpg, and render my artwork on it"
Decorate a specific area	"Create a Gildan 5000 t-shirt mockup and place my logo from url: https://example.com/my-logo.png on the left chest"
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 a video from image	"Create a video from this generated mockup image URL https://example.com/my-logo.png"
Create collection	"Create a new collection called Winter 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"
Create Embroidery Effect	"Transform my logo into an embroidery effect from url: https://example.com/my-logo.png"