vectorizer-mcp

MCP server for Vectorise.Me — lets AI agents (Claude Desktop, Claude Code, Cursor, and any MCP-compatible client) vectorize raster images to SVG and export to PDF, EPS, DXF, PNG, JPG, or WEBP.

Also published as vectorise-mcp — identical package, either name works with npx.

Tools

| Tool | What it does | | --- | --- | | vectorize_image | Convert JPG/PNG/BMP/WEBP/AVIF (≤25 MB) to SVG, saved to disk | | vectorize_batch | Convert up to 20 images in one call with shared settings and per-file results | | export_svg | Convert an SVG file to PDF, EPS, DXF, PNG, JPG, or WEBP | | get_usage | Show plan, credit balance, and recent usage (needs API key) | | get_capabilities | List export formats and options (no auth) |

Presets

Instead of learning the engine's tuning knobs, pass a preset (works in both vectorize tools):

| Preset | Best for | | --- | --- | | auto | Engine detects the image type (default) | | logo | Logos, icons, text — sharp edges, exact brand colours | | illustration | Drawings, cartoons, clipart | | photo | Photographs — smooth tonal gradients | | pixel_art | Pixel art — pixel-faithful, exact colours | | technical_drawing | Blueprints and line art — black & white |

Advanced options (quality_tier, quality_profile, color_mode, palette_count, preserve_exact_colors) are still available, and anything you set explicitly overrides the preset.

Setup

Get an API key at vectorise.me/app (anonymous use works too, with basic rate limits). Credits per conversion: fast=1, balanced_crisp=2, high_precision=5.

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "vectorizer": {
      "command": "npx",
      "args": ["-y", "vectorizer-mcp"],
      "env": { "VECTORISE_API_KEY": "vm_live_..." }
    }
  }
}

Claude Code

claude mcp add vectorizer -e VECTORISE_API_KEY=vm_live_... -- npx -y vectorizer-mcp

Cursor

Add to .cursor/mcp.json:

{
  "mcpServers": {
    "vectorizer": {
      "command": "npx",
      "args": ["-y", "vectorizer-mcp"],
      "env": { "VECTORISE_API_KEY": "vm_live_..." }
    }
  }
}

Environment variables

• VECTORISE_API_KEY — API key (optional; anonymous works with basic limits)
• VECTORISE_API_URL — base URL override (default https://vectorise.me)

Example prompts

• "Vectorize ~/Desktop/logo.png as a clean SVG with the logo preset"
• "Convert every PNG in ~/Designs/icons to SVG using the pixel_art preset"
• "Convert this sketch to SVG with the technical_drawing preset, then export it as DXF"
• "How many Vectorise credits do I have left?"

API docs

Full REST API documentation: vectorise.me/developers · OpenAPI spec: vectorise.me/api/v1/openapi.json

License

MIT