SudoMock

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

Model Context Protocolserver for theSudoMockmockup generation API. Upload PSD templates, place artwork onto smart objects, edit supported text layers, and get rendered image URLs -- all through natural language.

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

Get your API key atsudomock.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.

render_mockup,upload_psd,create_2d_mockup, and both 2D render tools acceptis_async: true, andrender_videois always async. These return ajob_idimmediately (HTTP 202) instead of a final result. (create_2d_mockupand the 2D render tools are synchronous by default and return the mockup / render directly.) Poll it withget_job, or letwait_for_jobblock until the job reaches a terminal status and hands backresult_url,mockup_uuid,credits_charged, andpayg({credits, unit_price, cost}for pay-as-you-go jobs, otherwisenull).

For a 2D render, pick the tool that matches the target you read fromget_2d_mockup. Every printable product in the photo is a surface with its ownsurface_uuid:render_2d_surfaceprints across the whole of one, and takes either acoveragepercentage or an explicitwidth+height. A print area is a bounded zone somebody drew on a product, such as a chest logo:render_2d_print_areatakes itsprint_area_uuid, and either afitor an explicitwidth+height. A product can have both, and they are separate targets -- a saved print area does not close off the surface it sits on.

Sizing has one answer per render: send the relative option or the exact box, never both, and sendwidthandheighttogether.position,offset_x,offset_yandrotationplace the artwork on either kind of target. Anything you leave out is left out of the request, so the renderer's own default applies rather than a copy of it kept here.

remove_backgroundreturns a transparent-PNG URL valid for 7 days. You can pass that URL straight back asartwork_urlduring that window. To clean artwork inline during a single render instead, passremove_background: truetorender_mockupor either 2D render tool. Either way it costs 25 credits per artwork, refunded automatically if processing fails.

Register an endpoint withcreate_webhook_endpointto 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) andX-SudoMock-Timestamp(unix seconds). Verify in constant time and reject if|now - timestamp| > 300s.

Render, upload, and video job deliveries use{event, job_id, kind, status, result_url, error, created_at}. The typed 2D creation events addversion,mockup_id,name, and eitherprint_areas(ready) orreason(rejected). The typed 2D render events carrymockup_id,result_url, a public{error_code, message}failure when applicable, and optionalexport_format/duration_ms. Event types:render.succeeded,render.failed,upload.succeeded,video.succeeded,video.failed,2d_mockup.ready,2d_mockup.rejected,2d_mockup.failed,2d_render.succeeded,2d_render.failed,webhook.test.

Pay as you go is the entry tier, and it has no subscription. One PSD render costs$0.10, so $1 covers 10 of them. The minimum first payment is$5. 2D Mockups and video are priced by what they cost to produce rather than at the flat render rate, which is why the Credits column above is not uniform.

Volume plans start at$25/monthfor 5,000 renders. The lowest self-serve rate is$2.42 per 1,000 renders, on the annual Pro 50K plan.

A new account starts with500 credits, granted once, and needs no card to spend them. Until a card is verified and the $5 minimum is funded, that account is in trial, and every render it makes is watermarked and capped at1,024 px. It can keep5PSD templates, runonerender at a time, and a template that has gone 13 days without a render is removed.

Funding the balance lifts all of it at once. The watermark and the width cap come off, stored templates go to150, renders run25at a time alongside10concurrent uploads, and templates stop being removed for sitting idle.

Trial is not a separate plan. It is the unfunded state of the pay-as-you-go tier, soget_accountreports the same tier before and after funding; the balance is what changes.

Because of that, an account paying as it goes has no monthly allowance, andget_accountreportscredits_limitandcredits_remainingas0while the account is perfectly able to pay. Readprepaid_balancealongside them, or readfunding_summary, which states both in one line and never reports a funded account as0 / 0.

- "List my mockup templates"
- "Render the t-shirt mockup with this design:https://example.com/logo.png"
- "Replace the editable headline text, then render the mockup"
- "Cut out the background from this product photo, then render it on the tote bag"
- "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"
- "Queue that 2D mockup render async and give me the job id to track"
- "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 athttps://example.com/hooksso I get notified when renders finish"
- "How many credits do I have left?"

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

Official FLUX MCP server from Black Forest Labs. Generate, edit, vary, and browse FLUX.2 images directly in any MCP-compatible client