home / mcp / dynamic mockups mcp server

Dynamic Mockups MCP Server

Provides a server to manage and render product mockups via MCP clients using per-user API keys.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "dynamic-mockups-mcp": {
      "url": "http://localhost:3000/mcp",
      "headers": {
        "DYNAMIC_MOCKUPS_API_KEY": "your_api_key_here"
      }
    }
  }
}

You can run the Dynamic Mockups MCP Server either locally in stdio mode (via npx) or as an HTTP/SSE endpoint for web-based clients. It lets you create and manage product mockups directly from AI assistants, using your own Dynamic Mockups API key for per-user credits and security.

How to use

Use an MCP client to connect to either the local stdio server or the HTTP server. In stdio mode, you run the MCP server as a local process and your client talks to it via standard input/output. In HTTP mode, you start a local HTTP server or host it, and your client connects through HTTP endpoints. In both cases you provide your own Dynamic Mockups API key per user to render mockups and access catalogs, mockups, and templates.

How to install

Prerequisites you need installed on your machine before running the server: Node.js 18 or higher.

Install and configure the MCP server for stdio mode by using a package runner command that includes the MCP package and your API key.

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

Additional configuration notes

For HTTP transport, you can run the server in HTTP mode and expose an endpoint that your MCP clients can reach. The server defaults to starting at http://localhost:3000. Use the environment variable MCP_TRANSPORT with the value http to enable HTTP transport.

DYNAMIC_MOCKUPS_API_KEY=your_key npm run start:http

Available tools

get_api_info

Fetch knowledge base details about billing, rate limits, formats, and support.

get_catalogs

Retrieve all available catalogs.

get_collections

Retrieve collections, with optional catalog filtering.

create_collection

Create a new collection for mockups.

get_mockups

List available mockups with optional filters.

get_mockup_by_uuid

Retrieve a specific mockup using its UUID.

create_render

Create a single mockup render with design assets (consumes 1 credit).

create_batch_render

Render multiple mockups in a single request (1 credit per image).

export_print_files

Export high-resolution print-ready files for production.

upload_psd

Upload a PSD file and optionally create a mockup template.

delete_psd

Delete a PSD file and optionally delete related mockups.