Skip to main content
Glama
inkscape-mcp
by Berrio

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 --doctor with capability evidence.

  • Authorized workspaces with safe relative paths, SHA-256 revisions, locks, backups, and atomic commits.

  • Create, inspect, and resize SVG documents with page_only semantics, 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\disenos

The 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

inkscape_status

Status, capabilities, and security posture.

workspace_list, workspace_list_documents

Available workspaces and allowed SVG/SVGZ.

document_create, document_inspect, document_resize

Create and manage viewport, units, viewBox, pages, anchors, contain/cover/stretch, revision, and SVG inventory.

document_pages

List or mutate explicit Inkscape 1.4 pages.

document_settings

Read or edit page background, desktop, and border.

document_preflight

Detect active content, external resources, and errors with basic/web/print/interchange profiles.

elements_update

Update geometry, basic style, text, or layer label via typed patches.

elements_arrange

Change sibling Z-order: front/back/raise/lower, without arbitrary XML indices or ordering.

elements_group

Group siblings or ungroup an SVG group without breaking external href references.

elements_query

Query bounded summaries by ID, type, or layer, with pagination and missingIds.

elements_create

Create typed shapes, text, groups, and layers; supports parentId within the batch.

elements_delete

Delete selected IDs without leaving broken fragment references.

elements_transform

Transform elements with typed translate, scale, rotate, skew, flip, or matrix.

export_png, export_pdf, export_svg

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 tools
accessibility_inspectB
Read-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_chunkB
Read-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_manageA
Destructive

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_inspectA
Read-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_createC
Destructive

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_retargetA
Destructive

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_routeB
Destructive

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_vacuumB
Destructive

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_operationsB
Destructive

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_planA
Read-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_pageB
Destructive

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_capabilitiesA
Read-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_inspectB
Read-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_idsB
Destructive

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_adjustC
Destructive

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_pagesB
Destructive

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_validateB
Read-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_preflightB
Read-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_resizeB
Destructive

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_restoreB
Destructive

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_settingsA
Destructive

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_alignB
Destructive

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_arrangeA
Destructive

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_createC
Destructive

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_deleteB
Destructive

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_distributeB
Destructive

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_duplicateB
Destructive

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_transformA
Destructive

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_groupA
Destructive

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_queryC
Read-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_overlapsA
Destructive

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_reparentB
Destructive

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_transformB
Destructive

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_updateC
Destructive

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_manageB
Destructive

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_convertA
Destructive

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_inspectA
Read-only

Lists Inkscape flowed-text roots and paragraph counts without interpreting their layout.

Inputs: path (required), workspaceId (required). Returns: flowedTexts

fonts_listB
Read-only

Lists a bounded cache of local system font family names without exposing font file paths.

Inputs: refresh. Returns: cached, source, families, familyCount

fonts_preflightA
Read-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_manageB
Destructive

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_manageB
Destructive

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_cropC
Destructive

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_dpiB
Read-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_manageB
Destructive

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_traceA
Destructive

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_statusA
Read-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_getB
Read-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_manageB
Destructive

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_manageA
Destructive

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_inspectB
Read-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_manageB
Destructive

Updates SVG document metadata or element accessibility with bounded plain text and no arbitrary RDF/XML.

Returns: ids, action, revision, backupCreated

objects_to_pathsB
Destructive

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_applyA
Destructive

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_inspectB
Read-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_apartC
Destructive

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_inspectB
Read-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_manageB
Destructive

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_modifyB
Destructive

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_editC
Destructive

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_moveC
Destructive

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_reverseA
Destructive

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_booleanA
Destructive

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_combineB
Destructive

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_flattenA
Destructive

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_manageB
Destructive

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_remoteB
Read-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_manageB
Destructive

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_manageA
Destructive

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_manageA
Destructive

Attaches text (including tspans) to a local SVG path or detaches it without accepting markup.

Returns: action, textId, revision, backupCreated

text_to_pathsA
Destructive

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_listB
Read-only

Lists authorized workspaces by opaque ID without exposing their filesystem roots.

Inputs: no named parameters. Returns: workspaces

workspace_list_documentsA
Read-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

    C2.8/5.0

    Scored across 90 tools

    Disambiguation2/5

    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.

    Naming Consistency2/5

    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.

    Tool Count1/5

    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.

    Completeness5/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers