SudoMock

Name: SudoMock
Author: sudomock

@sudomock

Repository

About SudoMock

SudoMock MCP Server - Generate mockups from Claude, Cursor, VS Code, and ChatGPT

#mockup #psd #render #e-commerce #print-on-demand #image-generation #api #shopify #ai

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "sudomock": {
      "command": "npx",
      "args": [
        "-y",
        "@sudomock/mcp"
      ],
      "env": {
        "SUDOMOCK_API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}

Tools

List your uploaded mockup templates with UUIDs, names, and thumbnails. Use returned UUIDs with render_mockup or get_mockup_details.

Get full details of a mockup: smart object UUIDs, layer names, dimensions, positions, blend modes, and thumbnail URLs.

Rename a mockup template.

Permanently delete a mockup template. Cannot be undone.

Render a mockup by placing artwork onto a PSD template's smart object. Returns the CDN URL of the rendered image. Costs 1 credit. Use list_mockups to find mockup_uuid, then get_mockup_details for smart_object_uuid.

AI-powered mockup render without needing a PSD template. Upload any product photo + artwork, AI detects the printable surface and renders with perspective correction. Costs 5 credits.

Upload a Photoshop PSD/PSB file as a new mockup template. The PSD must have at least one Smart Object layer. Processing takes 5-30 seconds.

Get your account info: subscription plan, credit balance, usage stats, billing period, and API key details.

Create an embedded studio session for interactive mockup editing in a web page. Returns a 15-minute session token for iframe embedding.

Overview

What is SudoMock?

SudoMock is a Model Context Protocol server that integrates the SudoMock mockup generation API into AI coding assistants like Claude, Cursor, Windsurf, and VS Code. It lets users generate photorealistic product mockups by uploading PSD templates and placing artwork onto smart objects through natural language commands.

How to use SudoMock?

Install and configure by adding a stdio MCP client entry that runs npx -y @sudomock/mcp and sets the SUDOMOCK_API_KEY environment variable. Get your API key from sudomock.com/dashboard/api-keys. Once connected, issue natural language prompts to list, render, or manage mockups.

Key features of SudoMock

List, upload, and manage PSD/PSB mockup templates
Render artwork onto smart objects with sync or async jobs
Generate 2D mockups from saved templates without PSD
Animate mockups into AI video clips
Create and manage webhook endpoints for async job notifications
Check account plan, credits, and usage

Use cases of SudoMock

Render a design onto a t-shirt mockup from an image URL
Animate a hoodie mockup into a short video clip
Upload a new PSD template and render artwork onto it
Set up webhooks to automatically receive render completion updates
Monitor credit usage and balance directly from the assistant

FAQ from SudoMock

How do I get an API key?

Visit sudomock.com/dashboard/api-keys to generate your API key. It is used as the SUDOMOCK_API_KEY environment variable.

What transport does this server use?

The server uses a local stdio transport. A hosted remote (HTTP/OAuth) transport is not available yet.

How do async jobs work?

render_mockup and upload_psd accept is_async: true, and render_video is always async. These return a job_id immediately. You can poll with get_job or use wait_for_job to block until completion and receive result details.

How is webhook delivery verified?

Deliveries include two headers: X-SudoMock-Signature (HMAC-SHA256 over ${timestamp}.${rawBody}) and X-SudoMock-Timestamp (unix seconds). Verify in constant time and reject if |now - timestamp| > 300s.

What are the credit costs for each tool?

Most tools cost 0 credits. render_mockup costs 1 credit per render. render_2d_mockup costs 5 credits. render_video costs vary and is cost-based (free for one lifetime render).