Create a point at (x, y). Coordinates are converted from unit (default mm) to internal mm. Optional layer is a layer name (created if missing).

Create a line from (x1,y1) to (x2,y2). Lengths use unit (default mm).

Create a circle with centre (cx,cy) and radius. Lengths use unit (default mm).

Create a circular arc: centre (cx,cy), radius, startAngle and endAngle in radians (counterclockwise from +X; mathematical Y-up). Radius uses unit (default mm). Stored as coords [cx,cy,r,startAngle,endAngle] in mm.

Axis-aligned rectangle: corner (x,y), width, height, optional cornerRadius. Lengths use unit (default mm). Y increases upward; (x,y) is the lower-left corner. Stored as coords [x,y,width,height] in mm; cornerRadius in properties.

Create a polygon path from vertices. closed selects closed vs open stroke in preview (stored on entity properties). Points use unit (default mm).

Create a polyline. If closed is true, stroke is closed in SVG preview. Points use unit (default mm).

Create a named layer with optional color (e.g. #ff0000). Layers are keyed by name; default geometry layer is "0".

Assign entities to a layer by name.

List entities. Optional filter: { kind or type?, layer?, ids? } — kind/type is an EntityType string or array (point, line, circle, arc, rectangle, polygon, polyline).

List all layers (name, color, visible, locked).

Return one entity record by id.

Remove an entity by id.

Wireframe SVG preview of entities (mm). Optional entity_ids limits which shapes are drawn.

Import DXF content (UTF-8 text or base64) into the scene: ensures layers exist and adds LINE, CIRCLE, ARC, POINT, LWPOLYLINE, and 2D POLYLINE entities (mm; arcs as radians internally).

Export 2D entities to DXF (internal mm). Optional entity_ids limits which entities are written.

Start a nested editing transaction; pair with commit_transaction or rollback_transaction.

Commit the innermost active transaction.

Discard changes since the matching begin_transaction and restore scene state.

Record the current scene state on the undo stack (clears redo). Call before a batch of edits you want to revert in one step.

Restore the scene to the previous undo checkpoint.

Re-apply the last undone scene state.

Report the current 3D geometry backend. Returns one of: { backend: "occt", available: true, version? } when OpenCascade.js is loaded, { backend: "occt-error", available: false, reason } when load failed, or { backend: "mock", available: false, reason } when running with the lightweight fallback. Use this to verify whether STEP/STL/IGES/GLTF tools are running on real OCCT or on stubbed geometry.

Delete a layer by name. Entities on that layer are reassigned to the default layer 0.

Rename an existing layer. Any entities on the old layer are updated to the new layer name.

Set whether a layer is visible in previews and listings.

Set whether a layer is locked against editing.

Set or clear a layer display color. Pass an empty string to clear the stored color.

Alias for listing all layers.

Get the entity type string for a specific entity id.

Return entities assigned to a specific layer name.

Find entities whose bounding boxes intersect the given region.

Find entities by direct field or property-bag value using exact matching.

Compute a bounding box for all entities or a selected subset.

Measure length or perimeter for a 2D entity in internal millimetres.

Set a mutable entity field (layer, coords, closed, properties) or a custom property-bag value. Reserved fields id and type cannot be changed.

Set entity color display metadata on one or more entities.

Set entity linetype display metadata on one or more entities.

Set entity lineweight display metadata on one or more entities.

Create mirrored copies of one or more entities across an axis line.

Create rectangular array copies using row and column spacing in the current units.

Create polar array copies around a center. Angle is in radians and includes the source entity.

Create an offset copy of a supported 2D entity. Use left/right for open curves and inside/outside or inward/outward for closed curves.

Create a box solid at origin with width, height, and depth.

Create a sphere solid.

Create a vertical cylinder solid.

Create a frustum or cone solid.

Create a torus solid.

Create a prism from a 2D profile entity and height.

Create a simplified revolved solid from a 2D profile around an axis.

union two 3D solids and return a simplified composite result.

subtract two 3D solids and return a simplified composite result.

intersect two 3D solids and return a simplified composite result.

Create a simplified filleted copy of a solid.

Create a simplified chamfered copy of a solid.

Create a simplified shelled copy of a solid.

Create a simplified drafted copy of a solid.

Create a simplified lofted solid from one or more profiles.

Create a simplified swept solid from a profile and path.

Create or replace a named parameter.

Get a parameter by name.

List all named parameters.

Update an existing parameter value.

Add a coincident constraint.

Add a parallel constraint.

Add a perpendicular constraint.

Add a tangent constraint.

Add a concentric constraint.

Add a equal constraint.

Add a symmetric constraint.

Add a horizontal constraint.

Add a vertical constraint.

Add a fixed constraint.

Add a midpoint constraint.

Add a dimension_linear constraint.

Add a dimension_angular constraint.

Add a dimension_radial constraint.

Add a dimension_diameter constraint.

Create a block definition from entity ids.

Insert a block definition by cloning its member entities.

Explode an inserted block group back into loose entities.

List block definitions.

Return a block definition for editing.

Define an attribute on a block definition.

Create a named group from entity ids.

Remove a group by id.

Return entities in a group.

Create an empty assembly.

Add a component reference to an assembly.

Remove a component instance from an assembly.

Create a coincident mate between two references.

Create a concentric mate between two references.

Create a distance mate between two references.

Create a angle mate between two references.

Create a parallel mate between two references.

Mark a component as flexible or rigid.

Create an exploded view definition for an assembly.

Add an explode step to an exploded view.

Return a simple explode animation plan.

Measure distance between two points.

Measure angle between two lines.

Measure planar area from an entity.

Measure perimeter or curve length for an entity.

Measure solid volume.

Measure solid surface area.

Measure solid centroid.

Measure simplified moment of inertia from bbox.

Measure the combined bounding box of entities.

Approximate minimum distance between two solids via bounding boxes.

Check component interference using transformed component bounding boxes.

Check if minimum distance meets a clearance threshold. Accepts entity ids or assembly component ids; use assembly_id to scope component lookup.

Attach material metadata to a solid.

Return mass properties based on simplified volume and material density.

Add a linear dimension annotation.

Add an aligned dimension annotation.

Add an angular dimension annotation.

Add a radius dimension.

Add a diameter dimension.

Add an ordinate dimension.

Add baseline dimensions.

Add continued dimensions.

Add a single-line text annotation.

Add a multi-line text annotation.

Add a leader annotation.

Add a multileader annotation.

Create a table annotation.

Set a table cell value.

Add symbol annotation add_surface_finish_symbol.

Add symbol annotation add_weld_symbol.

Add symbol annotation add_gdt_frame.

Add symbol annotation add_center_mark.

Add symbol annotation add_center_line.

Create a viewport entity.

Store active drawing standard in parameter state.

Store active visual style in parameter state.

Create a drawing sheet.

Add a add_view to a drawing.

Add a add_section_view to a drawing.

Add a add_detail_view to a drawing.

Add a add_auxiliary_view to a drawing.

Return current drawing state after a logical refresh.

Render current scene or selected entities to a base64 image payload.

Generate a minimal PDF summary for a drawing.

Generate SVG for selected entities or the full scene.

Create a map-oriented drawing layout using current project extent and drawing scale metadata.

Apply a stored thesis/map template to an existing drawing and persist layout/export metadata.

Add a north arrow symbol annotation for a map drawing.

Add a simple scale bar annotation to a map drawing.

Add a simple map legend annotation listing domain layers or categories.

Add a coordinate grid using the provided extent and spacing.

Generate SVG files for one or more drawings and write them into an output directory.

Generate summary PDF files for one or more drawings and write them into an output directory.

Import STEP content.

Import IGES content.

Import STL content.

Import OBJ content.

Import SVG content.

Import PDF_AS_UNDERLAY content.

Export entities to STEP-like text.

Export entities to IGES-like text.

Export entities to STL-like text.

Export entities to OBJ-like text.

Export entities to SVG-like text.

Export entities to GLTF-like text.

Export entities to 3MF-like text.

Import DWG by piping through LibreDWG's dwg2dxf. Provide either path (DWG on disk) or base64 content. Falls back with an error if dwg2dxf is not installed (run dwg_tools_status to check).

Export the current 2D scene to DWG by writing a DXF and converting via LibreDWG's dxf2dwg. Returns base64 DWG bytes; pass path to also write to disk. Run dwg_tools_status to confirm dxf2dwg is installed.

Report whether LibreDWG's dwg2dxf / dxf2dwg binaries are available on PATH so import_dwg / export_dwg can actually convert. Returns the resolved binary paths when present.

Import CSV rows into point entities for sampling points or monitoring wells while preserving tabular attributes.

Import GeoJSON FeatureCollection data into point, line, polyline, and polygon entities.

Import ESRI Shapefile geometry and DBF attributes into point, line, polyline, and polygon entities.

Export 2D entities to a GeoJSON FeatureCollection while preserving layer and properties metadata.

Export 2D entities as a zipped ESRI Shapefile package and optionally write it to disk.

Set project CRS and optional origin metadata for resource/environment mapping workflows.

Return current project georeferencing metadata.

Set the current map extent used for paper layout, grids, and exports.

Set a drawing scale factor between local drawing units and world coordinates.

Transform coordinates between local drawing space and world space using project origin and drawing scale.

Reproject a single point between two CRSes using proj4. from/to accept EPSG codes (e.g. 'EPSG:4326', '4326') or full proj4 strings. Common CN CRSes (EPSG:4326/3857/4490/4513-4533) are pre-registered.

Reproject many points between two CRSes in one call. Same from/to semantics as reproject_point.

Register an EPSG-style CRS definition with proj4 so future reprojection tools can use it. code should be like 'EPSG:4548' and definition is a proj4 string.

List CRS codes currently registered with proj4 in this session (pre-registered defaults plus any added via register_crs_definition).

Create a resource/environment sampling point with optional label, elevation, and attribute metadata.

Create a monitoring well point with optional depth and screened interval metadata.

Create a profile line used for section sampling and resource/environment transects.

Create a study boundary or management zone polygon with domain metadata.

List entities tagged with a domain kind such as sampling_point, monitoring_well, or profile_line.

Summarize polygonal area by entity, optionally grouped by a property field for study zones.

Measure the length of a profile line or transect.

Sample elevated points along a profile line and compute the section area against a baseline elevation.

Estimate cut/fill volume inside a polygon from enclosed elevated sample points and a base elevation.

Estimate surface volume from elevated point samples and a representative cell area.

Read a GeoTIFF file and return width / height / sample format / bbox / origin / resolution / CRS without attaching it to the session. Use attach_raster_layer to keep it as a session basemap.

Attach a GeoTIFF on disk to the session as a raster basemap layer. Returns the assigned layer id and parsed metadata. Use list_raster_layers / render_raster_layer_png afterwards.

List all raster (basemap) layers attached to the session.

Return one raster layer record by id.

Remove a raster layer by id.

Toggle a raster layer's visibility flag.

Rename a raster layer for human reference.

Decode an attached raster layer (or a GeoTIFF on disk) into a PNG preview. Single-band rasters are auto-stretched to grayscale; multi-band rasters use the first three bands. Returns base64 PNG bytes; pass output_path to also write to disk.

Create an ellipse with radii and rotation.

Create a control-point spline entity.

Trim a line-like entity by shortening it toward its midpoint.

Extend a line-like entity by 20 percent.

Create a simple arc fillet between two lines using their intersection midpoint.

Create a simple chamfer line between two lines.

Return a simplified face normal for an axis-aligned face id.

Return simplified edge ids for a solid.

Return simplified face ids for a solid.

Return solid bbox corner vertices.

Return simplified brep-like topology for a solid.

Start a new empty CAD project (default layer 0, no entities). Optional project name.

Return current project metadata and scene counts.

Save the current scene to a project JSON file on disk (cad-mcp-project v1).

Load a project JSON file from disk and replace the current scene (undo/redo cleared).

Alias for load_project: load a project JSON file from disk and replace the current scene.

Inspect a running AutoCAD application through COM: window/process identity, current binding, active document and idle state. This does not establish a persistent binding or operate on the internal CAD session.

List COM-reachable AutoCAD applications and their open documents. Returns data.applications and data.documents with window/process identity for target selection. COM may not expose every same-version AutoCAD process.

Bind this MCP server to a COM-reachable AutoCAD application window/process and document. Use a decimal windowHandle and document name/full path returned by status/list calls; omit them to select the current target. activate defaults to true and activates the selected document; false only establishes the binding without activating it. Later commands reject if the bound document is no longer active. COM may not expose every same-version AutoCAD process.

Clear this MCP server's AutoCAD binding. Does not close AutoCAD, close a document, or discard drawing changes.

Activate an already-open AutoCAD document by its exact name or full path and update the binding to that document. Does not open files. Use autocad_list_documents to identify the target.

Read 1–50 AutoCAD system variables from the live document, for example CMDACTIVE, CMDNAMES, CLAYER or INSUNITS. Use readback to verify command effects; an idle state alone does not prove command success.

List layers from the live AutoCAD document through COM, respecting the current application/document binding. Separate from the internal CAD session's list_layers.

List entities from the live AutoCAD document's ModelSpace, respecting the current binding. Optional filters: layer, objectName, limit. Separate from the internal CAD session's list_entities.

Submit a raw command to the live AutoCAD document. Rejects a busy document or a bound document that is no longer active. Example: _.ZOOM _E. waitForIdle defaults to false; true polls for idle for timeoutMs (1000–30000 ms) after the COM SendCommand call returns. A separate 45-second bridge timeout bounds blocking COM calls. Result state is submitted, idle_observed or timeout; none proves semantic command success. timeout is an MCP error with result data. Query intended results afterward. Submission is not retried; after an error or timeout do not resend before inspecting the drawing.