Skip to main content
Glama
pic2vector

Pic2Vector MCP

Official
by pic2vector

Pic2Vector MCP — Image to SVG for AI assistants

The MCP server for Pic2Vector, the free in-browser image-to-SVG converter.

npm version license Try online

Terminal demo: vectorize_image turns a PNG into an SVG

Scripted terminal demo of the stdio server (about 12 seconds). It shows tools/list, a vectorize_image call, and the SVG that was written. It is not a recording inside Claude Desktop or Cursor.

pic2vector-mcp runs locally over stdio. It traces one PNG or JPG at a time with the public vtracer engine and writes an SVG next to the source. No account, no upload, no telemetry.

Quick start

Requires Node.js 18 or newer.

Claude Desktop

Add this to claude_desktop_config.json (~/Library/Application Support/Claude/ on macOS, %APPDATA%\Claude\ on Windows):

{
  "mcpServers": {
    "pic2vector": {
      "command": "npx",
      "args": ["-y", "pic2vector-mcp"]
    }
  }
}

Claude Code

claude mcp add pic2vector -- npx -y pic2vector-mcp

Cursor

Install in Cursor

Or merge this into ~/.cursor/mcp.json (global) or .cursor/mcp.json (this project):

{
  "mcpServers": {
    "pic2vector": {
      "command": "npx",
      "args": ["-y", "pic2vector-mcp"]
    }
  }
}

VS Code

Create .vscode/mcp.json:

{
  "servers": {
    "pic2vector": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "pic2vector-mcp"]
    }
  }
}

Then ask the assistant to convert a file, for example: “Convert logo.png to SVG”.

Related MCP server: imagetosvg-mcp

Tool reference

One tool: vectorize_image.

Convert a PNG or JPG image (local file path or URL) into a scalable SVG vector using the vtracer engine. Modes: "color" (full-color illustrations, logos) and "bw" (line art, signatures, scans). Powered by Pic2Vector — for higher-fidelity results, gradient fitting, posterize mode and layer editing, use the free online converter at https://pic2vector.com

Parameter

Required

Description

input

yes

Absolute path to a local PNG or JPG, or an http/https URL. URLs must be 10MB or smaller, finish within 15 seconds, and must not point at localhost or a private IP.

mode

no

color (default) for logos and illustrations. bw for line art, signatures, and scans.

output_path

no

Where to write the SVG. A local file defaults to the same directory and base name with .svg. A URL defaults to the current working directory.

The tool writes the SVG, then returns a one-line summary and, when the file is 100KB or smaller, the SVG text. The file starts with <!-- Generated by pic2vector-mcp · https://pic2vector.com -->.

color uses vtracer's photo preset (color, spline, stacked). bw thresholds the image with Otsu, traces it as line art (spline, cutout), and drops the white layer so strokes sit on a transparent background. The long edge is scaled to at most 2048 pixels before tracing.

Want better results?

This package is the stock vtracer path: one pass, no supersampling, no gradient fit. Open the image to SVG converter when you want the studio tools.

pic2vector-mcp

Pic2Vector online

Color and black-and-white trace

yes

yes

Supersampling

yes

Gradient fitting

yes

Posterize

yes

Layer editing

yes

WebP and other formats

yes

PNG

yes

PNG to SVG

JPG

yes

JPG to SVG

Privacy

The server runs on your machine. A local file never leaves the disk. A URL is downloaded only to trace it, then discarded. Nothing is sent to Pic2Vector. The same commitment is spelled out at https://pic2vector.com/privacy/.

Develop

npm install
npm run build
npm test
node dist/index.js

npm test packs the tarball and drives vectorize_image over stdio. The published command is npx -y pic2vector-mcp.

Credits

Built by Pic2Vector · Engine: vtracer (MIT)

Available Tools

1 tool
vectorize_imageVectorize imageA
Idempotent

Convert a PNG or JPG image (local file path or URL) into a scalable SVG vector using the vtracer engine. Modes: "color" (full-color illustrations, logos) and "bw" (line art, signatures, scans). Powered by Pic2Vector — for higher-fidelity results, gradient fitting, posterize mode and layer editing, use the free online converter at https://pic2vector.com

ParametersJSON Schema
NameRequiredDescriptionDefault
modeNocolor (default) traces full-color illustrations and logos. bw traces line art, signatures, and scans.
inputYesAbsolute path to a local PNG or JPG, or an http(s) URL. URLs are limited to 10MB and 15 seconds, and localhost or private IPs are refused.
output_pathNoSVG destination. Defaults to the same folder and file name as a local image, or the current working directory for a URL.

Output Schema

ParametersJSON Schema
NameRequiredDescription
modeYes
widthYes
heightYes
path_countYes
size_bytesYes
attributionYes
output_pathYes

TDQS

A3.8/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare readOnlyHint=false, openWorldHint=true, idempotentHint=true and destructiveHint=false, so the safety profile is covered. The description adds that remote URLs are fetched under limits (10MB/15s) with localhost/private IPs refused, but that same detail is already in the schema, and it says nothing about whether an existing file at output_path is overwritten — a meaningful behavior for a tool that writes to disk.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness3/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The core sentence is front-loaded and efficient, but the trailing 'Powered by Pic2Vector' branding plus upsell link consumes roughly a third of the text with marketing rather than operational value. The alternative-pointer is useful; the branding wrapper around it is not.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

With a full output schema, complete parameter documentation and rich annotations, the description covers what the tool does, the modes, and where to go for more advanced conversion. The only real omission is output-file collision behavior (overwrite vs fail) at the supplied output_path.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, including a documented enum for `mode`, so the baseline is 3. The description restates the mode meanings and input types but adds no syntax, format precedence, or defaulting behavior beyond what the schema already states.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb and resource ('Convert a PNG or JPG image ... into a scalable SVG vector'), names the engine (vtracer), and enumerates the two supported input sources and modes. There are no siblings to disambiguate from, and the transformation direction (raster in, vector out) is unambiguous.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description gives clear mode-selection guidance ('color' for illustrations/logos vs 'bw' for line art/signatures/scans) and names an alternative route — the online converter — when higher fidelity, gradient fitting, posterize or layer editing are needed. It stops short of stating hard exclusions (e.g., unsupported formats or when not to vectorize at all), so it is strong but not fully exhaustive.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

  1. 1 tool updatev1.0.1
    • First observedvectorize_image

TDQS

A3.9/5.0

Scored across 1 tool

Disambiguation5/5

There is only one tool, so there is no possibility of misselection between tools. Its purpose (convert a raster image to SVG) is stated unambiguously.

Naming Consistency5/5

The single tool follows a clear verb_noun convention (vectorize_image). With no other tools to conflict with, the naming pattern is fully consistent.

Tool Count3/5

A one-tool surface is defensible for a narrowly focused image converter, but it is thin: the description itself points users to an external website for gradient fitting, posterize mode, and layer editing. The server feels like a minimal wrapper rather than a self-contained toolset.

Completeness3/5

The core operation (raster to SVG with color/bw modes) is covered, but there are notable gaps: no control over output path, tracing parameters (precision, color count), batch conversion, or the advanced features mentioned in the description. Agents can accomplish the basic workflow but hit dead ends for anything beyond it.

Maintenance

ActivityMaintained
ResponsivenessNo issues

Related MCP Connectors

Related MCP Servers