Shapesoda
Vectorize images: PNG/JPG to SVG, PDF, EPS, DXF. Turns logos, icons and scans into clean vectors.
Should I use this
Quality & Safety
B
Findings (2)
- HIGHTool poisoning patterns detected
- LOWTool description contains role marker that could confuse chat modelsin open_editor
Based on automated analysis of tool definitions and protocol compliance.
Context Cost
~3,338Tokens (tool definitions)
~6.6 KBTypical response size
Significant attention impact (2.61% of 128k context)
This is the approximate number of tokens consumed each time the server's tools are loaded into a model's context. Higher counts reduce the attention available for other tasks.
Install
One-Click Install
Add this to your `claude_desktop_config.json` file:
{
"mcpServers": {
"vectorizer": {
"url": "https://shapesoda.com/mcp"
}
}
}Remote endpoints
https://shapesoda.com/mcpstreamable-httpWhat it can do
Tool inventory
Tools (5)
🟢 Read-only🟡 Write🔴 Delete⚪ Unknown
🟡create_upload(filename)
Creates a one-time upload link for a local image file (valid 10 minutes). Upload the file with the returned curl command, then pass upload_id to vectorize. Only for agents whose terminal can reach shapesoda.com (Claude Code, Cursor and similar); in Claude.ai and other chat apps the sandbox cannot upload there, so call open_editor instead.
Input Schema
{
"type": "object",
"properties": {
"filename": {
"type": "string",
"description": "Optional file name, for reference only."
}
},
"additionalProperties": false
}🟡vectorize(image, upload_id, image_base64, image_type, quality, ...)
Use this when the user wants to convert a raster image (logo, icon, illustration, scan, screenshot; PNG, JPEG, WebP, BMP, GIF, TIFF) into a vector: SVG, PDF, EPS, DXF or a re-rendered PNG. Pass the image in exactly one way: image (a file attached to the chat message, ChatGPT), upload_id (from create_upload) or image_base64 (≤2 MB, only exact file bytes you already have as text). If none of these is available, for example an image attached in Claude.ai, call open_editor instead. Returns a download link per format, valid 24 hours (or retention_days), and the SVG inline when small. Uses 1 credit for all formats; mode=test is free and watermarked; mode=preview is a free PNG up to 1 MP whose link buys the vectors later (format=svg, 1 credit). Do not use for generating new images, editing photos or upscaling.
Input Schema
{
"type": "object",
"properties": {
"image": {
"type": "object",
"description": "Image file attached to the user's message in the chat (ChatGPT).",
"properties": {
"download_url": {
"type": "string"
},
"file_id": {
"type": "string"
},
"mime_type": {
"type": "string"
},
"file_name": {
"type": "string"
}
},
"required": [
"download_url",
"file_id"
]
},
"upload_id": {
"type": "string",
"description": "ID returned by create_upload after the file was uploaded."
},
"image_base64": {
"type": "string",
"description": "Exact PNG/JPEG/WebP/BMP/GIF/TIFF file bytes in base64 (≤2 MB), only when you already have them as text (e.g. from reading the file in a terminal). Never transcribe an image you only see in the conversation; call open_editor instead. Use create_upload for larger files."
},
"image_type": {
"type": "string",
"enum": [
"auto",
"artwork",
"artwork_sharp",
"photo"
],
"description": "Kind of image: artwork with smooth (anti-aliased) edges, artwork with hard pixel edges, or photo. Default auto."
},
"quality": {
"type": "string",
"enum": [
"auto",
"high",
"medium",
"low"
],
"description": "Input quality: low for blurry/noisy/JPEG-heavy images. Default auto."
},
"colors": {
"description": "Number of colors: 'auto', 'unlimited', or an integer 2–32 (max_colors goes up to 256). Default auto.",
"anyOf": [
{
"type": "string",
"enum": [
"auto",
"unlimited"
]
},
{
"type": "integer",
"minimum": 2,
"maximum": 32
}
]
},
"detail": {
"type": "string",
"enum": [
"auto",
"low",
"medium",
"high"
],
"description": "Output detail for photos. Default auto."
},
"preset": {
"type": "string",
"enum": [
"web",
"print",
"cut",
"laser",
"embroidery"
],
"description": "Settings for the job: web (default), print (PDF, shapes cut out), cut (vinyl/stickers, 8 colors), laser (2-color outlines), embroidery (12 colors, no tiny shapes)."
},
"format": {
"type": "array",
"items": {
"type": "string",
"enum": [
"svg",
"pdf",
"eps",
"dxf",
"png"
]
},
"minItems": 1,
"uniqueItems": true,
"description": "Output formats; several formats cost 1 credit together. Default: the preset's format (svg for web)."
},
"draw": {
"type": "string",
"enum": [
"fill",
"stroke",
"stroke_edges"
],
"description": "fill: filled shapes; stroke: outline of every shape; stroke_edges: only the borders between shapes, each once (no double cuts). Default from the preset."
},
"layers": {
"type": "string",
"enum": [
"stacked",
"cutouts",
"cutouts_grouped"
],
"description": "Shapes stacked on top of each other, cut out of each other, or cut out and grouped by color. Default from the preset."
},
"max_colors": {
"type": "integer",
"minimum": 2,
"maximum": 256,
"description": "Maximum number of colors (2–256). Not combined with colors or palette."
},
"palette": {
"description": "Fixed colors #rrggbb (2–256), as a list or a comma-separated string. Not combined with colors or max_colors.",
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$"
},
"minItems": 2,
"maxItems": 256
},
{
"type": "string"
}
]
},
"palette_tolerance": {
"type": "number",
"minimum": 0,
"maximum": 100,
"description": "With palette: how far (CIE76 ΔE) an image color may be from a palette color to snap to it; farther colors keep their own value."
},
"min_area": {
"type": "integer",
"minimum": 0,
"maximum": 10000,
"description": "Smallest shape kept, in px²; smaller specks are dropped. Overrides the preset."
},
"max_pixels": {
"type": "integer",
"minimum": 10000,
"maximum": 4200000,
"description": "Downscale the input to at most this many pixels before tracing (faster, fewer nodes)."
},
"curve_tolerance": {
"type": "number",
"minimum": 0.01,
"maximum": 10,
"description": "Curve fitting tolerance in source pixels (default ≈0.5): lower keeps more nodes. Also sets smoothness unless given."
},
"smoothness": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"description": "Contour smoothing 1–10 (higher: smoother, fewer nodes)."
},
"corners": {
"type": "string",
"enum": [
"sharp",
"smooth"
],
"description": "Keep corners sharp or round them."
},
"denoise": {
"type": "integer",
"minimum": 0,
"maximum": 3,
"description": "Noise reduction before tracing: 0 off … 3 strongest."
},
"group_by": {
"type": "string",
"enum": [
"none",
"color",
"layer"
],
"description": "Groups in the output: color (one per color) or layer (by nesting depth). SVG <g>, PDF layers, EPS blocks, DXF layers. Default: by color only for layers=cutouts_grouped (DXF always by color)."
},
"curves": {
"type": "string",
"enum": [
"all",
"lines",
"lines_arcs"
],
"description": "all: curves and lines; lines: straight segments only; lines_arcs: DXF lines and arcs, other formats as lines."
},
"stroke_width": {
"type": "number",
"minimum": 0.01,
"maximum": 100,
"description": "Stroke width; needs draw=stroke or stroke_edges. Output units, or source pixels with stroke_scaling=scale. Default: hairline."
},
"stroke_color": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$",
"description": "Stroke color #rrggbb instead of the shape color; needs draw=stroke or stroke_edges."
},
"stroke_scaling": {
"type": "string",
"enum": [
"fixed",
"scale"
],
"description": "fixed (default): width stays in output units when resized; scale: width in source pixels scales with the drawing."
},
"gap_filler": {
"type": "string",
"enum": [
"on",
"off"
],
"description": "on: an underlay in the shape colors hides light gaps between shapes. Needs draw=fill. Default off."
},
"gap_filler_width": {
"type": "number",
"minimum": 0,
"maximum": 10,
"description": "Gap filler width in source pixels (default 1). Needs gap_filler=on."
},
"aspect": {
"type": "string",
"enum": [
"fit",
"fill",
"stretch"
],
"description": "With both width and height: fit (default, whole drawing inside), fill (covers the sheet, excess cropped), stretch (exact size, distorted)."
},
"align_x": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Horizontal placement on the sheet, 0 left … 1 right (default 0.5). Needs width and height; not with aspect=stretch."
},
"align_y": {
"type": "number",
"minimum": 0,
"maximum": 1,
"description": "Vertical placement on the sheet, 0 top … 1 bottom (default 0.5). Needs width and height; not with aspect=stretch."
},
"scale": {
"type": "number",
"exclusiveMinimum": 0,
"maximum": 100,
"description": "Output size as a multiple of the source size. Not with width/height."
},
"dpi": {
"type": "integer",
"minimum": 1,
"maximum": 2400,
"description": "Pixels per inch of PNG output; needs a size in pt, mm, cm or in. Default 300."
},
"svg_version": {
"type": "string",
"enum": [
"1.1",
"1.0",
"tiny1.2"
],
"description": "SVG flavor: 1.1 (default), 1.0, or tiny1.2 (no opacity or gradient transforms)."
},
"svg_fixed_size": {
"type": "boolean",
"description": "true (default): width/height on the root <svg>; false: only a viewBox (responsive)."
},
"adobe_compat": {
"type": "boolean",
"description": "true: SVG friendly to Adobe Illustrator (size always set, stroke widths in drawing coordinates)."
},
"dxf_curves": {
"type": "string",
"enum": [
"lines",
"arcs",
"splines"
],
"description": "DXF curves as lines (polylines, default), arcs or splines. curves=lines/lines_arcs wins."
},
"png_antialias": {
"type": "string",
"enum": [
"on",
"off"
],
"description": "Anti-aliasing in PNG output. Default on."
},
"transparency": {
"type": "string",
"pattern": "^(keep|white|#[0-9a-fA-F]{6})$",
"description": "Transparent areas: keep (stay transparent), white, or a background color #rrggbb."
},
"width": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Physical output width in unit. With width only, the height follows the aspect ratio; with height too, a sheet of that size (see aspect). Up to 10 m."
},
"height": {
"type": "number",
"exclusiveMinimum": 0,
"description": "Physical output height in unit (width follows the aspect ratio unless width is set too)."
},
"unit": {
"type": "string",
"enum": [
"px",
"pt",
"mm",
"cm",
"in"
],
"description": "Unit for width/height: px (default), pt, mm, cm, in."
},
"mode": {
"type": "string",
"enum": [
"live",
"test",
"preview"
],
"description": "test: free, watermarked result for building an integration. preview: free PNG up to 1 MP without watermark, no vectors; fetch its link with format=svg to buy the vectors for 1 credit. Neither is available for vectorize_url. Default live."
},
"retention_days": {
"type": "integer",
"minimum": 1,
"maximum": 30,
"description": "Keep the result downloadable for this many days (default 24 hours). Live mode only."
}
},
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"result_id": {
"type": "string"
},
"download_url": {
"type": "string",
"description": "Link to the first requested format."
},
"files": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"description": "Download link per format."
},
"expires_at": {
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"svg_bytes": {
"type": "integer"
},
"credits_charged": {
"type": "integer"
},
"credits_remaining": {
"type": "integer"
},
"mode": {
"type": "string"
},
"free_remaining_today": {
"type": "integer",
"description": "Free MCP vectorizations left today (used before credits)."
}
},
"required": [
"files",
"width",
"height",
"credits_remaining"
]
}🟢open_editor
Use this when the user wants to vectorize an image but you cannot pass the image to vectorize (no image, upload_id or exact base64 bytes available), including when the user attached the image in Claude.ai: opens the Shapesoda window, where the user picks the file, sees the vector result and adjusts it. Does not vectorize by itself and uses no credits. Do not use for generating new images.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}⚪revectorize(result_id, token, image_type, quality, colors, ...)
Re-vectorizes a stored result (result_id and token from vectorize) with other settings, free for 24 hours after the first vectorization. Used by the Shapesoda window.
Input Schema
{
"type": "object",
"properties": {
"result_id": {
"type": "string",
"description": "result_id from vectorize or revectorize."
},
"token": {
"type": "string",
"description": "Result token (the token parameter of the result links)."
},
"image_type": {
"type": "string",
"enum": [
"auto",
"artwork",
"artwork_sharp",
"photo"
],
"description": "Kind of image: artwork with smooth (anti-aliased) edges, artwork with hard pixel edges, or photo. Default auto."
},
"quality": {
"type": "string",
"enum": [
"auto",
"high",
"medium",
"low"
],
"description": "Input quality: low for blurry/noisy/JPEG-heavy images. Default auto."
},
"colors": {
"description": "Number of colors: 'auto', 'unlimited', or an integer 2–32 (max_colors goes up to 256). Default auto.",
"anyOf": [
{
"type": "string",
"enum": [
"auto",
"unlimited"
]
},
{
"type": "integer",
"minimum": 2,
"maximum": 32
}
]
},
"palette": {
"description": "Fixed colors #rrggbb (2–256), as a list or a comma-separated string. Not combined with colors or max_colors.",
"anyOf": [
{
"type": "array",
"items": {
"type": "string",
"pattern": "^#[0-9a-fA-F]{6}$"
},
"minItems": 2,
"maxItems": 256
},
{
"type": "string"
}
]
},
"smoothness": {
"type": "integer",
"minimum": 1,
"maximum": 10,
"description": "Contour smoothing 1–10 (higher: smoother, fewer nodes)."
},
"transparency": {
"type": "string",
"pattern": "^(keep|white|#[0-9a-fA-F]{6})$",
"description": "Transparent areas: keep (stay transparent), white, or a background color #rrggbb."
},
"corners": {
"type": "string",
"enum": [
"sharp",
"smooth"
],
"description": "Keep corners sharp or round them."
},
"min_area": {
"type": "integer",
"minimum": 0,
"maximum": 10000,
"description": "Smallest shape kept, in px²; smaller specks are dropped. Overrides the preset."
}
},
"required": [
"result_id",
"token"
],
"additionalProperties": false
}Output Schema
{
"type": "object",
"properties": {
"result_id": {
"type": "string"
},
"download_url": {
"type": "string",
"description": "Link to the first requested format."
},
"files": {
"type": "object",
"additionalProperties": {
"type": "string"
},
"description": "Download link per format."
},
"expires_at": {
"type": "string"
},
"width": {
"type": "integer"
},
"height": {
"type": "integer"
},
"svg_bytes": {
"type": "integer"
},
"credits_charged": {
"type": "integer"
},
"credits_remaining": {
"type": "integer"
},
"mode": {
"type": "string"
},
"free_remaining_today": {
"type": "integer",
"description": "Free MCP vectorizations left today (used before credits)."
}
},
"required": [
"files",
"width",
"height",
"credits_remaining"
]
}🟢get_usage
Shows how many credits were used this month and how many remain.
Input Schema
{
"type": "object",
"properties": {},
"additionalProperties": false
}Community
Evidence
Recent observations
verifiedversion not recorded5 tools