inkscape-mcp

by Berrio

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

export_pdf

Exports an SVG document to a validated PDF through Inkscape using bounded, allowlisted options and revision checks.

Instructions

Exports an SVG document to a validated PDF through Inkscape using bounded, allowlisted options.

Input Schema

Name	Required	Default
`path`	Yes
`latex`	No
`margin`	No
`filters`	No	preserve
`pageIds`	No
`filterDpi`	No
`outputPath`	Yes
`pdfVersion`	No
`textToPath`	No
`workspaceId`	Yes
`expectedRevision`	Yes
`expectedOutputRevision`	No
`expectedLatexOutputRevision`	No

Output Schema

Name	Required	Description	Default
`hash`	Yes
`pageIds`	No
`version`	Yes
`revision`	Yes
`strategy`	Yes
`warnings`	Yes
`cropBoxes`	Yes
`pageCount`	Yes
`byteLength`	Yes
`mediaBoxes`	Yes
`latexSidecar`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed19 schema fields changedv0.1.0Oct 14, 2026

addedInput schema / additionalProperties
```
Added value: +false
```

addedInput schema / properties / expectedLatexOutputRevision

Added value: +{
+  "pattern": "^[a-f0-9]{64}$",
+  "type": "string"
+}

addedInput schema / properties / filterDpi

Added value: +{
+  "exclusiveMinimum": 0,
+  "maximum": 10000,
+  "type": "number"
+}

addedInput schema / properties / filters

Added value: +{
+  "default": "preserve",
+  "enum": [
+    "ignore",
+    "preserve"
+  ],
+  "type": "string"
+}

addedInput schema / properties / latex

Added value: +{
+  "default": false,
+  "type": "boolean"
+}

addedInput schema / properties / margin

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "bottom": {
+      "additionalProperties": false,
+      "properties": {
+        "unit": {
+          "enum": [
+            "mm",
+            "cm",
+            "in",
+            "pt",
+            "pc",
+            "q"
+          ],
+          "type": "string"
+        },
+        "value": {
+          "minimum": 0,
+          "type": "number"
+        }
+      },
+      "required": [
+        "unit",
+        "value"
+      ],
+      "type": "object"
+    },
+    "left": {
+      "additionalProperties": false,
+      "properties": {
+        "unit": {
+          "enum": [
+            "mm",
+            "cm",
+            "in",
+            "pt",
+            "pc",
+            "q"
+          ],
+          "type": "string"
+        },
+        "value": {
+          "minimum": 0,
+          "type": "number"
+        }
+      },
+      "required": [
+        "unit",
+        "value"
+      ],
+      "type": "object"
+    },
+    "right": {
+      "additionalProperties": false,
+      "properties": {
+        "unit": {
+          "enum": [
+            "mm",
+            "cm",
+            "in",
+            "pt",
+            "pc",
+            "q"
+          ],
+          "type": "string"
+        },
+        "value": {
+          "minimum": 0,
+          "type": "number"
+        }
+      },
+      "required": [
+        "unit",
+        "value"
+      ],
+      "type": "object"
+    },
+    "top": {
+      "additionalProperties": false,
+      "properties": {
+        "unit": {
+          "enum": [
+            "mm",
+            "cm",
+            "in",
+            "pt",
+            "pc",
+            "q"
+          ],
+          "type": "string"
+        },
+        "value": {
+          "minimum": 0,
+          "type": "number"
+        }
+      },
+      "required": [
+        "unit",
+        "value"
+      ],
+      "type": "object"
+    }
+  },
+  "required": [
+    "bottom",
+    "left",
+    "right",
+    "top"
+  ],
+  "type": "object"
+}

addedInput schema / properties / pageIds

Added value: +{
+  "items": {
+    "pattern": "^[A-Za-z_][A-Za-z0-9_.-]{0,127}$",
+    "type": "string"
+  },
+  "maxItems": 100,
+  "minItems": 1,
+  "type": "array"
+}

addedInput schema / properties / textToPath

Added value: +{
+  "default": false,
+  "type": "boolean"
+}

addedOutput schema / properties / byteLength

Added value: +{
+  "exclusiveMinimum": 0,
+  "maximum": 9007199254740991,
+  "type": "integer"
+}

addedOutput schema / properties / cropBoxes

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "height": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "width": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "x": {
+        "type": "number"
+      },
+      "y": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "height",
+      "width",
+      "x",
+      "y"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / hash

Added value: +{
+  "pattern": "^[a-f0-9]{64}$",
+  "type": "string"
+}

addedOutput schema / properties / latexSidecar

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "path": {
+      "maxLength": 1028,
+      "minLength": 1,
+      "type": "string"
+    },
+    "revision": {
+      "pattern": "^[a-f0-9]{64}$",
+      "type": "string"
+    }
+  },
+  "required": [
+    "path",
+    "revision"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / mediaBoxes / items / properties / x
```
Added value: +{
+  "type": "number"
+}
```
addedOutput schema / properties / mediaBoxes / items / properties / y
```
Added value: +{
+  "type": "number"
+}
```

changedOutput schema / properties / mediaBoxes / items / required

Previous value: -[
-  "height",
-  "width"
-]New value: +[
+  "height",
+  "width",
+  "x",
+  "y"
+]

addedOutput schema / properties / pageIds

Added value: +{
+  "items": {
+    "pattern": "^[A-Za-z_][A-Za-z0-9_.-]{0,127}$",
+    "type": "string"
+  },
+  "type": "array"
+}

addedOutput schema / properties / strategy

Added value: +{
+  "enum": [
+    "full_document",
+    "prune_subset"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / warnings

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

changedOutput schema / required

Previous value: -[
-  "mediaBoxes",
-  "pageCount",
-  "revision",
-  "version"
-]New value: +[
+  "byteLength",
+  "cropBoxes",
+  "hash",
+  "mediaBoxes",
+  "pageCount",
+  "revision",
+  "strategy",
+  "version",
+  "warnings"
+]

First observedv0.0.0Aug 26, 2026

TDQS

C2.9/5.0

Behavior3/5

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

Only destructiveHint=false is annotated, so the description carries most of the burden. It usefully discloses that rendering goes through Inkscape and that options are bounded/allowlisted, which implies unsupported settings are rejected. It omits the concurrency contract implied by expectedRevision/expectedOutputRevision, overwrite behavior on outputPath, and the LaTeX side output, which are the riskiest behaviors here.

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

Conciseness4/5

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

A single front-loaded sentence with no filler or repetition. It is tight, but the brevity costs information for a 13-parameter tool rather than being genuinely economical.

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

Completeness2/5

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

An output schema exists, so return values need no explanation, but for a high-complexity tool with nested objects, enums, and revision-based optimistic concurrency, the description omits parameter meaning, usage conditions, and side effects. An agent cannot safely call this from the definition alone.

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

Parameters2/5

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

Schema description coverage is 0% across 13 parameters, including a nested margin object and three hash-shaped revision parameters, so the description is the only place meaning could be added. Instead it says nothing about any parameter — not what pageIds, filters, filterDpi, textToPath, or the expected*Revision fields do or when they are required.

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

Purpose4/5

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

States a specific verb and resource chain — exports an SVG document to a PDF via Inkscape. An agent knows what the tool produces. However it never distinguishes itself from the sibling export_pdf_pages, export_svg, or the generic document_export, so the reader must infer the boundary from the schema.

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

Usage Guidelines2/5

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

There is no when-to-use guidance, no prerequisites, and no mention of alternatives such as export_pdf_pages for subset exports or document_export for other formats. The scoping word 'validated' hints at preflight but is never explained as a condition for calling this tool.

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

Deploy Server