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
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.
https://mcp.sudomock.comQuick Start
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.
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.
1claude mcp add sudomock \2 -e SUDOMOCK_API_KEY=sm_your_key \3 -- npx -y @sudomock/mcp
Get Your API Key
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
1# Remote (OAuth) - no API key needed2claude mcp add --transport http sudomock https://mcp.sudomock.com34# Local (npx) - requires API key5claude 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):
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
Or add manually to .cursor/mcp.json in your project root:
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
Or add manually to .vscode/mcp.json in your workspace:
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.
1# In ChatGPT settings, add this URL as an MCP server:2https://mcp.sudomock.com34# ChatGPT handles OAuth automatically.5# No API key needed.
Windsurf
Add to your Windsurf MCP configuration file (~/.codeium/windsurf/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?
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.
| Tool | Description | Credits |
|---|---|---|
| render_mockup | Render a mockup by placing artwork onto a PSD template. Returns a CDN URL. | 1 |
| ai_render | AI-powered render without a PSD. Upload any product photo + artwork. | 5 |
Template Management
Upload, browse, update, and delete your mockup templates.
| Tool | Description | Credits |
|---|---|---|
| list_mockups | List your uploaded mockup templates with UUIDs, names, and thumbnails. | 0 |
| get_mockup_details | Get full details: smart object UUIDs, layer names, dimensions, blend modes. | 0 |
| upload_psd | Upload a Photoshop PSD/PSB file as a new mockup template. | 0 |
| update_mockup | Rename a mockup template. | 0 |
| delete_mockup | Permanently delete a mockup template. Cannot be undone. | 0 |
Account
Check your plan, credit balance, and usage.
| Tool | Description | Credits |
|---|---|---|
| get_account | Get your account info: plan, credit balance, usage stats. | 0 |
Studio
Create interactive mockup editing sessions.
| Tool | Description | Credits |
|---|---|---|
| create_studio_session | Create 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 Case | Example Prompt |
|---|---|
| E-commerce product launch | “Render my logo on all t-shirt mockups in WebP format” |
| Print-on-demand automation | “Upload this PSD and render with my design at 2x size” |
| Brand asset generation | “Put my new branding on every hoodie and mug mockup” |
| Quick product photo | “Use AI render to place my artwork on this product photo” |
| Template management | “Show me all my mockups and delete the ones named "Old Template"” |
| Credit monitoring | “How 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:
Batch Rendering
Built-in Resources & Prompts
The MCP server includes built-in documentation and guided workflows that your AI assistant can read automatically.
Resources (Documentation)
| URI | Description |
|---|---|
docs://quickstart | Quick start guide for the SudoMock API and MCP tools |
docs://pricing | Live pricing data, credit costs, and plan comparison |
docs://formats | Supported output formats, input requirements, and all 27 blend modes |
Prompts (Guided Workflows)
| Prompt | Description |
|---|---|
render_product_mockups | Step-by-step guide through creating mockups for a product. Provide your artwork URL and optional product type. |
troubleshoot_render | Diagnose 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:
sm_ API key via the x-api-key header or Authorization: Bearer header. Used by the local npx transport.Security Best Practices
.env files locally and add them to .gitignore.render_mockup = 1 credit, ai_render = 5 credits). Check your balance anytime with get_account before batch operations.