inkscape-mcp

Overview Schema Source Related Servers Discussions Admin

elements_transform

Destructive

Append allowlisted numeric SVG transforms to selected elements and re-route attached semantic connectors when moved endpoints change.

Instructions

Appends an allowlisted numeric SVG transform to selected elements without accepting transform strings, then re-routes compatible semantic connectors attached to moved endpoints.

Input Schema

Name	Required	Description	Default
`ids`	Yes
`path`	Yes
`transform`	Yes
`workspaceId`	Yes
`expectedRevision`	Yes

Output Schema

Name	Required	Description	Default
`ids`	Yes
`revision`	Yes
`backupCreated`	Yes
`reroutedConnectorIds`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed4 schema fields changedv0.1.0Oct 14, 2026

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

changedInput schema / properties / transform / oneOf

Previous value: -[
-  {
-    "properties": {
-      "kind": {
-        "const": "translate",
-        "type": "string"
-      },
-      "x": {
-        "type": "number"
-      },
-      "y": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "kind",
-      "x",
-      "y"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "kind": {
-        "const": "scale",
-        "type": "string"
-      },
-      "x": {
-        "type": "number"
-      },
-      "y": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "kind",
-      "x"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "angle": {
-        "type": "number"
-      },
-      "cx": {
-        "type": "number"
-      },
-      "cy": {
-        "type": "number"
-      },
-      "kind": {
-        "const": "rotate",
-        "type": "string"
-      }
-    },
-    "required": [
-      "angle",
-      "kind"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "angle": {
-        "type": "number"
-      },
-      "kind": {
-        "const": "skew_x",
-        "type": "string"
-      }
-    },
-    "required": [
-      "angle",
-      "kind"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "angle": {
-        "type": "number"
-      },
-      "kind": {
-        "const": "skew_y",
-        "type": "string"
-      }
-    },
-    "required": [
-      "angle",
-      "kind"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "kind": {
-        "const": "flip_x",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "kind": {
-        "const": "flip_y",
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "a": {
-        "type": "number"
-      },
-      "b": {
-        "type": "number"
-      },
-      "c": {
-        "type": "number"
-      },
-      "d": {
-        "type": "number"
-      },
-      "e": {
-        "type": "number"
-      },
-      "f": {
-        "type": "number"
-      },
-      "kind": {
-        "const": "matrix",
-        "type": "string"
-      }
-    },
-    "required": [
-      "a",
-      "b",
-      "c",
-      "d",
-      "e",
-      "f",
-      "kind"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "kind": {
+        "const": "translate",
+        "type": "string"
+      },
+      "x": {
+        "type": "number"
+      },
+      "y": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "kind",
+      "x",
+      "y"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "kind": {
+        "const": "scale",
+        "type": "string"
+      },
+      "x": {
+        "type": "number"
+      },
+      "y": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "kind",
+      "x"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "angle": {
+        "type": "number"
+      },
+      "cx": {
+        "type": "number"
+      },
+      "cy": {
+        "type": "number"
+      },
+      "kind": {
+        "const": "rotate",
+        "type": "string"
+      }
+    },
+    "required": [
+      "angle",
+      "kind"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "angle": {
+        "type": "number"
+      },
+      "kind": {
+        "const": "skew_x",
+        "type": "string"
+      }
+    },
+    "required": [
+      "angle",
+      "kind"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "angle": {
+        "type": "number"
+      },
+      "kind": {
+        "const": "skew_y",
+        "type": "string"
+      }
+    },
+    "required": [
+      "angle",
+      "kind"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "kind": {
+        "const": "flip_x",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "kind": {
+        "const": "flip_y",
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "a": {
+        "type": "number"
+      },
+      "b": {
+        "type": "number"
+      },
+      "c": {
+        "type": "number"
+      },
+      "d": {
+        "type": "number"
+      },
+      "e": {
+        "type": "number"
+      },
+      "f": {
+        "type": "number"
+      },
+      "kind": {
+        "const": "matrix",
+        "type": "string"
+      }
+    },
+    "required": [
+      "a",
+      "b",
+      "c",
+      "d",
+      "e",
+      "f",
+      "kind"
+    ],
+    "type": "object"
+  }
+]

addedOutput schema / properties / reroutedConnectorIds

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

changedOutput schema / required

Previous value: -[
-  "backupCreated",
-  "ids",
-  "revision"
-]New value: +[
+  "backupCreated",
+  "ids",
+  "reroutedConnectorIds",
+  "revision"
+]

First observedv0.0.0Aug 26, 2026

TDQS

B3.4/5.0

Behavior4/5

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

Annotations supply only destructiveHint=true, so the description adds real value: it discloses that the transform is appended (not replaced), that inputs are an allowlist of numeric kinds, that a side effect re-routes compatible semantic connectors on moved endpoints, and that string transforms are rejected. It does not cover permissions, reversibility, or the revision-conflict behavior.

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; the constraint and the side effect each earn their place. Slightly dense for one sentence but not padded.

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

Completeness3/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, and the mutation's main behavior plus connector side effect are stated. However a destructive multi-element mutation with a revision token and 5 undocumented parameters should say more about preconditions, concurrency failure, and scope limits.

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% for 5 required parameters. The description clarifies the transform parameter's shape (allowlisted numeric kinds, no strings) but says nothing about ids, path, workspaceId, or expectedRevision -- including that expectedRevision is presumably an optimistic-concurrency guard and ids is capped in the schema.

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: append an allowlisted numeric SVG transform to selected elements. It implicitly distinguishes itself from elements_flatten_transform, elements_update and connector_route by naming the connector re-routing side effect, but never names a sibling explicitly.

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

Usage Guidelines3/5

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

Usage is only implied -- the phrase 'without accepting transform strings' hints that callers must supply the structured transform object rather than raw SVG, and connector re-routing signals a move use case. No when-to-use vs. alternatives (e.g. elements_flatten_transform, elements_arrange) and no stated preconditions such as revision freshness.

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

Deploy Server