API & MCP Integration Guide

Want to Give Your AI Agent an Artistic Superpower?

Imagine your AI agent can instantly transform ideas into professional graphics — posters, infographics, business cards, social media visuals — all within seconds, right in your conversation flow.

That’s exactly what Mew Design MCP tool does.

Why We Built This

OpenClaw and AI agents are rapidly becoming the standard interface for how we interact with software. But here’s the thing: most agents today are text-only. They can write, analyze, and reason brilliantly — but they can’t show you visually compelling content.

With Mew Design’s MCP integration, your agent gains the ability to:

✨ Transform text into visuals — Turn meeting notes into presentation slides, data into infographics, ideas into posters 🎨 Design with precision — Place logos, QR codes, and photos exactly where they belong ⚡ Work at agent speed — Generate professional designs in seconds, not hours 🔄 Iterate naturally — Refine designs through conversation, just like working with a human designer

Whether you’re using OpenClaw, OpenCode, Claude Code, GeminiCli, Antigravvity, Codex, Cursor, or Cherry Studio, this guide will show you how to unlock visual creativity in your AI workflows.

What is MCP?

The Model Context Protocol (MCP) is an open standard that enables AI agents to securely connect with external tools and services. Think of it as a universal language that lets your agent talk to specialized tools — like Mew Design for graphics, or databases for data, or APIs for real-time information.

With MCP, your AI agent can:

• Generate professional designs directly from conversations
• Access external data sources and services
• Automate complex workflows across multiple tools
• Extend its capabilities beyond pure text generation

Step 1. Generate Your API Key

API Keys allow external applications to access Mew Design on your behalf.

1. Navigate to Account Settings

   • Go to Account Settings
   • Scroll to the “API Keys” section

2. Create a New API Key

   • Click “Create API Key”
   • Give it a descriptive name (e.g., “Claude Desktop”, “Cline Integration”)
   • Copy the key immediately — it won’t be shown again

3. Manage Your Keys

   • View usage statistics for each key
   • Revoke keys you no longer need
   • Track credit consumption per key

Keep Your API Key Safe

Treat your API key like a password. Anyone with your key can consume your credits. Never share it publicly or commit it to version control.

Step 2. Set Up MCP Server

Not sure how to install?

The easiest way: Simply send the URL of this page to your AI Agent (like Cursor, Windsurf, OpenClaw) and say: “Configure Mew Design MCP for me”. It will read the instructions and set it up for you!

Mew Design provides a cloud-based MCP service that you can connect to via HTTP/SSE (Server-Sent Events) without any local installation.

For OpenClaw / OpenCode / Antigravvity / Codex

These are powerful AI Agent platforms that natively support MCP integration.

1. Access Settings

   • Open tool settings
   • Navigate to MCP Servers configuration

2. Add New MCP Server

   • Select connection type as HTTP or SSE (Remote)
   • URL: https://api.mew.design/mcp
   • Headers:
     • Key: X-Api-Key
     • Value: your-api-key-here

3. Save and Connect

   • Save the configuration, and the platform will automatically connect and verify.

For Claude Code / GeminiCli

These are powerful Command Line Interface (CLI) tools managed via configuration files.

1. Edit Configuration

   • Locate the configuration file (typically ~/.claude/config.json or ~/.gemini/config.json)

2. Add Server Configuration

   {
     "mcpServers": {
       "mew-design": {
         "url": "https://api.mew.design/mcp",
         "headers": {
           "X-Api-Key": "your-api-key-here"
         }
       }
     }
   }

3. Restart Tool

   • Rerun the CLI command to apply changes.

For Cursor

Cursor is an AI-powered code editor with built-in MCP support.

1. Open Cursor Settings

   • Go to Settings → Features → MCP

2. Add HTTP Server

   • Click “Add New MCP Server”
   • Select Type: SSE (or HTTP)
   • URL: https://api.mew.design/mcp

3. Configure API Key

   • If Cursor UI does not yet support Header configuration, please wait for future updates.

For Cherry Studio

Cherry Studio is a versatile AI workbench supporting various models and tools.

1. Open Settings

   • Click the settings icon in the bottom left
   • Select Tools or Plugins tab

2. Add MCP Tool

   • Click ”+” to add a new tool
   • Select MCP type
   • URL: https://api.mew.design/mcp
   • Headers: {"X-Api-Key": "your-api-key-here"}

3. Save

   • Save and enable the tool.

Most MCP-compatible tools support HTTP/SSE connections. Just use the following details:

• Server URL: https://api.mew.design/mcp
• Headers: X-Api-Key: your-api-key-here

Configuration Note

Be sure to pass the API key via Headers, not via Bearer Token.

Step 3. Use the Design Tool

Once connected, your AI assistant can generate designs using natural language:

Example Prompts

Basic Design Generation:

Create a Mother's Day promotional poster for Fleurish Co. flower shop,
featuring 20% OFF offer, website https://fleurish.com,
tel. 057 xxxx xx, Address: Lexington Ave, New York, NY 100xx

With Style Reference:

Generate a minimalist business card with modern typography.
Use the color palette from [image URL] as reference.

With Assets:

Design an Instagram post for our new product launch.
Include our logo [logo URL] and product photo [product URL].
Use vibrant colors and bold typography.

Available Parameters

The MCP tool supports the following parameters:

Parameter	Type	Description	Default
userQuery	string	Complete design requirement (required)	-
designConcept	string	Visual style direction (optional)	-
referenceImage	object	Style reference with URL and tag (optional)	-
width	number	Design width in pixels (1-5000)	1080
height	number	Design height (-1 for auto-adaptive, 100-5000)	-1
assetImages	array	Assets to integrate (logos, QR codes)	-

Auto-Adaptive Height

Use height: -1 (default) for content-aware auto-adaptive height. This is recommended for most designs with variable content length.

Step 4. Best Practices

Credit Management

• Monitor Usage: Check your API key usage in Account Settings
• Set Limits: Each design generation costs 4 credits
• Optimize Prompts: Clear, specific prompts reduce iterations

Prompt Writing Tips

1. Be Specific: Include all text content, layout requirements, and style preferences
2. Provide Context: Mention the design purpose (poster, flyer, social media)
3. Use Real URLs: Always provide valid image URLs for assets and references
4. Iterate Gradually: Start simple, then refine with follow-up prompts

Security Best Practices

• Rotate Keys Regularly: Generate new keys periodically
• Use Separate Keys: Different keys for different applications
• Revoke Unused Keys: Remove keys you no longer need
• Monitor Activity: Check for unexpected usage patterns

Troubleshooting

Connection Issues

Problem: MCP server not connecting

Solutions:

• Verify API key is correct and active
• Check claude_desktop_config.json syntax (valid JSON)
• Ensure absolute paths are used (not relative)
• Restart Claude Desktop after config changes
• Check Claude Desktop logs for error messages

Generation Failures

Problem: Design generation fails or times out

Solutions:

• Simplify your prompt (reduce complexity)
• Check image URLs are accessible
• Verify you have sufficient credits
• Try smaller dimensions if using fixed height
• Wait 2 minutes for timeout (complex designs take time)

Invalid URLs

Problem: “Invalid URL” error for assets

Solutions:

• Ensure URLs are publicly accessible
• Use direct image URLs (not webpage URLs)
• Verify URLs return image content (PNG, JPG, etc.)
• Never use placeholder URLs like “placeholder.jpg”

API Reference

For developers building custom integrations, refer to our API documentation:

• Base URL: https://api.mew.design
• Endpoint: /mcp
• Authentication: x-api-key header
• Rate Limits: 60 requests per minute
• Timeout: 120 seconds per request

Example API Call

curl -X POST https://api.mew.design/mcp \
  -H "x-api-key: YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
    "userQuery": "Create a modern business card",
    "width": 1080,
    "height": -1
  }'

Response Format

Success Response (200 OK):

{
  "success": true,
  "designUrl": "https://cdn.mew.design/designs/abc123.png",
  "message": "Visual design generated successfully."
}

Error Response (4xx/5xx):

{
  "success": false,
  "message": "Error description here"
}

Resources

• MCP Official Documentation
• Claude Desktop MCP Guide
• Mew Design Community

Ready to Automate Your Design Workflow?

Start integrating Mew Design with your favorite AI assistant today.

🔑 Generate Your API Key