Setup MCPStudio

Connect your IDE in 30 seconds

Fastest setup — auto-configure your IDE

Run this once in your terminal. It will ask for your token and which IDE(s) you use, then write the config files automatically.

npx mcpstudio-design setup

Requires Node.js 18+. Supports Cursor, Claude Desktop, Claude Code, Windsurf, VS Code.

or configure manually
1Get your API token

Sign up or log in, then copy your API token from the dashboard.

Go to Dashboard
2Configure your IDE
1.Create a .cursor/mcp.json file in your project root
2.Paste the config below, replacing YOUR_TOKEN_HERE with your token
3.Restart Cursor — MCPStudio tools will appear automatically
.cursor/mcp.json (in your project root)
JSON config
{
  "mcpServers": {
    "mcpstudio": {
      "command": "npx",
      "args": [
        "-y",
        "mcpstudio-design@latest"
      ],
      "env": {
        "MCPSTUDIO_TOKEN": "YOUR_TOKEN_HERE"
      }
    }
  }
}
3Verify it works

After configuring, ask your AI assistant to use MCPStudio. Try:

"Use MCPStudio to analyze the design quality of my current page"

The assistant should discover mcpstudio_analyze, mcpstudio_redesign, and other tools.

Available Tools

mcpstudio_redesign

AI-powered design improvement

mcpstudio_analyze

Design quality scoring (0-100)

mcpstudio_credits

Check your credit balance

mcpstudio_diff

Generate before/after diff

mcpstudio_instagram

Generate social media posts

mcpstudio_dashboard

Open visual configurator

Prompt Examples

Use mcpstudio_analyze to score the design quality of my current page and list the top issues
Use mcpstudio_redesign on my landing page with creativity 0.6 and preserve the color palette
Use mcpstudio_redesign on my entire app with scope entire-app, creativity 0.4
Use mcpstudio_redesign on this page with motion enabled and creativity 0.5
Use mcpstudio_credits to check my balance
Use mcpstudio_diff to show me what changed between the original and redesigned version

Troubleshooting

Tools not appearing after setup

Fully quit and relaunch your IDE. In Cursor: Cmd+Shift+P → "Reload Window". In Claude Desktop: quit from menu bar, not just close the window.

"MCPSTUDIO_TOKEN is required" error

Token must be in the "env" field of the JSON config, not as a shell variable. Check that your config has: "env": { "MCPSTUDIO_TOKEN": "your-token" }

Windsurf "connection failed"

Windsurf uses HTTP directly — use the serverUrl config, not command/args. Double-check that the x-mcpstudio-token header value matches your token exactly.

FAQ