MCAgent guide

Generate product mockups with MCP

Connect Claude, Cursor, Codex, or any MCP client to SudoMock and render product mockups from inside the conversation. The hosted server at mcp.sudomock.com signs you in through your browser, so no API key is pasted anywhere. Start with 500 one-time renders, then choose a published monthly volume plan.

The agent lists your PSD templates and photo mockups, renders them with new artwork and text, and waits for long jobs to finish. Every render is billed exactly as an API render is, against the same account and the same credits.

Start Free, 500 CreditsRead the API Docs
Connect an agent
2,000+open-licensed font families25parallel renders on Scale500free renders, no card5Krenders on Starter

Add the SudoMock server to Claude Code

There is nothing to install and no key to copy. The client opens a browser window where you sign in to SudoMock and approve access.

Add the SudoMock server to Claude Code
1claude mcp add --transport http sudomock https://mcp.sudomock.com
2# Then open /mcp in Claude Code, select sudomock, and sign in

The render your agent sends

Ask for a render in plain words and the agent sends one tool call like this. It composites your design into the PSD template and returns a finished image URL, with Smart Objects, blend modes, smart filters, and perspective warp rendered from your real file.

Render, MCP
1{
2  "tool": "render_psd_mockup",
3  "arguments": {
4    "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
5    "smart_object_uuid": "128394ee-6758-4f2f-aa36-e2b19b152bd9",
6    "artwork_url": "https://your-domain.com/design.png",
7    "fit": "crop",
8    "image_format": "webp"
9  }
10}

How it works

  1. 1Add mcp.sudomock.com to your MCP client and sign in to SudoMock in the browser window it opens.
  2. 2Ask for what you want in plain words, such as "put this design on my hoodie template", and the agent picks the tool.
  3. 3The agent returns the finished image URL, or waits on the job with wait_for_job when the render runs asynchronously.

Personalize text in the same call

SudoMock renders the text layers in your PSD, so you can swap the wording, font, size, and color at render time and get back an image that keeps the look the designer built.

  • 2,000+ open-licensed font families, free for commercial use
  • Custom TTF and OTF font upload, up to 5 MB each, on Pro and Scale
  • Styled segments: mixed-style layers stay editable run by run
  • Box text: area text wraps inside its box and clips exactly as designed
Text layers, MCP
1{
2  "tool": "render_psd_mockup",
3  "arguments": {
4    "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
5    "text_layers": [{
6      "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
7      "text": "SUMMER SALE",
8      "font": "Poppins-Bold",
9      "font_size": 96,
10      "color": "#C0392B"
11    }]
12  }
13}

Edit one mixed-style layer, run by run

When a single layer mixes styles, like a thin first name next to a bold surname, send a segments array with only the runs you want to change. Every run keeps its own font, size, and color, and any run you leave out stays as designed. This bundle of catalog, custom upload, per-segment styling, and box wrap over the API is what sets the text layers apart.

Styled segments request
1{
2  "mockup_uuid": "c315f78f-d2c7-4541-b240-a9372842de94",
3  "text_layers": [
4    {
5      "uuid": "b7f2c1a0-9e34-4d21-8f0a-1c2b3d4e5f60",
6      "segments": [
7        { "index": 0, "text": "Jane " },
8        { "index": 1, "text": "SMITH" }
9      ]
10    }
11  ]
12}

Full field reference and the fallback behavior when a font is not in your catalog live in the text layers documentation.

Frequently asked questions

How do I connect an AI agent to SudoMock?

Add the remote MCP server https://mcp.sudomock.com to your client. In Claude Code that is one command: claude mcp add --transport http sudomock https://mcp.sudomock.com. The client opens a browser window where you sign in to SudoMock and approve access; no API key is pasted into the conversation.

Which clients work with the SudoMock MCP server?

Any client that supports remote MCP servers over HTTP, including Claude Code, Claude, Cursor, and Codex. A client that only runs local servers can use the @sudomock/mcp package from npm with an API key instead; both serve the same tools.

Can the agent edit text and fonts on a template?

Yes. The render_psd_mockup tool takes a text_layers list that changes wording, font, size, and color on named layers. The catalog carries 2,000+ open-licensed font families, and the agent reads your template's layer ids before it renders.

Render your first MCP mockup in minutes

Get 500 one-time API credits to test. No credit card required. See pricing for published monthly volumes and annual billing.

Start Free, 500 CreditsAll Integrations