@illustmaker/mcp

MCP (Model Context Protocol) server for Illustmaker — a free, browser-based vector illustration editor with 38 automation methods.

Use this to drive Illustmaker from Claude Desktop, Cursor, Cline, Windsurf and other MCP-compatible AI agents. Generate logos, mass-export labels, compose OGP images, build catalogs, all by chatting with your AI.

Install

npx -y @illustmaker/mcp

Quick start — Claude Desktop

Edit ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

{
  "mcpServers": {
    "illustmaker": {
      "command": "npx",
      "args": ["-y", "@illustmaker/mcp"]
    }
  }
}

Restart Claude Desktop. You should see "illustmaker" listed in the tools menu.

Try: "Create a new 800×600 document and add a red rectangle, then export as SVG."

"failed to connect" on macOS?

Some clients (Claude Code, etc.) spawn subprocesses with a minimal PATH that doesn't include /usr/local/bin/. If you see a connection failure, switch to an absolute path (run which npx to find yours):

{
  "mcpServers": {
    "illustmaker": {
      "command": "/usr/local/bin/npx",
      "args": ["-y", "@illustmaker/mcp"]
    }
  }
}

With an API key (recommended)

The anonymous tier is limited to 30 requests/min and is rate-limited per IP. Get a free API key at /illustmaker/ (Free tier: 100/min).

{
  "mcpServers": {
    "illustmaker": {
      "command": "npx",
      "args": ["-y", "@illustmaker/mcp"],
      "env": {
        "ILLUSTMAKER_API_KEY": "im_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx"
      }
    }
  }
}

Cursor

.cursor/mcp.json in your project, or ~/.cursor/mcp.json:

{
  "mcpServers": {
    "illustmaker": {
      "command": "npx",
      "args": ["-y", "@illustmaker/mcp"],
      "env": { "ILLUSTMAKER_API_KEY": "im_xxx" }
    }
  }
}

Cline / Windsurf / other

Any MCP client that supports command/args style stdio transport works. Just point it at npx -y @illustmaker/mcp and (optionally) set ILLUSTMAKER_API_KEY in the env.

What it can do

The server exposes 38 tools, named illust_* (e.g. illust_create_session, illust_add_object, illust_export, illust_batch_render …).

| Category | Tools | | --- | --- | | Session | create_session, get_session, duplicate_session, list_sessions, delete_session, copy_objects_to_session | | Object | add_object, add_svg, import_from_url, get_object, update_object, delete_object, duplicate_object | | Layout | group, ungroup, align, set_order | | Text | measure_text, replace_text, set_text_style, outline_text, list_fonts, add_font | | File | save_project, load_project, export (SVG/PNG/JPEG/PDF/AI/JSON) | | Batch | batch_render (up to 1000 variants in one call) | | Suggest | suggest_palette (12 themes), suggest_font (8 use cases), extract_palette | | Meta | health, set_document |

Full reference: https://asi.co.jp/illustmaker/mcp/

Examples

"Make me 100 product labels"

You: I have a CSV of 100 sake products. Make label SVGs for all of them
     using the same template, A4 imposition PDF, 8 per page.
AI : (calls illust_create_session → adds template → illust_batch_render
      with output: "pdf-imposition", imposition: {cols:2, rows:4})
     → returns download URL

"Logo for a sushi shop"

You: Design a logo for a sushi restaurant called "Hanami".
AI : (calls illust_create_session, illust_add_object with ellipse/text,
      illust_suggest_palette theme="和", illust_export format="svg")
     → returns SVG + browser URL for fine-tuning

"Generate OGP for 50 blog posts"

You: Here's a list of 50 article titles. Make OGP images (1200×630) for all.
AI : (template + batch_render with output: "png-zip")
     → ZIP of 50 PNGs

Open the result in the browser

Most operations return an open_url like https://asi.co.jp/illustmaker/?s=abc123 — open it in any browser to fine-tune the result visually. No login required.

Rate limits

| Tier | Limit | | ----- | ----- | | Anonymous (no key) | 30 req/min | | Free API key | 100 req/min | | Pro (contact for upgrade) | 600 req/min |

Sessions are auto-deleted 7 days after their last update.

Security & privacy

• All session data is stored only on Illustmaker's servers temporarily (7 days)
• Session URLs are guessable enough to be considered unlisted, not secret — don't send confidential data
• illust_import_from_url blocks private/loopback/metadata IPs and rejects redirects to defeat SSRF
• API key, if used, is sent as X-API-Key header over HTTPS
• See full privacy policy and terms

Programmatic use (without MCP)

If you don't want MCP, just call the HTTP API directly:

curl -X POST https://asi.co.jp/illustmaker/api/mcp.php \
  -H 'Content-Type: application/json' \
  -H 'X-API-Key: im_xxxxxxxx' \
  -d '{"method":"illust.create_session","params":{"width":800,"height":600}}'

License

MIT © ASI Inc.

Links

• 📝 Editor
• 📚 Full API reference
• 📖 User manual
• 🔒 Privacy policy
• 📄 Terms of service
• 🐦 Twitter / X