CleanVector

Official11 tools

by bydllhcbn

Create professional SVG artwork, icons and vector logos from a prompt, or vectorize any image.

MCP Server: ai.cleanvector/cleanvector

The ai.cleanvector/cleanvector MCP server is designed to generate vector art and vectorize images, returning results suitable for downstream AI agents. It produces outputs including SVG, PNG, and logo kits. The server focuses on converting image inputs into vector-based artifacts and packaging those assets for agent consumption.

🛠️ Key Features

Generate vector art
Vectorize images
Return SVG, PNG, and logo kits

🚀 Use Cases

Creating vector artwork programmatically via AI agents
Converting raster images into vector outputs
Producing logo kit assets for use in agent workflows

Topics

ai-logo-generatorclaude-codecursorimage-to-svglogo-generatormcpmcp-servermodel-context-protocolsvgtext-to-svgvector-graphicsvectorizer

Captured live from the server via tools/list.

generate_illustration

Generate professional, editable SVG artwork from a text prompt: illustrations, icons, stickers and mascot scenes. The result is real vector paths with a transparent background, not an embedded bitmap. Returns a task that processes asynchronously, so call wait_for_task with the returned id to get the result. Pass mascot_id (from list_mascots) to keep a consistent character across scenes. Costs 4 credits.

Parameters4

prompt	string	required	What to draw, in plain language
mascot_id	string	optional	Optional mascot id; the character appears consistently in the scene
no_background	boolean	optional	Return only the subject on a transparent background
aspect_ratio	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 3,
      "maxLength": 2000,
      "description": "What to draw, in plain language"
    },
    "mascot_id": {
      "type": "string",
      "description": "Optional mascot id; the character appears consistently in the scene"
    },
    "no_background": {
      "type": "boolean",
      "default": true,
      "description": "Return only the subject on a transparent background"
    },
    "aspect_ratio": {
      "type": "string",
      "enum": [
        "auto",
        "square",
        "landscape",
        "portrait"
      ],
      "default": "auto"
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

generate_logo

Generate a professional vector logo as editable SVG, delivered as a brand kit: the original mark, black and white variants, transparent PNG exports and a color palette measured from the finished artwork. An optional reference can refine an existing identity or provide loose inspiration. Runs asynchronously, so call wait_for_task with the returned id, then download_logo_kit. Costs 8 credits.

Parameters6

prompt	string	required	Creative brief for the logo
brand_name	string	optional	Exact optional brand name; omit for symbol-only
reference_image_url	string	optional
reference_image_base64	string	optional
reference_role	string	optional
request_id	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "prompt": {
      "type": "string",
      "minLength": 3,
      "maxLength": 2000,
      "description": "Creative brief for the logo"
    },
    "brand_name": {
      "type": "string",
      "maxLength": 80,
      "description": "Exact optional brand name; omit for symbol-only"
    },
    "reference_image_url": {
      "type": "string",
      "format": "uri"
    },
    "reference_image_base64": {
      "type": "string"
    },
    "reference_role": {
      "type": "string",
      "enum": [
        "refine",
        "inspiration"
      ]
    },
    "request_id": {
      "type": "string",
      "format": "uuid"
    }
  },
  "required": [
    "prompt"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

vectorize_image

Convert a raster image (PNG/JPG/WebP, max 5 MB) into a clean, editable SVG. Provide image_url or image_base64. no_background defaults to true and isolates the subject (4 credits). Set no_background false with mode 'direct' to trace as-is (1 credit); mode 'enhance' redraws with AI first (4 credits). Runs async, so poll with wait_for_task.

Parameters5

image_url	string	optional	Public URL of the image
image_base64	string	optional	Base64 image data (raw or data URL)
mode	string	optional
prompt	string	optional	Optional guidance for enhance mode
no_background	boolean	optional	Isolate the subject on a transparent background

Raw schema

{
  "type": "object",
  "properties": {
    "image_url": {
      "type": "string",
      "format": "uri",
      "description": "Public URL of the image"
    },
    "image_base64": {
      "type": "string",
      "description": "Base64 image data (raw or data URL)"
    },
    "mode": {
      "type": "string",
      "enum": [
        "direct",
        "enhance"
      ],
      "default": "direct"
    },
    "prompt": {
      "type": "string",
      "maxLength": 2000,
      "description": "Optional guidance for enhance mode"
    },
    "no_background": {
      "type": "boolean",
      "default": true,
      "description": "Isolate the subject on a transparent background"
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_task

Fetch the current status of a task. Status is one of queued, processing, succeeded, failed. A succeeded task includes the result with download URLs.

Parameters1

task_id

string

required

Task id from generate_illustration or vectorize_image

Raw schema

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string",
      "description": "Task id from generate_illustration or vectorize_image"
    }
  },
  "required": [
    "task_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

wait_for_task

Block until a task settles (succeeded/failed) or the timeout passes. Preferred over polling get_task in a loop. Generation typically takes 10-60 seconds.

Parameters2

task_id	string	required
timeout_seconds	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string"
    },
    "timeout_seconds": {
      "type": "integer",
      "minimum": 5,
      "maximum": 50,
      "default": 45
    }
  },
  "required": [
    "task_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_tasks

List the user's most recent tasks, newest first.

Parameters1

limit

integer

optional

Raw schema

{
  "type": "object",
  "properties": {
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 50,
      "default": 10
    }
  },
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

list_mascots

List the user's ready-to-use mascots (consistent characters). Pass a mascot id to generate_illustration to place that character in a new scene. Mascots are created in the CleanVector dashboard.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

download_png

Return the finished artwork as a PNG image (free on all plans). Use after a task succeeded. For larger exports up to 8192px, use the png_url from the task result with the same Bearer key.

Parameters3

task_id	string	required
width	integer	optional	Output width in px (height keeps aspect)
variant	string	optional	Logo only: original/black/white. Artwork tasks have one SVG.

Raw schema

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string"
    },
    "width": {
      "type": "integer",
      "minimum": 16,
      "maximum": 2048,
      "default": 1024,
      "description": "Output width in px (height keeps aspect)"
    },
    "variant": {
      "type": "string",
      "enum": [
        "original",
        "black",
        "white"
      ],
      "description": "Logo only: original/black/white. Artwork tasks have one SVG."
    }
  },
  "required": [
    "task_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

download_svg

Return the finished artwork as SVG markup. Use after a task succeeded.

Parameters2

task_id	string	required
variant	string	optional

Raw schema

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string"
    },
    "variant": {
      "type": "string",
      "enum": [
        "original",
        "black",
        "white"
      ]
    }
  },
  "required": [
    "task_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

download_logo_kit

Return a completed logo kit as an embedded ZIP resource. Includes three SVGs, three PNGs and palette.json. MCP output is capped at 2048px; use zip_url from the task result for larger files.

Parameters2

task_id	string	required
width	integer	optional

Raw schema

{
  "type": "object",
  "properties": {
    "task_id": {
      "type": "string"
    },
    "width": {
      "type": "integer",
      "minimum": 16,
      "maximum": 2048,
      "default": 2048
    }
  },
  "required": [
    "task_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

get_account

Current plan and credit balance. Costs: vectorize 1, generate/enhance 4, logo 8 credits. PNG and SVG downloads are free on every plan.

Parameters

No parameters.

Raw schema

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

README.md7 KBView on GitHub

CleanVector logo

CleanVector MCP Server

Create professional SVG artwork, icons and vector logos from a prompt, or vectorize any image.

Docs · Get an API key · MCP Registry · Gallery

CleanVector is a hosted Model Context Protocol server. It gives Claude Code, Cursor, VS Code, Windsurf and any other MCP client three things most image tools cannot return to an agent:

Professional SVG artwork. Illustrations, icons, stickers and mascots as real vector paths with a transparent background. No embedded bitmaps, no white rectangle behind the art.
Vector logos. One brief in, a full brand kit out: the logo as editable SVG, black and white variants, transparent PNG exports and a color palette measured from the finished mark.
Clean vectorization. Turn a PNG, JPG or WebP, including AI-generated images, into an SVG you can recolor and scale.

Nothing to install or run. The server is remote, speaks Streamable HTTP and is listed in the official MCP Registry as ai.cleanvector/cleanvector. Clients and directories can inspect the server metadata and tool schemas without credentials; every tool call still requires a CleanVector API key.

Examples

These three vector logos were generated from a one-sentence brief each. They are the actual SVG files, stored in examples/.

_{Northstar
An interlocking N and compass for a strategy studio}

_{Kinfold
A folded ribbon K for a community platform}

_{Halo
Two orbital loops forming an H for a spatial computing studio}

What you can ask your agent once it is connected:

Generate six matching flat line icons for a fitness app as SVG and put them in public/icons.

Design a logo for "Northstar", a strategy studio. Geometric, confident, deep blue with one coral accent. Save the SVG and the black and white variants into ./brand.

Vectorize ./mockups/hero.png and replace the raster in the landing page with the SVG.

Quick start

Create an API key at cleanvector.ai/app/api-keys. API and MCP access is included in the Plus and Pro plans.
Add the server to your client.

Claude Code

bash

claude mcp add --transport http cleanvector https://cleanvector.ai/api/mcp \
  --header "Authorization: Bearer cv_YOUR_KEY"

Cursor (~/.cursor/mcp.json)

json

{
  "mcpServers": {
    "cleanvector": {
      "url": "https://cleanvector.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cv_YOUR_KEY"
      }
    }
  }
}

VS Code (.vscode/mcp.json)

json

{
  "inputs": [
    {
      "id": "cleanvector_key",
      "type": "promptString",
      "description": "CleanVector API key",
      "password": true
    }
  ],
  "servers": {
    "cleanvector": {
      "type": "http",
      "url": "https://cleanvector.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer ${input:cleanvector_key}"
      }
    }
  }
}

Windsurf (~/.codeium/windsurf/mcp_config.json)

json

{
  "mcpServers": {
    "cleanvector": {
      "serverUrl": "https://cleanvector.ai/api/mcp",
      "headers": {
        "Authorization": "Bearer cv_YOUR_KEY"
      }
    }
  }
}

Claude Desktop and other stdio-only clients (through mcp-remote)

json

{
  "mcpServers": {
    "cleanvector": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cleanvector.ai/api/mcp",
        "--header",
        "Authorization:${CLEANVECTOR_AUTH}"
      ],
      "env": {
        "CLEANVECTOR_AUTH": "Bearer cv_YOUR_KEY"
      }
    }
  }
}

Tools

Tool	What it does	Cost
`generate_illustration`	Generate professional, editable SVG artwork from a text prompt: illustrations, icons, stickers and mascot scenes. Pass a `mascot_id` to keep one character consistent across scenes.	4 credits
`generate_logo`	Generate a vector logo with original, black and white variants, PNG exports and a measured palette. Accepts a reference image to refine an existing identity or to use as loose inspiration.	8 credits
`vectorize_image`	Convert a PNG, JPG or WebP (up to 5 MB, by URL or base64) into a clean, editable SVG.	1 or 4 credits
`wait_for_task`	Wait for an asynchronous task to settle and return its result.	free
`get_task`	Fetch the status of one task, including download URLs once it succeeds.	free
`list_tasks`	List the account's most recent tasks.	free
`list_mascots`	List saved mascots whose ids keep a character consistent.	free
`download_svg`	Return finished artwork as SVG markup.	free
`download_png`	Return finished artwork as a PNG image in the agent's context, at any width.	free
`download_logo_kit`	Return three SVGs, three PNGs and `palette.json` as a ZIP.	free
`get_account`	Return the current plan and credit balance.	free

Generation is asynchronous. A typical flow is generate_illustration, then wait_for_task, then download_svg. Downloads and re-exports never cost credits.

Details


Endpoint	`https://cleanvector.ai/api/mcp`
Transport	Streamable HTTP
Authentication	Public discovery; `Authorization: Bearer cv_...` API key required for tool calls
Registry name	`ai.cleanvector/cleanvector`
Access	Plus and Pro plans
REST API	The same key works with the REST API, documented in the dashboard

The registry manifest is in server.json.

What the output looks like

Every result is standard SVG: plain <path> elements with fills, no embedded images, no scripts and a transparent canvas. It opens and edits in Figma, Illustrator, Inkscape and the free CleanVector SVG editor. Read how CleanVector works for what to check before using an asset in production.

AI-generated logos do not come with trademark clearance. Search the relevant trademark databases before relying on a mark commercially.

Support

Documentation: cleanvector.ai/mcp
Contact: cleanvector.ai/contact
Issues with these docs or the client configs: open an issue in this repository.

License

The documentation, configuration examples and example artwork in this repository are released under the MIT License. The CleanVector service itself is a hosted commercial product.

Install

Tools (11)

generate_illustrationgenerate_logovectorize_imageget_taskwait_for_tasklist_taskslist_mascotsdownload_png

Remote endpoint

Streamable HTTP

Hosted server - connect over the network, no local install.

url

https://cleanvector.ai/api/mcp

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "cleanvector": {
      "command": "npx",
      "args": [
        "-y",
        "mcp-remote",
        "https://cleanvector.ai/api/mcp"
      ]
    }
  }
}

Desktop config is stdio-only; this bridges via mcp-remote. Native remote: Settings > Connectors.

MCP Server: ai.cleanvector/cleanvector

🛠️ Key Features

🚀 Use Cases

Topics

generate_illustration

generate_logo

vectorize_image

get_task

wait_for_task

list_tasks

list_mascots

download_png

download_svg

download_logo_kit

get_account

CleanVector MCP Server

Examples

Quick start

Tools

Details

What the output looks like

Support

License

Install

Remote endpoint

Related servers