SudoMock
NEW

SudoMock MCP Server

Connect Claude, Cursor, VS Code, Windsurf, and ChatGPT to your SudoMock account. Render photorealistic product mockups directly from your AI assistant.

The Model Context Protocol (MCP) lets AI assistants call external tools. SudoMock's MCP server gives your AI assistant direct access to mockup rendering, template management, and account info, so you can generate mockups with natural language instead of writing API calls.

Two Connection Methods

Remote (OAuth) connects directly to mcp.sudomock.com with browser-based auth. No API key needed.
Local (npx) runs a local MCP process using your API key. Works offline and in CI/CD pipelines.
MCP Server URL:https://mcp.sudomock.com

Quick Start

Copy Claude CLI Command
1claude mcp add --transport http sudomock https://mcp.sudomock.com

Remote (OAuth)

The fastest way to connect. Your AI client opens a browser window for authentication. No API key required.

One-liner for Claude Code
1claude mcp add --transport http sudomock https://mcp.sudomock.com

Local (npx)

Runs a local MCP process that communicates over stdio. Requires an API key.

Local with API key
1claude mcp add sudomock \
2 -e SUDOMOCK_API_KEY=sm_your_key \
3 -- npx -y @sudomock/mcp

Get Your API Key

Create an API key at sudomock.com/dashboard/api-keys. You get 500 free credits to start.

Supported Clients

SudoMock MCP works with all major AI coding assistants. Click a client below to jump to its setup instructions.

Platform Setup

Each section below shows both remote (OAuth) and local (API key) options. Pick one method per platform.

Claude Code

Claude Code
1# Remote (OAuth) - no API key needed
2claude mcp add --transport http sudomock https://mcp.sudomock.com
3
4# Local (npx) - requires API key
5claude mcp add sudomock \
6 -e SUDOMOCK_API_KEY=sm_your_key \
7 -- npx -y @sudomock/mcp

Claude Desktop

Add to your Claude Desktop config file (claude_desktop_config.json):

claude_desktop_config.json
1{
2 "mcpServers": {
3 "sudomock-remote": {
4 "type": "http",
5 "url": "https://mcp.sudomock.com"
6 },
7 "sudomock-local": {
8 "command": "npx",
9 "args": ["-y", "@sudomock/mcp"],
10 "env": {
11 "SUDOMOCK_API_KEY": "sm_your_key"
12 }
13 }
14 }
15}

Cursor

CursorInstall in Cursor

Or add manually to .cursor/mcp.json in your project root:

.cursor/mcp.json
1{
2 "mcpServers": {
3 "sudomock-remote": {
4 "type": "http",
5 "url": "https://mcp.sudomock.com"
6 },
7 "sudomock-local": {
8 "command": "npx",
9 "args": ["-y", "@sudomock/mcp"],
10 "env": {
11 "SUDOMOCK_API_KEY": "sm_your_key"
12 }
13 }
14 }
15}

VS Code

VS CodeInstall in VS Code

Or add manually to .vscode/mcp.json in your workspace:

.vscode/mcp.json
1{
2 "servers": {
3 "sudomock-remote": {
4 "type": "http",
5 "url": "https://mcp.sudomock.com"
6 },
7 "sudomock-local": {
8 "command": "npx",
9 "args": ["-y", "@sudomock/mcp"],
10 "env": {
11 "SUDOMOCK_API_KEY": "sm_your_key"
12 }
13 }
14 }
15}

ChatGPT

In ChatGPT settings, add the MCP server URL. ChatGPT handles OAuth automatically.

ChatGPT
1# In ChatGPT settings, add this URL as an MCP server:
2https://mcp.sudomock.com
3
4# ChatGPT handles OAuth automatically.
5# No API key needed.

Windsurf

Add to your Windsurf MCP configuration file (~/.codeium/windsurf/mcp_config.json):

mcp_config.json
1{
2 "mcpServers": {
3 "sudomock-remote": {
4 "type": "http",
5 "url": "https://mcp.sudomock.com"
6 },
7 "sudomock-local": {
8 "command": "npx",
9 "args": ["-y", "@sudomock/mcp"],
10 "env": {
11 "SUDOMOCK_API_KEY": "sm_your_key"
12 }
13 }
14 }
15}

Which method to choose?

Use Remote (OAuth) if you want zero-config setup with browser login. Use Local (npx) if you need offline access, CI/CD automation, or prefer API key auth.

Available Tools

The MCP server exposes 9 tools organized into four categories. Each tool links to its full API documentation.

Rendering

Generate product mockups from templates or product photos.

ToolDescriptionCredits
render_mockupRender a mockup by placing artwork onto a PSD template. Returns a CDN URL.1
ai_renderAI-powered render without a PSD. Upload any product photo + artwork.5

Template Management

Upload, browse, update, and delete your mockup templates.

ToolDescriptionCredits
list_mockupsList your uploaded mockup templates with UUIDs, names, and thumbnails.0
get_mockup_detailsGet full details: smart object UUIDs, layer names, dimensions, blend modes.0
upload_psdUpload a Photoshop PSD/PSB file as a new mockup template.0
update_mockupRename a mockup template.0
delete_mockupPermanently delete a mockup template. Cannot be undone.0

Account

Check your plan, credit balance, and usage.

ToolDescriptionCredits
get_accountGet your account info: plan, credit balance, usage stats.0

Studio

Create interactive mockup editing sessions.

ToolDescriptionCredits
create_studio_sessionCreate an embedded studio session for interactive mockup editing.0

Use Cases

Here are common workflows you can accomplish with the MCP server. Just type these prompts into your AI assistant.

Use CaseExample Prompt
E-commerce product launchRender my logo on all t-shirt mockups in WebP format
Print-on-demand automationUpload this PSD and render with my design at 2x size
Brand asset generationPut my new branding on every hoodie and mug mockup
Quick product photoUse AI render to place my artwork on this product photo
Template managementShow me all my mockups and delete the ones named "Old Template"
Credit monitoringHow many credits do I have left? What plan am I on?

Example Prompts

Once connected, talk to your AI assistant naturally. Here are some things you can say:

>Show me my mockup templates
>Render this design on my t-shirt mockup: https://example.com/design.png
>Upload this PSD as a new template: https://example.com/hoodie.psd
>How many credits do I have left?
>Render my logo on all my mockups in WebP format at 2x size
>Use AI render to put my artwork on this product photo
>Delete the mockup called "Old Template"
>Show me the smart object layers in my mug mockup

Batch Rendering

You can ask your AI to render across multiple mockups in one conversation. For example: “Put my design on all t-shirt and hoodie mockups and give me the URLs.”

Built-in Resources & Prompts

The MCP server includes built-in documentation and guided workflows that your AI assistant can read automatically.

Resources (Documentation)

URIDescription
docs://quickstartQuick start guide for the SudoMock API and MCP tools
docs://pricingLive pricing data, credit costs, and plan comparison
docs://formatsSupported output formats, input requirements, and all 27 blend modes

Prompts (Guided Workflows)

PromptDescription
render_product_mockupsStep-by-step guide through creating mockups for a product. Provide your artwork URL and optional product type.
troubleshoot_renderDiagnose and fix a render issue. Walks through credit checks, UUID validation, and common error codes.

Authentication

The remote server at mcp.sudomock.com supports two authentication methods:

1
OAuth 2.1 (Recommended)
Browser-based login via your SudoMock account. The AI client handles the OAuth flow automatically. No API key to manage.
2
API Key
Pass your sm_ API key via the x-api-key header or Authorization: Bearer header. Used by the local npx transport.

Security Best Practices

API Key Storage
Never commit API keys to source control. Store them in environment variables or a secrets manager. Use .env files locally and add them to .gitignore.
OAuth Token Expiry
OAuth tokens auto-expire and are refreshed automatically by the MCP client. You can revoke active sessions from your dashboard.
Credit Awareness
Each render costs credits (render_mockup = 1 credit, ai_render = 5 credits). Check your balance anytime with get_account before batch operations.
Permissions
API keys currently have full access to your account (all tools and templates). Granular permission scopes are on the roadmap. Use separate API keys for different environments (development vs production).
MCP Server | SudoMock Docs