mcp-cinema4d

Set Object Transform

set_transform

Write a Cinema 4D object's transform in local or global space by patching position, rotation, or scale, or replacing the full 4x3 matrix.

Instructions

Write an object's transform in local or global space. Pass any combination of pos/rot (HPB radians)/scale to patch individual components — unspecified parts keep their current value. Or pass a full 4x3 matrix (rows: offset, v1, v2, v3) to replace the whole transform; matrix is mutually exclusive with the decomposed fields. Space defaults to 'local' (SetMl). Use 'global' (SetMg) to write world coordinates through a parent.

Input Schema

TableJSON Schema

Name	Required	Description
`pos`	No	[x, y, z].
`rot`	No	[heading, pitch, bank] in radians.
`scale`	No	[sx, sy, sz].
`space`	No	Default 'local'.
`handle`	Yes	Target object.
`matrix`	No	4x3 matrix as [offset, v1, v2, v3]. Exclusive with pos/rot/scale.

Schema Changelog

Changes observed during successful MCP inspections.

Changed15 schema fields changedv0.5.1Oct 2, 2026

removedInput schema / definitions

Removed value: -{
-  "__schema0": {
-    "anyOf": [
-      {
-        "properties": {
-          "kind": {
-            "const": "object",
-            "type": "string"
-          },
-          "name": {
-            "type": "string"
-          },
-          "path": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "kind"
-        ],
-        "type": "object"
-      },
-      {
-        "properties": {
-          "kind": {
-            "const": "render_data",
-            "type": "string"
-          },
-          "name": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "kind",
-          "name"
-        ],
-        "type": "object"
-      },
-      {
-        "properties": {
-          "kind": {
-            "const": "take",
-            "type": "string"
-          },
-          "name": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "kind",
-          "name"
-        ],
-        "type": "object"
-      },
-      {
-        "properties": {
-          "kind": {
-            "const": "material",
-            "type": "string"
-          },
-          "name": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "kind",
-          "name"
-        ],
-        "type": "object"
-      },
-      {
-        "properties": {
-          "kind": {
-            "const": "layer",
-            "type": "string"
-          },
-          "name": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "kind",
-          "name"
-        ],
-        "type": "object"
-      },
-      {
-        "properties": {
-          "kind": {
-            "const": "tag",
-            "type": "string"
-          },
-          "object": {
-            "type": "string"
-          },
-          "object_path": {
-            "type": "string"
-          },
-          "tag_name": {
-            "type": "string"
-          },
-          "type_id": {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          }
-        },
-        "required": [
-          "kind"
-        ],
-        "type": "object"
-      },
-      {
-        "properties": {
-          "kind": {
-            "const": "video_post",
-            "type": "string"
-          },
-          "render_data": {
-            "type": "string"
-          },
-          "type_id": {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          }
-        },
-        "required": [
-          "kind",
-          "render_data",
-          "type_id"
-        ],
-        "type": "object"
-      },
-      {
-        "properties": {
-          "index": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "kind": {
-            "const": "shader",
-            "type": "string"
-          },
-          "name": {
-            "type": "string"
-          },
-          "owner": {
-            "allOf": [
-              {
-                "$ref": "#/definitions/__schema0"
-              }
-            ]
-          }
-        },
-        "required": [
-          "kind",
-          "owner"
-        ],
-        "type": "object"
-      },
-      {
-        "properties": {
-          "id": {
-            "type": "string"
-          },
-          "kind": {
-            "const": "gv_node",
-            "type": "string"
-          },
-          "name": {
-            "type": "string"
-          },
-          "tag": {
-            "allOf": [
-              {
-                "$ref": "#/definitions/__schema0"
-              }
-            ]
-          }
-        },
-        "required": [
-          "kind",
-          "tag"
-        ],
-        "type": "object"
-      },
-      {
-        "properties": {
-          "kind": {
-            "const": "plugin_options",
-            "type": "string"
-          },
-          "plugin_id": {
-            "anyOf": [
-              {
-                "maximum": 9007199254740991,
-                "minimum": -9007199254740991,
-                "type": "integer"
-              },
-              {
-                "type": "string"
-              }
-            ]
-          },
-          "plugin_type": {
-            "enum": [
-              "command",
-              "object",
-              "tag",
-              "material",
-              "shader",
-              "video_post",
-              "scene_loader",
-              "scene_saver",
-              "bitmap_loader",
-              "bitmap_saver",
-              "tool",
-              "preference",
-              "node",
-              "sculpt_brush"
-            ],
-            "type": "string"
-          }
-        },
-        "required": [
-          "kind",
-          "plugin_id"
-        ],
-        "type": "object"
-      }
-    ]
-  }
-}

removedInput schema / properties / handle / allOf

Removed value: -[
-  {
-    "$ref": "#/definitions/__schema0"
-  }
-]

addedInput schema / properties / handle / anyOf

Added value: +[
+  {
+    "properties": {
+      "kind": {
+        "const": "object",
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
+      "path": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "render_data",
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "take",
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "material",
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "layer",
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "tag",
+        "type": "string"
+      },
+      "object": {
+        "type": "string"
+      },
+      "object_path": {
+        "type": "string"
+      },
+      "tag_name": {
+        "type": "string"
+      },
+      "type_id": {
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "kind"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "video_post",
+        "type": "string"
+      },
+      "render_data": {
+        "type": "string"
+      },
+      "type_id": {
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "kind",
+      "render_data",
+      "type_id"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "plugin_options",
+        "type": "string"
+      },
+      "plugin_id": {
+        "anyOf": [
+          {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          {
+            "type": "string"
+          }
+        ]
+      },
+      "plugin_type": {
+        "enum": [
+          "command",
+          "object",
+          "tag",
+          "material",
+          "shader",
+          "video_post",
+          "scene_loader",
+          "scene_saver",
+          "bitmap_loader",
+          "bitmap_saver",
+          "tool",
+          "preference",
+          "node",
+          "sculpt_brush"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "plugin_id"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "index": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "kind": {
+        "const": "shader",
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
+      "owner": {
+        "additionalProperties": {},
+        "description": "Handle of the shader's owner (material, object, tag, video_post, or shader).",
+        "properties": {
+          "kind": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "kind"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "kind",
+      "owner"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "id": {
+        "type": "string"
+      },
+      "kind": {
+        "const": "gv_node",
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
+      "tag": {
+        "properties": {
+          "kind": {
+            "const": "tag",
+            "type": "string"
+          },
+          "object": {
+            "type": "string"
+          },
+          "object_path": {
+            "type": "string"
+          },
+          "tag_name": {
+            "type": "string"
+          },
+          "type_id": {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "kind"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "kind",
+      "tag"
+    ],
+    "type": "object"
+  }
+]

changedInput schema / properties / matrix / items / items

Previous value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "number"
-  },
-  {
-    "type": "number"
-  }
-]New value: +{
+  "type": "number"
+}

addedInput schema / properties / matrix / items / maxItems
```
Added value: +3
```
addedInput schema / properties / matrix / items / minItems
```
Added value: +3
```

changedInput schema / properties / pos / items

Previous value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "number"
-  },
-  {
-    "type": "number"
-  }
-]New value: +{
+  "type": "number"
+}

addedInput schema / properties / pos / maxItems
```
Added value: +3
```
addedInput schema / properties / pos / minItems
```
Added value: +3
```

changedInput schema / properties / rot / items

Previous value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "number"
-  },
-  {
-    "type": "number"
-  }
-]New value: +{
+  "type": "number"
+}

addedInput schema / properties / rot / maxItems
```
Added value: +3
```
addedInput schema / properties / rot / minItems
```
Added value: +3
```

changedInput schema / properties / scale / items

Previous value: -[
-  {
-    "type": "number"
-  },
-  {
-    "type": "number"
-  },
-  {
-    "type": "number"
-  }
-]New value: +{
+  "type": "number"
+}

addedInput schema / properties / scale / maxItems
```
Added value: +3
```
addedInput schema / properties / scale / minItems
```
Added value: +3
```

Changed1 schema field changedv0.4.3Aug 21, 2026

changedInput schema / definitions / __schema0 / anyOf

Previous value: -[
-  {
-    "properties": {
-      "kind": {
-        "const": "object",
-        "type": "string"
-      },
-      "name": {
-        "type": "string"
-      },
-      "path": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "kind": {
-        "const": "render_data",
-        "type": "string"
-      },
-      "name": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "kind": {
-        "const": "take",
-        "type": "string"
-      },
-      "name": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "kind": {
-        "const": "material",
-        "type": "string"
-      },
-      "name": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "name"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "kind": {
-        "const": "tag",
-        "type": "string"
-      },
-      "object": {
-        "type": "string"
-      },
-      "object_path": {
-        "type": "string"
-      },
-      "tag_name": {
-        "type": "string"
-      },
-      "type_id": {
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "kind"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "kind": {
-        "const": "video_post",
-        "type": "string"
-      },
-      "render_data": {
-        "type": "string"
-      },
-      "type_id": {
-        "maximum": 9007199254740991,
-        "minimum": -9007199254740991,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "kind",
-      "render_data",
-      "type_id"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "index": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "kind": {
-        "const": "shader",
-        "type": "string"
-      },
-      "name": {
-        "type": "string"
-      },
-      "owner": {
-        "allOf": [
-          {
-            "$ref": "#/definitions/__schema0"
-          }
-        ]
-      }
-    },
-    "required": [
-      "kind",
-      "owner"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "id": {
-        "type": "string"
-      },
-      "kind": {
-        "const": "gv_node",
-        "type": "string"
-      },
-      "name": {
-        "type": "string"
-      },
-      "tag": {
-        "allOf": [
-          {
-            "$ref": "#/definitions/__schema0"
-          }
-        ]
-      }
-    },
-    "required": [
-      "kind",
-      "tag"
-    ],
-    "type": "object"
-  },
-  {
-    "properties": {
-      "kind": {
-        "const": "plugin_options",
-        "type": "string"
-      },
-      "plugin_id": {
-        "anyOf": [
-          {
-            "maximum": 9007199254740991,
-            "minimum": -9007199254740991,
-            "type": "integer"
-          },
-          {
-            "type": "string"
-          }
-        ]
-      },
-      "plugin_type": {
-        "enum": [
-          "command",
-          "object",
-          "tag",
-          "material",
-          "shader",
-          "video_post",
-          "scene_loader",
-          "scene_saver",
-          "bitmap_loader",
-          "bitmap_saver",
-          "tool",
-          "preference",
-          "node",
-          "sculpt_brush"
-        ],
-        "type": "string"
-      }
-    },
-    "required": [
-      "kind",
-      "plugin_id"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "properties": {
+      "kind": {
+        "const": "object",
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
+      "path": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "render_data",
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "take",
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "material",
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "layer",
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "name"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "tag",
+        "type": "string"
+      },
+      "object": {
+        "type": "string"
+      },
+      "object_path": {
+        "type": "string"
+      },
+      "tag_name": {
+        "type": "string"
+      },
+      "type_id": {
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "kind"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "video_post",
+        "type": "string"
+      },
+      "render_data": {
+        "type": "string"
+      },
+      "type_id": {
+        "maximum": 9007199254740991,
+        "minimum": -9007199254740991,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "kind",
+      "render_data",
+      "type_id"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "index": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "kind": {
+        "const": "shader",
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
+      "owner": {
+        "allOf": [
+          {
+            "$ref": "#/definitions/__schema0"
+          }
+        ]
+      }
+    },
+    "required": [
+      "kind",
+      "owner"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "id": {
+        "type": "string"
+      },
+      "kind": {
+        "const": "gv_node",
+        "type": "string"
+      },
+      "name": {
+        "type": "string"
+      },
+      "tag": {
+        "allOf": [
+          {
+            "$ref": "#/definitions/__schema0"
+          }
+        ]
+      }
+    },
+    "required": [
+      "kind",
+      "tag"
+    ],
+    "type": "object"
+  },
+  {
+    "properties": {
+      "kind": {
+        "const": "plugin_options",
+        "type": "string"
+      },
+      "plugin_id": {
+        "anyOf": [
+          {
+            "maximum": 9007199254740991,
+            "minimum": -9007199254740991,
+            "type": "integer"
+          },
+          {
+            "type": "string"
+          }
+        ]
+      },
+      "plugin_type": {
+        "enum": [
+          "command",
+          "object",
+          "tag",
+          "material",
+          "shader",
+          "video_post",
+          "scene_loader",
+          "scene_saver",
+          "bitmap_loader",
+          "bitmap_saver",
+          "tool",
+          "preference",
+          "node",
+          "sculpt_brush"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "kind",
+      "plugin_id"
+    ],
+    "type": "object"
+  }
+]

First observedv0.3.1Jul 28, 2026

TDQS

A4/5.0

Behavior4/5

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

With no annotations, the description carries the full burden and does well: it discloses patch-vs-replace semantics ('unspecified parts keep their current value'), matrix mutual exclusivity, and the default space. It omits operational context such as undoability or permission requirements, but the mutation semantics are unusually well covered.

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?

Three dense, front-loaded sentences with no filler; the patch-vs-matrix distinction is stated early. The matrix clause is packed but every element earns its place.

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

Completeness4/5

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

For a 6-param mutation tool with no annotations and no output schema, the description covers the key behavioral question (patch vs replace, space default) adequately. Handle types and undo behavior are left to the schema/absent context, a minor gap.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3, but the description adds real meaning beyond the terse schema entries: rot is HPB radians, matrix rows are [offset, v1, v2, v3], matrix is mutually exclusive with pos/rot/scale, and space defaults to 'local'.

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?

The description states a specific verb and resource: 'Write an object's transform in local or global space.' It is unambiguous about the operation and its scope, though it never names a sibling (e.g. sample_transform or move_entity) to differentiate itself explicitly.

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

Usage Guidelines4/5

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

It clearly explains the two invocation modes and when to use each: decomposed fields to patch (unspecified parts preserved) vs a full matrix to replace. It stops short of naming alternative tools for related tasks, so no explicit when-not/alternatives guidance.

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

Deploy Server

Set Object Transform

Instructions

Input Schema

Schema Changelog

TDQS

Other Tools