Shapesoda
Server Details
Vectorize images: PNG/JPG to SVG, PDF, EPS, DXF. Turns logos, icons and scans into clean vectors.
- Status
- Healthy
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
TDQS
Score is being calculated.
Available Tools
5 toolscreate_uploadCreate upload linkInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| filename | No | Optional file name, for reference only. |
get_usageGet usageRead-onlyIdempotentInspect
Shows how many credits were used this month and how many remain.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
open_editorOpen ShapesodaRead-onlyIdempotentInspect
Use this when the user wants to vectorize an image but you cannot pass the image to vectorize (no image, upload_id or image_base64 available): 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.
| Name | Required | Description | Default |
|---|---|---|---|
No parameters | |||
revectorizeRe-vectorize with other settingsInspect
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.
| Name | Required | Description | Default |
|---|---|---|---|
| token | Yes | Result token (the token parameter of the result links). | |
| colors | No | Number of colors: 'auto', 'unlimited', or an integer 2–32 (max_colors goes up to 256). Default auto. | |
| corners | No | Keep corners sharp or round them. | |
| palette | No | Fixed colors #rrggbb (2–256), as a list or a comma-separated string. Not combined with colors or max_colors. | |
| quality | No | Input quality: low for blurry/noisy/JPEG-heavy images. Default auto. | |
| min_area | No | Smallest shape kept, in px²; smaller specks are dropped. Overrides the preset. | |
| result_id | Yes | result_id from vectorize or revectorize. | |
| image_type | No | Kind of image: artwork with smooth (anti-aliased) edges, artwork with hard pixel edges, or photo. Default auto. | |
| smoothness | No | Contour smoothing 1–10 (higher: smoother, fewer nodes). | |
| transparency | No | Transparent areas: keep (stay transparent), white, or a background color #rrggbb. |
Output Schema
| Name | Required | Description |
|---|---|---|
| mode | No | |
| files | Yes | Download link per format. |
| width | Yes | |
| height | Yes | |
| result_id | No | |
| svg_bytes | No | |
| expires_at | No | |
| download_url | No | Link to the first requested format. |
| credits_charged | No | |
| credits_remaining | Yes | |
| free_remaining_today | No | Free MCP vectorizations left today (used before credits). |
vectorizeVectorize imageInspect
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), upload_id (from create_upload) or image_base64 (≤2 MB). 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.
| Name | Required | Description | Default |
|---|---|---|---|
| dpi | No | Pixels per inch of PNG output; needs a size in pt, mm, cm or in. Default 300. | |
| draw | No | fill: filled shapes; stroke: outline of every shape; stroke_edges: only the borders between shapes, each once (no double cuts). Default from the preset. | |
| mode | No | 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. | |
| unit | No | Unit for width/height: px (default), pt, mm, cm, in. | |
| image | No | Image file attached to the user's message in the chat (ChatGPT). | |
| scale | No | Output size as a multiple of the source size. Not with width/height. | |
| width | No | 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. | |
| aspect | No | With both width and height: fit (default, whole drawing inside), fill (covers the sheet, excess cropped), stretch (exact size, distorted). | |
| colors | No | Number of colors: 'auto', 'unlimited', or an integer 2–32 (max_colors goes up to 256). Default auto. | |
| curves | No | all: curves and lines; lines: straight segments only; lines_arcs: DXF lines and arcs, other formats as lines. | |
| detail | No | Output detail for photos. Default auto. | |
| format | No | Output formats; several formats cost 1 credit together. Default: the preset's format (svg for web). | |
| height | No | Physical output height in unit (width follows the aspect ratio unless width is set too). | |
| layers | No | Shapes stacked on top of each other, cut out of each other, or cut out and grouped by color. Default from the preset. | |
| preset | No | 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). | |
| align_x | No | Horizontal placement on the sheet, 0 left … 1 right (default 0.5). Needs width and height; not with aspect=stretch. | |
| align_y | No | Vertical placement on the sheet, 0 top … 1 bottom (default 0.5). Needs width and height; not with aspect=stretch. | |
| corners | No | Keep corners sharp or round them. | |
| denoise | No | Noise reduction before tracing: 0 off … 3 strongest. | |
| palette | No | Fixed colors #rrggbb (2–256), as a list or a comma-separated string. Not combined with colors or max_colors. | |
| quality | No | Input quality: low for blurry/noisy/JPEG-heavy images. Default auto. | |
| group_by | No | 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). | |
| min_area | No | Smallest shape kept, in px²; smaller specks are dropped. Overrides the preset. | |
| upload_id | No | ID returned by create_upload after the file was uploaded. | |
| dxf_curves | No | DXF curves as lines (polylines, default), arcs or splines. curves=lines/lines_arcs wins. | |
| gap_filler | No | on: an underlay in the shape colors hides light gaps between shapes. Needs draw=fill. Default off. | |
| image_type | No | Kind of image: artwork with smooth (anti-aliased) edges, artwork with hard pixel edges, or photo. Default auto. | |
| max_colors | No | Maximum number of colors (2–256). Not combined with colors or palette. | |
| max_pixels | No | Downscale the input to at most this many pixels before tracing (faster, fewer nodes). | |
| smoothness | No | Contour smoothing 1–10 (higher: smoother, fewer nodes). | |
| svg_version | No | SVG flavor: 1.1 (default), 1.0, or tiny1.2 (no opacity or gradient transforms). | |
| adobe_compat | No | true: SVG friendly to Adobe Illustrator (size always set, stroke widths in drawing coordinates). | |
| image_base64 | No | PNG/JPEG/WebP/BMP/GIF/TIFF bytes in base64 (≤2 MB). Use create_upload for larger files. | |
| stroke_color | No | Stroke color #rrggbb instead of the shape color; needs draw=stroke or stroke_edges. | |
| stroke_width | No | Stroke width; needs draw=stroke or stroke_edges. Output units, or source pixels with stroke_scaling=scale. Default: hairline. | |
| transparency | No | Transparent areas: keep (stay transparent), white, or a background color #rrggbb. | |
| png_antialias | No | Anti-aliasing in PNG output. Default on. | |
| retention_days | No | Keep the result downloadable for this many days (default 24 hours). Live mode only. | |
| stroke_scaling | No | fixed (default): width stays in output units when resized; scale: width in source pixels scales with the drawing. | |
| svg_fixed_size | No | true (default): width/height on the root <svg>; false: only a viewBox (responsive). | |
| curve_tolerance | No | Curve fitting tolerance in source pixels (default ≈0.5): lower keeps more nodes. Also sets smoothness unless given. | |
| gap_filler_width | No | Gap filler width in source pixels (default 1). Needs gap_filler=on. | |
| palette_tolerance | No | 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. |
Output Schema
| Name | Required | Description |
|---|---|---|
| mode | No | |
| files | Yes | Download link per format. |
| width | Yes | |
| height | Yes | |
| result_id | No | |
| svg_bytes | No | |
| expires_at | No | |
| download_url | No | Link to the first requested format. |
| credits_charged | No | |
| credits_remaining | Yes | |
| free_remaining_today | No | Free MCP vectorizations left today (used before credits). |
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
5 tool updates
- First observed
create_upload - First observed
get_usage - First observed
open_editor - First observed
revectorize - First observed
vectorize
Related MCP Connectors
Convert any image into machine embroidery files (DST, PES…) or vector graphics (SVG, PDF, EPS, DXF).
Generate and vectorize clean, editable SVG graphics from text, images, or both.
Create professional SVG artwork, icons and vector logos from a prompt, or vectorize any image.
Text or image to clean, editable SVG from $0.01. Free SVG library + agent search, no key.
Related MCP Servers
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to generate professional SVG artwork, icons, and vector logos from text prompts, and to vectorize raster images into clean, editable SVG files.MIT
- FlicenseNot gradedqualityCmaintenanceBrode.io - Convert any image into machine embroidery files (DST, PES, JEF, VP3, EXP, U01, XXX) or vector graphics (SVG, PDF, EPS, DXF) — hosted remote server with a free tier, by the maker of the Brode web app.-
- AlicenseNot gradedqualityDmaintenanceGenerates SVGs from text prompts and converts raster images to SVG using the Quiver AI API.2MIT
- AlicenseAqualityDmaintenanceEnables AI agents to vectorize raster images and import vector files (PDF/AI/EPS), then inspect, edit, render, and optimize SVGs locally.6MIT
Glama MCP Gateway
Add one secure layer between your agents and this server.