SudoMock

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).