Skip to main content
Glama

VoxelDraft – AI Voxel Modeling

by io.github.huruki-geo
OverviewDiscussionsAdmin

Edit voxel model

edit_voxel_model

Edit the temporary model identified by modelRef and return a new modelRef. This does not modify a saved cloud project. Use VoxelDraft's compact instruction stream instead of emitting one JSON object per voxel. Coordinates are integers 0..63. Colors are either #RRGGBB or a zero-based palette index. Commands: ["box",x1,y1,z1,x2,y2,z2,color,hollow?] ["ellipsoid",cx,cy,cz,rx,ry,rz,color,hollow?] ["cylinder","x"|"y"|"z",x,y,z,radius,height,color,hollow?] ["line",x1,y1,z1,x2,y2,z2,color] ["roof","x"|"z",x1,y1,z1,x2,y2,z2,color] (gable roof, axis is ridge direction) ["runs","x"|"y"|"z",color,[[x,y,z,length],...]] (preferred exact/freeform representation) ["points",color,[[x,y,z],...]] (sparse details only) ["erase",x1,y1,z1,x2,y2,z2] ["recolor",fromColor,toColor] ["copy",x1,y1,z1,x2,y2,z2,dx,dy,dz] ["repeat",x1,y1,z1,x2,y2,z2,dx,dy,dz,count] ["mirror","x"|"y"|"z",plane,x1,y1,z1,x2,y2,z2] (plane is a grid boundary 0..64) Prefer box/roof/ellipsoid/cylinder for bulk geometry, runs for irregular silhouettes, repeat/mirror for repeated or symmetric parts, and points only for small details. This usually uses far fewer model tokens than raw voxel JSON.

Input Schema

TableJSON Schema
NameRequiredDescriptionDefault
paletteNo
commandsYes
modelRefYesShort temporary VoxelDraft model reference returned by model tools

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • changedInput schema / properties / modelRef / description
      Previous value: -"Short temporary VoxelDraft model reference that expires after 7 days of inactivity"New value: +"Short temporary VoxelDraft model reference returned by model tools"
    • changedOutput schema / (root)
      Previous value: -{
-  "additionalProperties": false,
-  "properties": {
-    "editUrl": {
-      "format": "uri",
-      "type": "string"
-    },
-    "modelRef": {
-      "description": "Short temporary VoxelDraft model reference that expires after 7 days of inactivity",
-      "maxLength": 64,
-      "type": "string"
-    },
-    "renderUrl": {
-      "format": "uri",
-      "type": "string"
-    },
-    "stats": {
-      "additionalProperties": false,
-      "properties": {
-        "bounds": {
-          "anyOf": [
-            {
-              "type": "null"
-            },
-            {
-              "additionalProperties": false,
-              "properties": {
-                "max": {
-                  "items": {
-                    "maximum": 63,
-                    "minimum": 0,
-                    "type": "integer"
-                  },
-                  "maxItems": 3,
-                  "minItems": 3,
-                  "type": "array"
-                },
-                "min": {
-                  "items": {
-                    "maximum": 63,
-                    "minimum": 0,
-                    "type": "integer"
-                  },
-                  "maxItems": 3,
-                  "minItems": 3,
-                  "type": "array"
-                },
-                "size": {
-                  "items": {
-                    "maximum": 64,
-                    "minimum": 1,
-                    "type": "integer"
-                  },
-                  "maxItems": 3,
-                  "minItems": 3,
-                  "type": "array"
-                }
-              },
-              "required": [
-                "min",
-                "max",
-                "size"
-              ],
-              "type": "object"
-            }
-          ]
-        },
-        "colors": {
-          "items": {
-            "pattern": "^#[0-9a-fA-F]{6}$",
-            "type": "string"
-          },
-          "maxItems": 512,
-          "type": "array"
-        },
-        "commandCount": {
-          "maximum": 512,
-          "minimum": 0,
-          "type": "integer"
-        },
-        "voxelCount": {
-          "maximum": 100000,
-          "minimum": 0,
-          "type": "integer"
-        }
-      },
-      "required": [
-        "voxelCount",
-        "commandCount",
-        "colors",
-        "bounds"
-      ],
-      "type": "object"
-    }
-  },
-  "required": [
-    "modelRef",
-    "stats",
-    "editUrl",
-    "renderUrl"
-  ],
-  "type": "object"
-}New value: +null
  2. Changed4 schema fields changed
    • removedInput schema / properties / model
      Removed value: -{
-  "description": "Opaque VoxelDraft model handle",
-  "type": "string"
-}
    • addedInput schema / properties / modelRef
      Added value: +{
+  "description": "Short temporary VoxelDraft model reference that expires after 7 days of inactivity",
+  "maxLength": 64,
+  "type": "string"
+}
    • changedInput schema / required
      Previous value: -[
-  "model",
-  "commands"
-]New value: +[
+  "modelRef",
+  "commands"
+]
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
+  "additionalProperties": false,
+  "properties": {
+    "editUrl": {
+      "format": "uri",
+      "type": "string"
+    },
+    "modelRef": {
+      "description": "Short temporary VoxelDraft model reference that expires after 7 days of inactivity",
+      "maxLength": 64,
+      "type": "string"
+    },
+    "renderUrl": {
+      "format": "uri",
+      "type": "string"
+    },
+    "stats": {
+      "additionalProperties": false,
+      "properties": {
+        "bounds": {
+          "anyOf": [
+            {
+              "type": "null"
+            },
+            {
+              "additionalProperties": false,
+              "properties": {
+                "max": {
+                  "items": {
+                    "maximum": 63,
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  "maxItems": 3,
+                  "minItems": 3,
+                  "type": "array"
+                },
+                "min": {
+                  "items": {
+                    "maximum": 63,
+                    "minimum": 0,
+                    "type": "integer"
+                  },
+                  "maxItems": 3,
+                  "minItems": 3,
+                  "type": "array"
+                },
+                "size": {
+                  "items": {
+                    "maximum": 64,
+                    "minimum": 1,
+                    "type": "integer"
+                  },
+                  "maxItems": 3,
+                  "minItems": 3,
+                  "type": "array"
+                }
+              },
+              "required": [
+                "min",
+                "max",
+                "size"
+              ],
+              "type": "object"
+            }
+          ]
+        },
+        "colors": {
+          "items": {
+            "pattern": "^#[0-9a-fA-F]{6}$",
+            "type": "string"
+          },
+          "maxItems": 512,
+          "type": "array"
+        },
+        "commandCount": {
+          "maximum": 512,
+          "minimum": 0,
+          "type": "integer"
+        },
+        "voxelCount": {
+          "maximum": 100000,
+          "minimum": 0,
+          "type": "integer"
+        }
+      },
+      "required": [
+        "voxelCount",
+        "commandCount",
+        "colors",
+        "bounds"
+      ],
+      "type": "object"
+    }
+  },
+  "required": [
+    "modelRef",
+    "stats",
+    "editUrl",
+    "renderUrl"
+  ],
+  "type": "object"
+}
  3. First observed

TDQS

A4.5/5.0
Behavior4/5

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

Annotations already declare destructiveHint=false and openWorldHint=false, but the description adds real behavioral context: edits are non-destructive because a new modelRef is returned and the original is not mutated, and the saved cloud project is untouched. It does not cover failure behavior, limits, or modelRef lifetime beyond calling it 'temporary.'

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?

Purpose and the crucial non-persistence caveat are front-loaded before the command reference. The command list is long but each line is load-bearing reference material for a DSL the agent must emit; only minor trimming is possible.

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

Completeness5/5

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

With no output schema, the description still states the return value (a new modelRef) and fully specifies the input DSL, coordinate space, and color encoding. For a high-complexity grammar tool, nothing essential to correct invocation is missing.

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

Parameters5/5

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

Schema description coverage is only 33% and the commands array is structurally opaque (array of mixed arrays), so the description carries the burden and delivers: full command grammar, coordinate integer range 0..63, color as #RRGGBB or zero-based palette index, and the mirror plane range 0..64. This is meaning the schema cannot convey on its own.

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

Purpose5/5

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

States a specific verb and resource ('Edit the temporary model identified by modelRef') and immediately scopes it against the sibling family by clarifying 'This does not modify a saved cloud project,' which separates it from save_voxel_model/load_voxel_project. An agent can identify the operation and its target without opening 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 Guidelines4/5

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

Gives concrete direction about how to invoke it ('Use VoxelDraft's compact instruction stream instead of emitting one JSON object per voxel') and when to prefer each command family (box/roof/ellipsoid for bulk, runs for irregular silhouettes, points only for details). It never explicitly states when to choose edit_voxel_model over create_voxel_model or load_voxel_project, so the sibling-routing guidance is implied rather than stated.

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

All VoxelDraft – AI Voxel Modeling toolsInspect
Try in Browser
One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources