SudoMock MCP Server

Generate photorealistic product mockups from Claude, Cursor, Windsurf, and VS Code.

Model Context Protocol server for the SudoMock mockup generation API. Upload PSD templates, place artwork onto smart objects, and get CDN-hosted renders -- all through natural language.

Quick Start

This is a local stdio server: your MCP client launches it as a child process via npx and authenticates with your SUDOMOCK_API_KEY.

claude mcp add sudomock \
  -e SUDOMOCK_API_KEY=sm_your_key_here \
  -- npx -y @sudomock/mcp

Get your API key at sudomock.com/dashboard/api-keys.

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

Note: A hosted remote (HTTP/OAuth) transport is not available yet. This package only ships the local stdio server shown above.

Tools

Async jobs

render_mockup and upload_psd accept is_async: true, and render_video is always async. These return a job_id immediately (HTTP 202) instead of a final result. Poll it with get_job, or let wait_for_job block until the job reaches a terminal status and hands back result_url, mockup_uuid, model, credits_charged, and payg ({credits, unit_price, cost} for pay-as-you-go jobs, otherwise null).

Webhooks

Register an endpoint with create_webhook_endpoint to be notified when async jobs finish. Deliveries are signed with TWO headers: X-SudoMock-Signature (a hex HMAC-SHA256 over ${timestamp}.${rawBody} using the secret returned at creation/rotation) and X-SudoMock-Timestamp (unix seconds). Verify in constant time and reject if |now - timestamp| > 300s. The delivery body is {event, job_id, kind, status, result_url, error, created_at}. Event types: render.succeeded, render.failed, upload.succeeded, video.succeeded, video.failed, webhook.test.

Example Prompts

• "List my mockup templates"
• "Render the t-shirt mockup with this design: https://example.com/logo.png"
• "List my 2D mockups, then render the first one with this artwork: https://example.com/logo.png"
• "Render this design asynchronously and wait for it to finish"
• "Animate the hoodie mockup into a 5-second video clip"
• "Upload this PSD as a new template: https://example.com/mockup.psd"
• "Set up a webhook at https://example.com/hooks so I get notified when renders finish"
• "How many credits do I have left?"

Links

• Dashboard -- Manage mockups and API keys
• API Docs -- Full REST API reference
• Pricing
• Status -- Service uptime

License

MIT