AutoCAD 2024 MCP

Overview Schema Source Related Servers Discussions Admin

cad_draw

Destructive

Create 2D entities, annotations, hatches, dimensions, and block references in AutoCAD 2024 drawings with a single atomic operation.

Instructions

Atomically create 2D entities, annotations, hatches, dimensions, and block references. Angles are radians and coordinates use the current UCS unless otherwise stated.

Input Schema

TableJSON Schema

Name	Required	Description
`space`	No
`entities`	Yes
`visualMode`	No	Control AutoCAD screen updates; step presents each created entity
`zoomToResult`	No
`coordinateSystem`	No
`expectedRevision`	No	Drawing revision returned by cad_status
`highlightResults`	No
`expectedDocumentId`	No	Document id returned by cad_status

Schema Changelog

Changes observed during successful MCP inspections.

Changed5 schema fields changedv0.1.0Sep 17, 2026

changedInput schema / properties / entities / items / anyOf

Previous value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "colorIndex": {
-        "maximum": 256,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "end": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
-      },
-      "layer": {
-        "type": "string"
-      },
-      "linetype": {
-        "type": "string"
-      },
-      "start": {
-        "anyOf": [
-          {
-            "items": [
-              {
-                "type": "number"
-              },
-              {
-                "type": "number"
-              }
-            ],
-            "maxItems": 2,
-            "minItems": 2,
-            "type": "array"
-          },
-          {
-            "items": [
-              {
-                "type": "number"
-              },
-              {
-                "type": "number"
-              },
-              {
-                "type": "number"
-              }
-            ],
-            "maxItems": 3,
-            "minItems": 3,
-            "type": "array"
-          }
-        ]
-      },
-      "type": {
-        "const": "line",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "start",
-      "end"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "closed": {
-        "type": "boolean"
-      },
-      "colorIndex": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
-      },
-      "layer": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
-      },
-      "linetype": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
-      },
-      "points": {
-        "items": {
-          "$ref": "#/properties/entities/items/anyOf/0/properties/start/anyOf/0"
-        },
-        "minItems": 2,
-        "type": "array"
-      },
-      "type": {
-        "const": "polyline",
-        "type": "string"
-      },
-      "width": {
-        "minimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "type",
-      "points"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "center": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
-      },
-      "colorIndex": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
-      },
-      "layer": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
-      },
-      "linetype": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
-      },
-      "radius": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "type": {
-        "const": "circle",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "center",
-      "radius"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "center": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
-      },
-      "colorIndex": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
-      },
-      "endAngle": {
-        "type": "number"
-      },
-      "layer": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
-      },
-      "linetype": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
-      },
-      "radius": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "startAngle": {
-        "type": "number"
-      },
-      "type": {
-        "const": "arc",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "center",
-      "radius",
-      "startAngle",
-      "endAngle"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "center": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
-      },
-      "colorIndex": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
-      },
-      "endParameter": {
-        "type": "number"
-      },
-      "layer": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
-      },
-      "linetype": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
-      },
-      "majorAxis": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/start/anyOf/1"
-      },
-      "radiusRatio": {
-        "exclusiveMinimum": 0,
-        "maximum": 1,
-        "type": "number"
-      },
-      "startParameter": {
-        "type": "number"
-      },
-      "type": {
-        "const": "ellipse",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "center",
-      "majorAxis",
-      "radiusRatio"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "colorIndex": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
-      },
-      "layer": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
-      },
-      "linetype": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
-      },
-      "position": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
-      },
-      "type": {
-        "const": "point",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "position"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "colorIndex": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
-      },
-      "height": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "layer": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
-      },
-      "linetype": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
-      },
-      "position": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
-      },
-      "rotation": {
-        "type": "number"
-      },
-      "style": {
-        "type": "string"
-      },
-      "text": {
-        "type": "string"
-      },
-      "type": {
-        "const": "text",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "position",
-      "text",
-      "height"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "colorIndex": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
-      },
-      "height": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "layer": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
-      },
-      "linetype": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
-      },
-      "position": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
-      },
-      "rotation": {
-        "type": "number"
-      },
-      "style": {
-        "type": "string"
-      },
-      "text": {
-        "type": "string"
-      },
-      "type": {
-        "const": "mtext",
-        "type": "string"
-      },
-      "width": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      }
-    },
-    "required": [
-      "type",
-      "position",
-      "text",
-      "height",
-      "width"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "angle": {
-        "type": "number"
-      },
-      "associative": {
-        "type": "boolean"
-      },
-      "boundaryHandles": {
-        "items": {
-          "type": "string"
-        },
-        "minItems": 1,
-        "type": "array"
-      },
-      "colorIndex": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
-      },
-      "layer": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
-      },
-      "linetype": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
-      },
-      "pattern": {
-        "default": "SOLID",
-        "type": "string"
-      },
-      "scale": {
-        "exclusiveMinimum": 0,
-        "type": "number"
-      },
-      "type": {
-        "const": "hatch",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "boundaryHandles"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "attributes": {
-        "additionalProperties": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "colorIndex": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
-      },
-      "insertionPoint": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
-      },
-      "layer": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
-      },
-      "linetype": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
-      },
-      "name": {
-        "type": "string"
-      },
-      "rotation": {
-        "type": "number"
-      },
-      "scale": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/start/anyOf/1"
-      },
-      "type": {
-        "const": "blockReference",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "name",
-      "insertionPoint"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "colorIndex": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
-      },
-      "dimensionLine": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
-      },
-      "first": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
-      },
-      "layer": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
-      },
-      "linetype": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
-      },
-      "second": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
-      },
-      "style": {
-        "type": "string"
-      },
-      "type": {
-        "const": "alignedDimension",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "first",
-      "second",
-      "dimensionLine"
-    ],
-    "type": "object"
-  },
-  {
-    "additionalProperties": false,
-    "properties": {
-      "colorIndex": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
-      },
-      "dimensionLine": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
-      },
-      "first": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
-      },
-      "layer": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
-      },
-      "linetype": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
-      },
-      "rotation": {
-        "type": "number"
-      },
-      "second": {
-        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
-      },
-      "style": {
-        "type": "string"
-      },
-      "type": {
-        "const": "rotatedDimension",
-        "type": "string"
-      }
-    },
-    "required": [
-      "type",
-      "first",
-      "second",
-      "dimensionLine",
-      "rotation"
-    ],
-    "type": "object"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "colorIndex": {
+        "maximum": 256,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "end": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "layer": {
+        "type": "string"
+      },
+      "linetype": {
+        "type": "string"
+      },
+      "linetypeScale": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "lineweight": {
+        "type": "integer"
+      },
+      "start": {
+        "anyOf": [
+          {
+            "items": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "number"
+              }
+            ],
+            "maxItems": 2,
+            "minItems": 2,
+            "type": "array"
+          },
+          {
+            "items": [
+              {
+                "type": "number"
+              },
+              {
+                "type": "number"
+              },
+              {
+                "type": "number"
+              }
+            ],
+            "maxItems": 3,
+            "minItems": 3,
+            "type": "array"
+          }
+        ]
+      },
+      "type": {
+        "const": "line",
+        "type": "string"
+      },
+      "visible": {
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "type",
+      "start",
+      "end"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "closed": {
+        "type": "boolean"
+      },
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "points": {
+        "items": {
+          "$ref": "#/properties/entities/items/anyOf/0/properties/start/anyOf/0"
+        },
+        "minItems": 2,
+        "type": "array"
+      },
+      "type": {
+        "const": "polyline",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      },
+      "width": {
+        "minimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "type",
+      "points"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "closed": {
+        "type": "boolean"
+      },
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "points": {
+        "items": {
+          "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+        },
+        "minItems": 2,
+        "type": "array"
+      },
+      "type": {
+        "const": "polyline3d",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "points"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "degree": {
+        "maximum": 25,
+        "minimum": 1,
+        "type": "integer"
+      },
+      "fitPoints": {
+        "items": {
+          "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+        },
+        "minItems": 2,
+        "type": "array"
+      },
+      "fitTolerance": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "type": {
+        "const": "spline",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "fitPoints"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "basePoint": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "throughPoint": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "type": {
+        "const": "ray",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "basePoint",
+      "throughPoint"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "basePoint": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "throughPoint": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "type": {
+        "const": "xline",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "basePoint",
+      "throughPoint"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "center": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "radius": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "type": {
+        "const": "circle",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "center",
+      "radius"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "center": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "endAngle": {
+        "type": "number"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "radius": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "startAngle": {
+        "type": "number"
+      },
+      "type": {
+        "const": "arc",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "center",
+      "radius",
+      "startAngle",
+      "endAngle"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "center": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "endParameter": {
+        "type": "number"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "majorAxis": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start/anyOf/1"
+      },
+      "radiusRatio": {
+        "exclusiveMinimum": 0,
+        "maximum": 1,
+        "type": "number"
+      },
+      "startParameter": {
+        "type": "number"
+      },
+      "type": {
+        "const": "ellipse",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "center",
+      "majorAxis",
+      "radiusRatio"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "position": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "type": {
+        "const": "point",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "position"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "height": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "position": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "rotation": {
+        "type": "number"
+      },
+      "style": {
+        "type": "string"
+      },
+      "text": {
+        "type": "string"
+      },
+      "type": {
+        "const": "text",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "position",
+      "text",
+      "height"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "height": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "position": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "rotation": {
+        "type": "number"
+      },
+      "style": {
+        "type": "string"
+      },
+      "text": {
+        "type": "string"
+      },
+      "type": {
+        "const": "mtext",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      },
+      "width": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      }
+    },
+    "required": [
+      "type",
+      "position",
+      "text",
+      "height",
+      "width"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "angle": {
+        "type": "number"
+      },
+      "associative": {
+        "type": "boolean"
+      },
+      "boundaryHandles": {
+        "items": {
+          "type": "string"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "pattern": {
+        "default": "SOLID",
+        "type": "string"
+      },
+      "scale": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "type": {
+        "const": "hatch",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "boundaryHandles"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "attributes": {
+        "additionalProperties": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "insertionPoint": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "name": {
+        "type": "string"
+      },
+      "rotation": {
+        "type": "number"
+      },
+      "scale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start/anyOf/1"
+      },
+      "type": {
+        "const": "blockReference",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "name",
+      "insertionPoint"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "hasArrowHead": {
+        "type": "boolean"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "points": {
+        "items": {
+          "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+        },
+        "minItems": 2,
+        "type": "array"
+      },
+      "type": {
+        "const": "leader",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "points"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "columnWidth": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "position": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "rowHeight": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "rows": {
+        "items": {
+          "items": {
+            "type": "string"
+          },
+          "minItems": 1,
+          "type": "array"
+        },
+        "maxItems": 200,
+        "minItems": 1,
+        "type": "array"
+      },
+      "style": {
+        "type": "string"
+      },
+      "textHeight": {
+        "exclusiveMinimum": 0,
+        "type": "number"
+      },
+      "type": {
+        "const": "table",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "position",
+      "rows"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "dimensionLine": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "dimensionText": {
+        "type": "string"
+      },
+      "first": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "second": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "style": {
+        "type": "string"
+      },
+      "type": {
+        "const": "alignedDimension",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "first",
+      "second",
+      "dimensionLine"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "dimensionLine": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "dimensionText": {
+        "type": "string"
+      },
+      "first": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "rotation": {
+        "type": "number"
+      },
+      "second": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "style": {
+        "type": "string"
+      },
+      "type": {
+        "const": "rotatedDimension",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "first",
+      "second",
+      "dimensionLine",
+      "rotation"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "center": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "chordPoint": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "dimensionText": {
+        "type": "string"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "leaderLength": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "style": {
+        "type": "string"
+      },
+      "type": {
+        "const": "radialDimension",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "center",
+      "chordPoint"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "chordPoint": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "dimensionText": {
+        "type": "string"
+      },
+      "farChordPoint": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "leaderLength": {
+        "minimum": 0,
+        "type": "number"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "style": {
+        "type": "string"
+      },
+      "type": {
+        "const": "diametricDimension",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "chordPoint",
+      "farChordPoint"
+    ],
+    "type": "object"
+  },
+  {
+    "additionalProperties": false,
+    "properties": {
+      "arcPoint": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "colorIndex": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/colorIndex"
+      },
+      "dimensionText": {
+        "type": "string"
+      },
+      "layer": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/layer"
+      },
+      "line1End": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "line1Start": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "line2End": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "line2Start": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/start"
+      },
+      "linetype": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetype"
+      },
+      "linetypeScale": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/linetypeScale"
+      },
+      "lineweight": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/lineweight"
+      },
+      "style": {
+        "type": "string"
+      },
+      "type": {
+        "const": "angularDimension2Line",
+        "type": "string"
+      },
+      "visible": {
+        "$ref": "#/properties/entities/items/anyOf/0/properties/visible"
+      }
+    },
+    "required": [
+      "type",
+      "line1Start",
+      "line1End",
+      "line2Start",
+      "line2End",
+      "arcPoint"
+    ],
+    "type": "object"
+  }
+]

addedInput schema / properties / expectedDocumentId

Added value: +{
+  "description": "Document id returned by cad_status",
+  "minLength": 1,
+  "type": "string"
+}

addedInput schema / properties / expectedRevision

Added value: +{
+  "description": "Drawing revision returned by cad_status",
+  "minimum": 0,
+  "type": "integer"
+}

addedInput schema / properties / highlightResults
```
Added value: +{
+  "type": "boolean"
+}
```

addedInput schema / properties / visualMode

Added value: +{
+  "description": "Control AutoCAD screen updates; step presents each created entity",
+  "enum": [
+    "silent",
+    "batch",
+    "step"
+  ],
+  "type": "string"
+}

First observedv0.0.3Sep 11, 2026

TDQS

A3.6/5.0

Behavior3/5

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

Annotations already indicate readOnlyHint=false and destructiveHint=true, so the mutation nature is known. The description adds the key behavioral trait of atomicity ('Atomically create'), which is not in the annotations. It does not, however, disclose other side effects such as revision increments, event emission, or failure rollback behavior, so it only partially enriches beyond the structured data.

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

Conciseness5/5

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

The description is a single, tight sentence that front-loads the core purpose before adding the unit/coordinate note. Every clause earns its place: the atomicity, the entity types, and the critical geometric conventions. No filler or redundancy.

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?

Given the tool's high complexity—8 top-level parameters, 20+ entity variants, no output schema, and a 1000-item array limit—the description is far from complete. It omits preconditions like expectedDocumentId and expectedRevision, the meaning of visualMode options beyond the schema, and any error/rollback semantics. An agent would need to deep-dive into the schema and infer much of the usage context on its own.

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

Parameters3/5

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

With only 38% schema description coverage, the description partially compensates by stating global conventions: 'Angles are radians and coordinates use the current UCS unless otherwise stated.' This is valuable for all coordinate/angle parameters. However, it does not explain the entities array's structure, defaults for visualMode, or the purpose of expectedRevision/expectedDocumentId beyond what the schema already provides, so it falls short of fully bridging the coverage gap.

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?

The description states a specific verb ('create') and enumerates the resource types ('2D entities, annotations, hatches, dimensions, and block references'). It also adds the atomicity qualifier, which distinguishes it from siblings like cad_edit (which modifies) and cad_command (which executes arbitrary commands). This is clear and differentiates from alternative tools.

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 implied: an agent would use this tool to create new drawing objects. However, there is no explicit guidance on when to prefer this over cad_edit for modifications, cad_undo for reverting, or cad_block for block-specific operations. No exclusions or alternative conditions are stated.

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

cad_draw

Instructions

Input Schema

Schema Changelog

TDQS

Other Tools