SudoMock MCP Server

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.

Quick Start

Paste this prompt into Codex, Claude Code, or another coding assistant. It connects your account and checks that the tools are available before you start rendering.

Fetch the SudoMock setup instructions from https://sudomock.com/agent-setup/prompt.md and help me connect this client. Keep my current task and existing configuration. Verify the connection before continuing my task.

Install in CursorInstall in VS Code

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

Supported Clients

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

CodexClaude CodeClaude DesktopCursorVS CodeChatGPTWindsurf

Platform Setup

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

Codex

1codex mcp add sudomock --url https://mcp.sudomock.com
2codex mcp login sudomock

Complete sign-in in your browser. Then ask Codex to check your SudoMock account with get_account. A successful connection confirms access; it does not create a mockup.

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

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

Install in 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

Install in 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.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):

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}

Available Tools

The MCP server exposes 27 tools in 6 categories. Each tool links to its full API documentation. Credit costs are the same as calling the REST API directly: management and read operations are free, and video is priced from the model and duration rather than at a flat rate.

Use Cases

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

Example Prompts

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

Built-in Resources & Prompts

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

Resources (Documentation)

Prompts (Guided Workflows)

Authentication

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

Security Best Practices

Links