CleanVector
Create professional SVG artwork, icons and vector logos from a prompt, or vectorize any image.
Hosted MCP Server
npx add-mcp 'https://cleanvector.ai/api/mcp'Installs into Claude Code, Codex, Cursor and more
Documentation
What it does
Three jobs your agent can run.
The server exposes the same generation, conversion and export pipeline the CleanVector app uses.
01
Prompt to professional SVG
Create an illustration, icon or mascot scene, wait for the asynchronous job, then bring clean, editable SVG markup or a rendered PNG back into the agent's work.
generate_illustration → wait_for_task → download_svg
02
Brief to vector logo
Generate a vector logo with original, black and white variants, measured colors and a ZIP of production-ready SVG and PNG files.
generate_logo → wait_for_task → download_logo_kit
03
Image to clean SVG
Give the agent a PNG, JPG or WebP URL or base64 payload and have it return a scalable result instead of a flattened image.
vectorize_image → wait_for_task → download_svg
Setup
Connect with an API key.
Clients can discover the server and its tool schemas without a key. To run any tool, create a key in CleanVector and add it as a Bearer header. API and MCP execution are included in the Plus and Pro plans.
Keep the key out of source control. Every call is made on your account. Keys are shown once and can be revoked from the API page.
Claude Code
CLI
claude mcp add --transport http cleanvector https://cleanvector.ai/api/mcp \
--header "Authorization: Bearer cv_YOUR_KEY"
Cursor
.cursor/mcp.json
{
"mcpServers": {
"cleanvector": {
"url": "https://cleanvector.ai/api/mcp",
"headers": {
"Authorization": "Bearer cv_YOUR_KEY"
}
}
}
}
For another MCP client, use the same URL with Streamable HTTP and send Authorization: Bearer cv_…. CleanVector uses API-key authentication for every tool call; public discovery does not grant access to account data or tool execution. The server does not advertise OAuth or the deprecated SSE transport.
Tool reference
Available tools
Creation jobs are asynchronous. Call wait_for_task before requesting the result. Failed generation jobs are refunded automatically.
| TOOL | PARAMETERS | WHAT IT DOES | COST |
|---|---|---|---|
generate_illustration | prompt, mascot_id?, no_background?, aspect_ratio? | Generate professional, editable SVG artwork from a text prompt: illustrations, icons, stickers and mascot scenes. Pass mascot_id to keep a consistent character across scenes. | 4 credits |
generate_logo | prompt, brand_name?, reference_image_url | reference_image_base64?, reference_role? | Generate a professional vector logo with original, black and white variants, PNG exports and a measured palette. Supports refine and inspiration references. | 8 credits |
vectorize_image | image_url | image_base64, mode?, prompt?, no_background? | Convert a raster image (PNG/JPG/WebP, max 5 MB) into a clean, editable SVG, by URL or base64. | 1 or 4 credits |
wait_for_task | task_id, timeout_seconds? | Wait for an asynchronous task to settle and return its result when ready. | free |
get_task | task_id | Fetch the current status of one task, including download URLs after it succeeds. | free |
list_tasks | limit? | List the account's most recent tasks, newest first. | free |
list_mascots | none | List ready mascots whose ids can be used for character-consistent illustrations. | free |
download_png | task_id, width?, variant? | Return finished artwork as a PNG image directly in the agent's context. | free |
download_svg | task_id, variant? | Return finished artwork as editable SVG markup. | free |
download_logo_kit | task_id, width? | Return three SVGs, three PNGs, and palette.json as an embedded ZIP resource. | free |
get_account | none | Return the current plan and credit balance. | free |