inkscape-mcp
This is a local MCP server for safely controlling headless Inkscape to create, inspect, edit, import, export, and batch-process SVG documents inside authorized workspaces.
Status & workspace safety: detects Inkscape availability, reports security posture, lists authorized workspaces and documents without exposing filesystem paths.
Document management: creates new SVG documents, inspects dimensions/viewBox/revision, resizes pages, manages explicit Inkscape 1.4 pages, and updates page/desk/border settings.
Vector design editing: creates, queries, updates, deletes, transforms, arranges, groups, aligns, and distributes typed SVG elements: shapes, paths, text, layers, groups, and connectors.
SVG resources: manages gradients, patterns, markers, filters, clips, masks, symbols, guides/grids, metadata, palettes, and font/accessibility inspection.
Importing: imports SVG/SVGZ, raster images, and PDFs through sanitized/validated pipelines with SHA-256 manifests and import capability discovery.
Exporting: exports to PNG, PDF, and SVG using bounded options and presets, with verified output, atomic batches, jobs, and recipe-driven CLI workflows.
Automation: supports queue-based durable recipes and PowerShell scheduled task helpers for unattended Windows execution.
Concurrency & security: mutations require expectedRevision, changes create backups and atomic commits, and raw XML/shell/absolute paths are rejected; exports preflight against active content and remote resources.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@inkscape-mcp Resize my SVG to 500x300 and export as PNG"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
inkscape-mcp
Local MCP server, via stdio, for bounded headless control of Inkscape. This pre-alpha version focuses on SVG/Inkscape documents, sizes, pages, and verified exports to PNG, PDF, and SVG.
What works today
Inkscape discovery, including the Windows MSIX package, and
--doctorwith capability evidence.Authorized workspaces with safe relative paths, SHA-256 revisions, locks, backups, and atomic commits.
Create, inspect, and resize SVG documents with
page_onlysemantics, custom measurements, or A3/A4/Letter presets, and initial pages.Explicit Inkscape 1.4 pages: list, add, update, delete, and reorder with stable IDs.
Typed page settings: page color/opacity, desktop color, and border color/opacity.
Basic SVG preflight and PNG, PDF 1.4/1.5, and flat or Inkscape SVG exports. Results are verified before publishing.
It is not yet a complete vector editor: it does not announce general manipulation of objects, layers, text, paths, selections, filters, or local dependencies. See the master plan for scope and pending tasks.
Related MCP server: inkscape-mcp
Requirements
Node.js 24.x and npm 11.x.
Inkscape 1.4.4 or compatible. On Windows, the MSIX installation observed during development is detected automatically.
Run locally
npm ci
npm run check
npm run test:mcp
node dist/cli.js --doctor --json
node dist/cli.js --workspace-root C:\ruta\a\tus\disenosThe last command keeps the MCP protocol exclusively on stdout. Configure your MCP client to launch it with node, argument dist/cli.js, and one or more --workspace-root arguments; only those directories will be visible to the document tools.
Current MCP tools
Tool | Usage |
| Status, capabilities, and security posture. |
| Available workspaces and allowed SVG/SVGZ. |
| Create and manage viewport, units, |
| List or mutate explicit Inkscape 1.4 pages. |
| Read or edit page background, desktop, and border. |
| Detect active content, external resources, and errors with basic/web/print/interchange profiles. |
| Update geometry, basic style, text, or layer label via typed patches. |
| Change sibling Z-order: front/back/raise/lower, without arbitrary XML indices or ordering. |
| Group siblings or ungroup an SVG group without breaking external |
| Query bounded summaries by ID, type, or layer, with pagination and |
| Create typed shapes, text, groups, and layers; supports parentId within the batch. |
| Delete selected IDs without leaving broken fragment references. |
| Transform elements with typed translate, scale, rotate, skew, flip, or matrix. |
| Export via Inkscape with staging and validate the artifact; PNG accepts area/DPI/background, PDF reports pages and MediaBox, and SVG can convert text to paths. |
Mutations and exports require expectedRevision. If a file changes between read and commit, the operation fails instead of overwriting someone else's revision. Every export provides Inkscape with a verified copy of the SVG in staging, never the live workspace path.
Security and status
The project does not promise to isolate unknown vulnerabilities in native parsers. It limits paths, XML, arguments, processes, sizes, and overwrites; the current native input policy is trusted-local-only. Export rejects SVG with active content or remote resources before starting Inkscape; resize mutations apply the same rule.
Contribution instructions and invariants are in AGENTS.md. The package remains private: publishing it to npm or a registry will require separate explicit authorization.
License
MIT Copyright 2026 Berrio.
Available Tools
90 toolsaccessibility_inspectBRead-only
Provides explicitly heuristic SVG text contrast and document reading-order diagnostics; contrast uses an opaque Inkscape page background when available, otherwise white, and only direct hex fill.
Inputs: path (required), workspaceId (required). Returns: warnings, background, readingOrder, lowContrastText
artifact_read_chunkBRead-only
Reads one owner-bound, bounded binary artifact chunk by opaque ID. Use resource links for ordinary artifact consumption.
Inputs: length (required), offset (required), artifactId (required), workspaceId (required). Returns: hash, size, length, offset, +3 more
assets_packageB
Creates a portable workspace-local SVG package containing document.svg, rewritten local assets, and a revision manifest. Every package file is published together and existing files are never overwritten.
Inputs: path (required), workspaceId (required), outputDirectory (required), expectedRevision (required), +1 more. Returns: files, documentPath, manifestPath, dependencyCount
clips_manageADestructive
Creates typed rectangular SVG clipPaths, applies or releases them from explicit elements, and prevents deletion while any SVG or CSS reference remains.
Returns: id, action, revision, targetIds, +1 more
color_management_inspectARead-only
Lists local SVG color-profile metadata and ICC paint references without claiming CMYK conversion or PDF/X output-intent validation.
Inputs: path (required), workspaceId (required). Returns: profiles, limitations, iccReferenceCount, cmykLikeReferenceCount, +1 more
connector_createCDestructive
Creates one typed Inkscape polyline connector between two existing local element IDs without accepting SVG/XML or arbitrary connection attributes.
Inputs: id (required), path (required), toId (required), fromId (required), +3 more. Returns: id, revision, backupCreated
connector_retargetADestructive
Retargets an existing semantic Inkscape connector to two explicit local endpoints while preserving its current polyline route.
Inputs: id (required), path (required), toId (required), fromId (required), +2 more. Returns: id, revision, backupCreated
connector_routeBDestructive
Routes a semantic Inkscape connector orthogonally between explicit rect, circle, or ellipse endpoints. Optional explicit obstacles use bounded Manhattan routing with axis-aligned transforms and a typed clearance.
Inputs: id (required), path (required), toId (required), fromId (required), +5 more. Returns: id, points, revision, backupCreated, +1 more
defs_vacuumBDestructive
Plans or conservatively removes unused top-level SVG definitions. Defaults to dry-run and never rewrites referenced resources.
Inputs: path (required), workspaceId (required), dryRun, expectedRevision. Returns: dryRun, revision, removedIds, candidateIds, +1 more
document_apply_operationsBDestructive
Applies a bounded ordered design transaction to an SVG. Every operation is validated against the preceding in-memory result; a failure leaves the source untouched.
Inputs: path (required), operations (required), workspaceId (required), expectedRevision (required), +2 more. Returns: diff, dryRun, version, revision, +3 more
document_createB
Creates a new SVG document from bounded custom dimensions or a named page preset. Existing outputs are never overwritten.
Inputs: outputPath (required), workspaceId (required), unit, pages, +3 more. Returns: revision, documentPath
document_exportB
Exports one PNG, PDF, SVG, plain SVG, PS, EPS, EMF, experimental WMF, or a fixed versioned DXF/HPGL/FXG/SIF/GPL adapter from a validated ExportSpec through the bounded Inkscape pipeline. Legacy vector formats require explicit acknowledgement of fidelity limits.
Inputs: spec (required), workspaceId (required). Returns: format, adapter, artifact, revision, +2 more
document_export_batchC
Renders a bounded batch of baseline PNG, PDF, SVG, or plain SVG variants. all_or_nothing verifies every variant before one logical publish; best_effort publishes verified successes.
Inputs: mode (required), workspaceId (required), specs, preset, +3 more. Returns: object
document_export_preset_planARead-only
Preflights one named export preset without publishing files and returns an owner-bound, single-use plan token. Execution must use the token before it expires, so the plan stays tied to the source revision and observed Inkscape capabilities.
Inputs: preset (required), workspaceId (required), ttlMs. Returns: digest, expiresAt, planToken, preflight, +4 more
document_fit_pageBDestructive
Fits a page to native visual drawing or selected-object bounds with explicit per-side margins. This never transforms objects.
Inputs: path (required), unit (required), scope (required), workspaceId (required), +3 more. Returns: page, bounds, revision, warnings, +2 more
document_importB
Imports one workspace-local SVG or SVGZ into a new sanitized SVG plus an adjacent reproducible conversion manifest. SVGZ expansion is hard-limited and no external resource is fetched.
Inputs: path (required), format (required), outputPath (required), workspaceId (required), +3 more. Returns: manifest, revision, outputPath, manifestPath, +1 more
document_import_capabilitiesARead-only
Reports the exact input types observed from this local Inkscape --list-input-types probe, including headless fixture gates for supported native import adapters. A detected type is never exposed until its real headless conversion fixture passes.
Inputs: no named parameters. Returns: inputTypes, svgzImport, rasterImport, nativeImportGates, +1 more
document_import_emfB
Imports one trusted workspace-local EMF file through the observed local Inkscape capability into a sanitized SVG and conversion manifest. It never accepts arbitrary native formats or arguments.
Inputs: path (required), outputPath (required), workspaceId (required), manifestPath (required), +3 more. Returns: manifest, revision, outputPath, manifestPath, +1 more
document_import_pdfB
Imports exactly one page of a workspace-local PDF through the local Inkscape importer into a sanitized SVG and conversion manifest. The internal and Poppler importers are explicit, capability-gated modes with fidelity warnings.
Inputs: mode (required), page (required), path (required), outputPath (required), +6 more. Returns: manifest, revision, outputPath, manifestPath, +1 more
document_import_postscriptB
Imports one trusted workspace-local EPS or PostScript file through the observed local Inkscape capability into a sanitized SVG and conversion manifest. It never accepts arbitrary native formats or arguments.
Inputs: path (required), format (required), outputPath (required), workspaceId (required), +4 more. Returns: manifest, revision, outputPath, manifestPath, +1 more
document_import_rasterA
Imports one workspace-local uncompressed BMP/TIFF/TGA, PNG, JPEG, GIF, or WebP as a new SVG document with a byte-sniffed, megapixel-bounded raster wrapper and conversion manifest. It can embed the approved bytes or retain one workspace-local relative link; it never fetches a URL.
Inputs: path (required), outputPath (required), workspaceId (required), manifestPath (required), +2 more. Returns: manifest, revision, outputPath, manifestPath, +1 more
document_import_svgA
Imports one workspace-local SVG into a new sanitized SVG document. Scripts, event handlers and forbidden external references are removed according to the selected policy.
Inputs: path (required), outputPath (required), workspaceId (required), expectedRevision (required), +1 more. Returns: removed, revision, outputPath
document_inspectBRead-only
Reads SVG settings and a bounded, redacted design inventory from an authorized document without mutating it.
Inputs: path (required), workspaceId (required), level, inventoryKinds, +4 more. Returns: pages, width, height, viewBox, +10 more
document_normalize_idsBDestructive
Explicitly normalizes invalid or duplicate SVG IDs and rewrites supported local href, URL, ARIA and CSS references. Existing valid unique IDs remain unchanged.
Inputs: path (required), workspaceId (required), expectedRevision (required), prefix, +1 more. Returns: renamed, revision, backupCreated
document_optimizeB
Plans or writes a derived SVG that removes only unused top-level definitions. Publication requires a deterministic Inkscape visual-regression render; the source document is never modified.
Inputs: path (required), workspaceId (required), dryRun, outputPath, +3 more. Returns: dryRun, revision, outputPath, removedIds, +2 more
document_page_adjustCDestructive
Crops, expands or changes page orientation with explicit physical margins, preserving object geometry.
Inputs: path (required), unit (required), action (required), workspaceId (required), +3 more. Returns: page, revision, warnings, backupCreated
document_pagesBDestructive
Lists or safely changes explicit Inkscape 1.4 pages by stable page ID. Mutations require the current document revision.
Inputs: path (required), action (required), workspaceId (required), page, +4 more. Returns: pages, revision
document_page_validateBRead-only
Validates explicit Inkscape page overlap, empty pages and objects outside every page using native visual bounds.
Inputs: path (required), workspaceId (required), expectedRevision (required). Returns: pages, revision, warnings, validation, +1 more
document_preflightBRead-only
Runs a read-only basic, web, print, or interchange preflight without opening linked resources.
Inputs: path (required), workspaceId (required), bleed, profile. Returns: print, valid, issues, profile
document_render_previewB
Renders a bounded transparent PNG preview through Inkscape without changing the source document. Small results are returned inline and every preview is saved to an authorized workspace path.
Inputs: path (required), outputPath (required), workspaceId (required), expectedRevision (required), +6 more. Returns: area, cache, width, height, +6 more
document_resizeBDestructive
Changes the SVG page size with page_only semantics while preserving element geometry, returning a bounded semantic diff. Requires the current document revision.
Inputs: path (required), unit (required), width (required), height (required), +5 more. Returns: diff, dryRun, revision, warnings, +4 more
document_restoreBDestructive
Restores an owner-bound snapshot only when the current document revision matches exactly.
Inputs: path (required), snapshotId (required), workspaceId (required), expectedRevision (required). Returns: revision, backupCreated
document_settingsADestructive
Reads or updates typed Inkscape page, desk and border display settings. Updates require the current document revision.
Inputs: path (required), workspaceId (required), settings, expectedRevision. Returns: revision, settings
document_snapshotA
Creates an opaque, owner-bound snapshot of a document after verifying its exact revision.
Inputs: path (required), workspaceId (required), expectedRevision (required), ttlMs. Returns: revision, snapshotId
elements_alignBDestructive
Aligns SVG elements to a selection, page, coordinate or another element using Inkscape visual bounds; selected ancestors and descendants are rejected.
Inputs: ids (required), path (required), alignment (required), workspaceId (required), +2 more. Returns: moves, revision, alignment, backupCreated
elements_arrangeADestructive
Moves same-parent SVG elements to front, back, one step, a deterministic sibling index, or immediately before/after a sibling.
Returns: ids, index, action, revision, +2 more
elements_createCDestructive
Creates a bounded batch of typed SVG basic shapes without accepting XML or arbitrary attributes.
Inputs: path (required), elements (required), workspaceId (required), expectedRevision (required). Returns: ids, revision, backupCreated
elements_deleteBDestructive
Deletes explicitly selected SVG elements and rejects deletions that would leave fragment references broken.
Inputs: ids (required), path (required), workspaceId (required), expectedRevision (required). Returns: revision, deletedIds, backupCreated
elements_distributeBDestructive
Distributes SVG elements by visual edges, centres or gaps using native Inkscape bounds, preserving the first and last element on the chosen axis.
Inputs: ids (required), axis (required), mode (required), path (required), +2 more. Returns: axis, mode, moves, revision, +1 more
elements_duplicateBDestructive
Duplicates a bounded SVG subtree with deterministic local-ID remapping, or creates an explicit SVG use clone. Only internal fragment references in a copied subtree are rewritten; malformed source IDs must be normalized first.
Inputs: id (required), mode (required), path (required), newId (required), +3 more. Returns: id, mode, revision, remappedIds, +1 more
elements_flatten_transformADestructive
Bakes each selected element's own axis-aligned translate/scale/matrix transform into safe primitive geometry. It rejects rotation, skew, paths and inherited transforms rather than changing SVG semantics.
Inputs: ids (required), path (required), workspaceId (required), expectedRevision (required). Returns: revision, flattenedIds, backupCreated
elements_groupADestructive
Groups same-parent SVG elements or ungroups one non-layer group while preserving child order and rejecting broken href references.
Returns: ids, action, revision, backupCreated
elements_queryCRead-only
Lists bounded SVG element summaries by IDs, type, layer, or one safe CSS compound selector without exposing arbitrary XML attributes.
Inputs: path (required), workspaceId (required), ids, kinds, +7 more. Returns: total, elements, missingIds
elements_remove_overlapsADestructive
Separates overlapping SVG elements by deterministic translation on one axis, using Inkscape visual bounds. It does not union, trim, delete, or otherwise alter path geometry.
Inputs: ids (required), axis (required), path (required), workspaceId (required), +2 more. Returns: gap, axis, moves, revision, +1 more
elements_reparentBDestructive
Moves bounded SVG elements under one existing group or layer in source document order. It rejects cycles and ancestor-descendant selections.
Inputs: ids (required), path (required), parentId (required), workspaceId (required), +1 more. Returns: ids, revision, backupCreated
elements_transformBDestructive
Appends an allowlisted numeric SVG transform to selected elements without accepting transform strings, then re-routes compatible semantic connectors attached to moved endpoints.
Inputs: ids (required), path (required), transform (required), workspaceId (required), +1 more. Returns: ids, revision, backupCreated, reroutedConnectorIds
elements_updateCDestructive
Updates bounded SVG geometry, basic styles, text, or layer labels through typed allowlisted patches.
Inputs: path (required), elements (required), workspaceId (required), expectedRevision (required). Returns: ids, revision, backupCreated, reroutedConnectorIds
export_pdfC
Exports an SVG document to a validated PDF through Inkscape using bounded, allowlisted options.
Inputs: path (required), outputPath (required), workspaceId (required), expectedRevision (required), +9 more. Returns: hash, pageIds, version, revision, +7 more
export_pdf_pagesB
Exports explicit Inkscape pages as individually validated PDFs with stable page-NNN.pdf names.
Inputs: path (required), workspaceId (required), outputDirectory (required), expectedRevision (required), +2 more. Returns: pages, strategy, warnings
export_pngC
Exports an SVG document to PNG through Inkscape using only bounded, allowlisted options.
Inputs: path (required), outputPath (required), workspaceId (required), expectedRevision (required), +17 more. Returns: area, dpiX, dpiY, hash, +9 more
export_svgC
Exports an SVG as Inkscape SVG or plain SVG through the bounded Inkscape pipeline.
Inputs: path (required), flavor (required), outputPath (required), workspaceId (required), +4 more. Returns: hash, assets, flavor, viewBox, +3 more
filters_manageBDestructive
Creates, replaces, applies, releases or safely deletes typed SVG blur, drop-shadow, blend and color-matrix filters without accepting arbitrary XML.
Returns: id, action, revision, targetIds, +1 more
flowed_text_convertADestructive
Converts one simple one-region Inkscape flowRoot to editable SVG text only after explicit lossy confirmation. Complex flows are rejected.
Inputs: id (required), path (required), workspaceId (required), confirmLossy (required), +1 more. Returns: id, warning, revision, backupCreated
flowed_text_inspectARead-only
Lists Inkscape flowed-text roots and paragraph counts without interpreting their layout.
Inputs: path (required), workspaceId (required). Returns: flowedTexts
fonts_listBRead-only
Lists a bounded cache of local system font family names without exposing font file paths.
Inputs: refresh. Returns: cached, source, families, familyCount
fonts_preflightARead-only
Checks SVG-declared font families against the local cached font inventory; glyph coverage and embedding permissions remain explicitly unverified.
Inputs: path (required), workspaceId (required), refreshFonts. Returns: cached, source, warnings, genericFamilies, +3 more
gradients_manageBDestructive
Creates, replaces, applies or deletes typed SVG linear/radial gradients in without accepting free XML or CSS.
Returns: id, action, revision, targetIds, +1 more
guides_grids_manageBDestructive
Inspects and safely changes document-local Inkscape guides and xygrids. It never reads or changes global Inkscape preferences.
Returns: id, grids, action, guides, +2 more
images_cropCDestructive
Crops one SVG image non-destructively by applying a new local user-space clipPath; the original image href and geometry remain unchanged.
Inputs: x (required), y (required), path (required), width (required), +5 more. Returns: clipId, imageId, revision, backupCreated
images_inspect_dpiBRead-only
Reports effective DPI X/Y for embedded PNG images and a conservative singular-value range when transforms include rotation or skew. Linked image bytes are never read.
Inputs: path (required), workspaceId (required). Returns: images
images_manageBDestructive
Relinks, embeds, or extracts explicit SVG raster images using only workspace-confined files and bounded supported MIME types.
Returns: action, imageId, revision, assetPath, +1 more
images_traceADestructive
Irreversibly traces one local or embedded raster image through the verified Inkscape object-trace action. Only the bounded default preset is available; no trace parameters, actions, or extensions are accepted.
Inputs: path (required), imageId (required), workspaceId (required), expectedRevision (required), +2 more. Returns: diff, preset, raster, imageId, +3 more
inkscape_statusARead-only
Reports local Inkscape availability, observed capabilities and security posture without exposing filesystem paths.
Inputs: no named parameters. Returns: inkscape, actionCount, workspaceReady, securityPosture, +2 more
job_cancelA
Idempotently requests cancellation of an owner-bound asynchronous export job. No unfinished output is published.
Inputs: jobId (required), workspaceId (required). Returns: id, error, result, status, +1 more
job_getBRead-only
Returns the owner-bound status, latest monotonic progress and terminal batch result of an asynchronous export job.
Inputs: jobId (required), workspaceId (required). Returns: id, error, result, status, +1 more
markers_manageBDestructive
Creates, replaces, applies or deletes typed SVG arrow/dot markers without accepting free path data or XML.
Returns: id, action, revision, targetIds, +1 more
masks_manageADestructive
Creates typed opaque rectangular SVG masks, applies or releases them from explicit elements, and prevents deletion while any SVG or CSS reference remains.
Returns: id, action, revision, targetIds, +1 more
mesh_gradients_inspectBRead-only
Lists preserved SVG mesh gradients and their structural counts without exposing unsupported editing or rewriting their patch geometry.
Inputs: path (required), workspaceId (required), limit. Returns: gradients, truncated
metadata_manageBDestructive
Updates SVG document metadata or element accessibility with bounded plain text and no arbitrary RDF/XML.
Returns: ids, action, revision, backupCreated
objects_to_pathsBDestructive
Irreversibly converts selected basic vector objects or their strokes to SVG paths through Inkscape in a staged copy. The caller must confirm the destructive conversion.
Inputs: ids (required), mode (required), path (required), workspaceId (required), +2 more. Returns: diff, mode, warning, revision, +2 more
palette_applyADestructive
Replaces explicitly mapped local hex paints in attributes, typed inline fill/stroke/stop-color styles, and local CSS variable values without reading global Inkscape palettes.
Inputs: path (required), workspaceId (required), replacements (required), expectedRevision (required). Returns: revision, replacements, backupCreated
palette_inspectBRead-only
Lists direct local hex colors in attributes or typed inline paint styles, plus local CSS variable values, without reading global Inkscape palettes.
Inputs: path (required), workspaceId (required), limit. Returns: colors, swatches, truncated, cssVariables
path_break_apartCDestructive
Splits a compound SVG path into explicit, caller-supplied IDs. Existing references to the source ID are rejected before mutation.
Inputs: id (required), path (required), newIds (required), workspaceId (required), +1 more. Returns: ids, revision, backupCreated
path_effects_inspectBRead-only
Lists preserved local Inkscape path effects and their local path references without editing effect parameters.
Inputs: path (required), workspaceId (required). Returns: effects
path_effects_manageBDestructive
Detaches explicit local paths from an Inkscape Live Path Effect or deletes an already unreferenced local effect. It never edits effect parameters or invokes GUI-dependent LPE rendering.
Inputs: path (required), action (required), effectId (required), workspaceId (required), +2 more. Returns: action, effectId, revision, backupCreated, +1 more
path_modifyBDestructive
Irreversibly simplifies one SVG path through the verified native action in a staged copy. Legacy inset, outset, and offset requests return a recoverable unavailable-capability error on the current baseline.
Inputs: id (required), path (required), operation (required), workspaceId (required), +2 more. Returns: id, diff, renamed, warning, +3 more
path_node_editCDestructive
Edits explicit absolute linear path nodes or opens/closes a subpath by segment index without accepting raw SVG path data.
Inputs: id (required), path (required), operation (required), workspaceId (required), +1 more. Returns: id, revision, backupCreated
path_node_moveCDestructive
Moves one path endpoint by zero-based segment index without accepting raw SVG path data; relative commands are normalized to equivalent absolute SVG.
Inputs: id (required), path (required), index (required), point (required), +2 more. Returns: id, revision, backupCreated
path_reverseADestructive
Reverses line-only SVG path subpaths while retaining the path ID and presentation. Curves and arcs are rejected until their exact reversal is available.
Inputs: id (required), path (required), workspaceId (required), expectedRevision (required). Returns: id, revision, backupCreated
paths_booleanADestructive
Runs an allowlisted native boolean, division, or cut operation on exactly two safe SVG path IDs in a staged copy, then atomically publishes the sanitized result. For difference, division, and cut, ids[0] is the target and ids[1] is the cutter.
Inputs: ids (required), path (required), operation (required), workspaceId (required), +1 more. Returns: diff, renamed, revision, operation, +1 more
paths_combineBDestructive
Combines same-parent SVG paths only when their presentation attributes match exactly and removed IDs have no live SVG references.
Inputs: ids (required), path (required), workspaceId (required), expectedRevision (required). Returns: id, revision, removedIds, backupCreated
paths_flattenADestructive
Irreversibly flattens two to 100 explicitly selected overlapping SVG paths through the verified native Inkscape action in a staged copy.
Inputs: ids (required), path (required), workspaceId (required), expectedRevision (required), +1 more. Returns: ids, diff, renamed, warning, +2 more
patterns_manageBDestructive
Creates, replaces, applies or deletes typed SVG dots/stripes patterns in defs without accepting free XML or CSS.
Returns: id, action, revision, targetIds, +1 more
resources_inspect_remoteBRead-only
Reports remote SVG resources without downloading them, with remediation to replace them using workspace-local linked or embedded image operations.
Inputs: path (required), workspaceId (required). Returns: resources, remediation
symbols_manageBDestructive
Lists, creates or deletes reusable SVG symbols and creates positioned local use clones. Existing cyclic or missing use references are rejected.
Returns: id, action, symbols, revision, +1 more
text_manageADestructive
Edits local SVG text through bounded plain-text segments or explicit multiline tspans, preserving existing structure only when requested.
Returns: id, mode, revision, backupCreated
text_path_manageADestructive
Attaches text (including tspans) to a local SVG path or detaches it without accepting markup.
Returns: action, textId, revision, backupCreated
text_to_pathsADestructive
Irreversibly converts explicit SVG text element IDs to paths through Inkscape in a staged copy. The caller must confirm the destructive conversion.
Inputs: ids (required), path (required), workspaceId (required), expectedRevision (required), +1 more. Returns: diff, warning, revision, convertedIds, +1 more
workspace_listBRead-only
Lists authorized workspaces by opaque ID without exposing their filesystem roots.
Inputs: no named parameters. Returns: workspaces
workspace_list_documentsARead-only
Lists allowed SVG/SVGZ document paths within one workspace using an opaque cursor.
Inputs: workspaceId (required), cursor, pageSize. Returns: documents, nextCursor
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 90 tools
Many tools target distinct SVG/Inkscape operations, but there are several overlapping clusters: document_import_svg vs document_import vs format-specific imports, document_export vs export_png/pdf/svg, and numerous *_manage / *_inspect pairs. Descriptions add detail, but an agent still faces dozens of similarly named tools and must carefully disambiguate them.
Mostly snake_case, but the ordering convention is mixed: many tools use resource_action (elements_create, document_import), while others use verb_noun (export_png, path_modify, text_to_paths), and some lack a resource prefix (inkscape_status, job_get). This inconsistent verb and prefix style makes the large set harder to scan.
90 tools is an extreme mismatch for a typical MCP server, far exceeding the 3-15 range. Many tools are narrow variants or overlapping capabilities, creating severe surface bloat and high cognitive load.
The surface appears exceptionally comprehensive for SVG/Inkscape editing: it covers document lifecycle, elements, paths, text, effects, import/export, jobs, accessibility, metadata, and more. Core CRUD and advanced operations are broadly represented with few obvious dead ends.
Maintenance
Related MCP Connectors
Generate and vectorize clean, editable SVG graphics from text, images, or both.
Vectorize images to SVG, PDF, EPS or DXF, and check a DXF before cutting.
Render HTML, Markdown, or URLs to images, PDF, or branded artifacts; extract and watch pages.
Generate PDFs and images from HTML, Markdown, URLs or JSON templates.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables creation, validation, rendering, and optimization of SVG images with conversion capabilities to PNG, React components, React Native components, and Data URIs.ISC
- AlicenseAqualityBmaintenanceEnables AI agents to inspect, edit, validate, render, and export SVG/Inkscape documents safely with reversible operations and risk-classed tools.8711MIT
- AlicenseNot gradedqualityDmaintenanceEnables AI agents to create, inspect, validate, and export SVG designs using Inkscape CLI through MCP tools.2Apache 2.0
- AlicenseBqualityBmaintenanceEnables driving Inkscape headlessly from an MCP client, with verified SVG editing, rendering, optimization, and animation tools.23MIT