Bimwright DWG

Ensure the 'Bimwright_Unicode' text style exists (using Open Sans Condensed Light font, using the bundled font or a checksum-validated fallback download) and reassign target entities to it. Height normalization is smart and idempotent: SHX sources are reduced more than TrueType sources, while entities already on the Unicode style keep their current height instead of shrinking again. Targets: if 'handles' is a non-empty JSON array, those entities are used; otherwise falls back to the current pickfirst selection. MUST be called after translating text to Vietnamese or any non-ASCII language on drawings that use SHX fonts lacking the required glyphs (otherwise text renders as '?'). Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Run multiple internal DWG commands sequentially as a logical batch. commands must be a JSON array of {cmd, params}. run_lisp is blocked in this build, including batches; use dwg_inspect_lisp for analysis only. Each step reports index, command_ok, effective ok, outcome and nullable mutation_applied; file-output steps also report output_verified. Read nested results/file_receipt and output_artifact for omitted details. May change drawing data or files; disabled in read-only mode even when a particular batch only contains reads. Commands are sequential, not one atomic transaction: earlier effects can remain after a later failure. Use AutoCAD UNDO for drawing edits and backups for file changes.

Capture the active drawing to a raster image (.png/.jpg/.jpeg/.bmp) using AutoCAD's in-process document preview API. No desktop automation, zoom, geometry edits or DWG save. Wait for zoom/commands to complete before capturing. If output_path is omitted, saves to %LOCALAPPDATA%\Bimwright\dwg-mcp\captures\ with an auto-generated name. Returns inline MCP image content (up to 8 MiB) plus JSON with image path, actual dimensions, SHA-256, timestamp, document fingerprint, layout, viewport and camera. Use capture_id with dwg_inspect_view_region when region_navigation.supported is true. Camera coordinates describe the active viewport; do not assume one pixel-to-world mapping for tiled views or paper layouts. Persist the response alongside the image when building a reading atlas. Writes an image file; disabled in read-only mode. Delete a new image to undo file creation. Overwritten image bytes cannot be restored by AutoCAD UNDO; restore a backup.

Apply an AutoCAD ACI color index to entities identified by handle. handles is a JSON array of AutoCAD handle strings. color_index is validated by AutoCAD-side handling as ACI range 1-256. Returns per-item {handle, ok, error}; bad handles do not abort siblings. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Move entities identified by handle to an existing layer. If create_layer=true, the layer is ensured first using color_index or default 7. Returns one result record per handle; bad handles do not abort siblings. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

LOW-LEVEL rewrite primitive. PREFER translate_and_rewrite for the standard translation workflow - this tool exists for expert control, regression replay from mcp-calls.jsonl, and future non-translation orchestrators. Accepts explicit per-cluster instructions {anchor_handle, new_text, delete_handles, convert_to_mtext, mtext_width}. For each cluster: anchor_handle is the fragment to keep (typically topmost-leftmost), new_text is the full rewritten sentence (may contain \\P line breaks for multi-line), delete_handles are all other fragments in the cluster (will be erased), convert_to_mtext=true upgrades DBText->MText for natural word wrap (only safe in model space, not inside blocks), mtext_width is the cluster bounding box X-span (only used if convert_to_mtext). Each cluster runs in its own transaction (one failure does not roll back siblings). Response per cluster includes an 'action' field: update | collapse | rewrite_in_block. If applyUnicodeStyle=true, the same call reassigns surviving entities to the Unicode text style and scales height. final_text_height measures the resulting entity's stored height after normalization/scaling, or null if unavailable; block definitions use local units. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Copy entities identified by handle by a displacement vector. handles is a JSON array of AutoCAD handle strings. vector is a JSON point object with numeric x, y, and optional z fields. Returns per-item {handle, ok, new_handle, error}; bad handles do not abort siblings. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Count AutoCAD entities matching type/layer/color; legacy calls read model space. Optional bbox/space use the same inclusive WCS extents filter as paged query, report INSUNITS and unknown extents separately. Incomplete spatial counts return null count/exact_match_count plus observed matched_count; no estimated count is invented. Spatial counts require matching plugin support and direct calls outside batches.

Create an Arc in the current AutoCAD space. center is a JSON point object. radius must be positive and finite. start_angle and end_angle are degrees. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Create a Circle in the current AutoCAD space. center is a JSON point object with numeric x, y, and optional z fields. radius must be positive and finite. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Create an Ellipse in the current AutoCAD space. center is a JSON point object. major_radius and minor_radius must be positive and finite. rotation is degrees. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Ensure an AutoCAD layer exists. If the layer already exists, its existing color and state are left unchanged and the response reports created=false. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Create a Line in the current AutoCAD space. start and end are JSON point objects with numeric x, y, and optional z fields. Optional layer is ensured before assignment; optional color_index sets the entity ACI color. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Create a Point in the current AutoCAD space. point is a JSON point object with numeric x, y, and optional z fields. Optional layer is ensured before assignment; optional color_index sets the entity ACI color. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Create a 2D Polyline in the current AutoCAD space. points is a JSON array of point objects with numeric x, y, and optional z fields. At least two points are required. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Create a Rectangle as a closed Polyline in the current AutoCAD space. corner1 and corner2 are JSON point objects with numeric x, y, and optional z fields. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Erase entities identified by handle. handles is a JSON array of AutoCAD handle strings. Returns per-item {handle, ok, error}; bad handles do not abort siblings. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Return this gateway's binding state, PID, process start, generation, selection confirmation and drawing identity. No discovery or drawing changes.

Return small JSON-safe metadata for the current AutoCAD drawing: drawing name when available, current layer, current space/layout, and database unit scalars.

Profile top-level entities in all spaces (default), model only or one named layout. Reports exact managed runtime type, layer and per-space counts with source/coverage; incomplete reads report observed counts and null exact totals. Block inserts count once; nested block contents, uninserted definitions and xref contents are not expanded. The default final MCP output cap is 16384 UTF-8 bytes, independent of the global response budget. Content identifies omitted groups and next_calls for types/layers/spaces. Each page rescans; pass expected_snapshot from the previous result when offset is positive. A changed document/revision refuses continuation. No geometry, selection or drawing changes.

Return properties for AutoCAD entities identified by handle. Input handles is a JSON array of hex handles, e.g. ["7F5AD"]. Returns one result record per handle; bad handles do not abort siblings.

Read and cluster text. Existing two-argument calls use AutoCAD pickfirst selection and legacy rewrite IDs. Supply handles or bbox to read without selecting anything; choose exactly one explicit source. Explicit-source mode reads top-level DBText/MText/MLeader, does not expand blocks/xrefs, clusters the full declared source before paging whole clusters, and returns read-only cluster_key values. It leaves legacy rewrite state unchanged. For per-entity writes use includeEntities=true then dwg_update_texts by handle; cluster rewrite still requires manual selection. Cursor, content omissions and next_calls follow the bounded query pattern (default16384 final MCP UTF-8 bytes). Source limits5000 text records/8MiB UTF-8; incomplete sources produce no groups or continuation. Model snapshots ignore viewport navigation; entity changes refuse continuation. Explicit-source calls must be direct outside batches/baked tools. Each cluster has id, text, entity_count, in_block (bool) and rewrite_mode only on the legacy selection path. Explicit-source groups never supply writable numeric IDs.

At session start select the intended AutoCAD target, then call dwg_health(check_updates=true) once. Routine probes stay offline; not_checked/unknown never means up to date. Reports host/document state and loaded server/plugin versions, build ids and alignment. A busy UI can make document state unavailable; health does not require or lock an active drawing. No target still returns gateway identity with ok:false and host_connected:false. Legacy plugins without health/identity remain unverified, not assumed corrupt. Inspect both update.components and the full update.notification message, lookup_reason, protected_component_reasons and unobserved_components. UPDATE_CHECK_UNAVAILABLE reports external lookup failure, not a runtime fault or request for installation authorization. LOCAL_VERSION_AHEAD is informational: never downgrade or automatically replace development builds. Only update_guidance.mode=prepare_update with bundle_update_proposal_allowed=true permits an update proposal and needs installation authorization (reuse existing permission); other modes contain check/review steps only. comparison_reason=release_revision_unavailable means missing external evidence, not a broken local build. After reconnect compare fresh initialize and tools/list metadata/schema/annotations on that connection with client_verification; the server cannot prove client cache refresh. Matching revisions do not verify artifact bytes, compatibility or publisher trust. Read-only; never installs, downloads packages, saves/closes drawings, edits client configs or restarts processes.

Statically inspect AutoLISP for known suspicious patterns without executing it — downloaded .lsp files can embed malware (process exec via startapp/shell, COM automation like WScript.Shell/XMLHTTP, persistence via acad.lsp/acaddoc.lsp or registry writes, file deletion, staged (load ...) payloads, obfuscation via eval/read). Pure local analysis: does not execute anything and needs no AutoCAD round-trip, so it works under --read-only too. Params: 'file' (absolute path) and/or 'code' (inline source). Returns {ok, verdict: clean|caution|dangerous, opaque, summary, findings[]}. Compiled .fas/.vlx cannot be inspected and always verdict 'dangerous'. This is not a sandbox or an antivirus guarantee: clean means no known pattern matched, not safe. execution_authorized and safety_assured are always false. dwg_run_lisp is blocked in this build; do not bypass that refusal through other execution tools.

Look closer at a rectangle in a previous capture: zoom in AutoCAD, regenerate, verify the camera and capture a NEW image. Changes the visible view and saves a PNG, but does not edit geometry or save the DWG. Requires a current source capture in the same unchanged drawing: single model-space viewport, top-down, zero twist, orthographic, no clipping. Returns inline image and JSON with a new capture_id and parent_capture_id. Use the new ID for the next zoom; use dwg_restore_view to go back. History is limited to 64 captures / 30 minutes in the current AutoCAD process. Stale or unsupported sources are refused before zoom. Writes a new image file; disabled in read-only mode. Restore the prior camera with dwg_restore_view and delete the generated image to undo these effects.

List running AutoCAD instances with target_id, PID and process start time. In full mode select the intended instance using dwg_switch_target(target='pid:<PID>'). In --read-only, start or restart the gateway with --target pid:<PID> or id:<target_id>; dwg_switch_target is unavailable. Supports per-instance discovery and legacy AutoCAD 2022 through 2027 discovery files.

List layers in the current AutoCAD drawing with small scalar properties such as color index, locked/frozen/off state.

List recent DWG files for the connected AutoCAD product from its user registry Recent File List. Works with no drawing open; never opens a file. Returns up to 50 entries in MRU index order: index, path, name, exists and pinned. Optional name is a case-insensitive filename substring, filtered before max_items (1-50, default 50). Ask the user which path to open, then call dwg_open_drawing with that absolute path. The registry layout is product-specific; a missing list returns registry_found=false, not a guessed list.

Move entities identified by handle by a displacement vector. handles is a JSON array of AutoCAD handle strings. vector is a JSON point object with numeric x, y, and optional z fields. Returns per-item {handle, ok, error}; bad handles do not abort siblings. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Offset curve entities identified by handle by distance. handles is a JSON array of AutoCAD handle strings. Only Curve entities are supported. Returns per-item {handle, ok, created_handles, error}; bad handles and unsupported entities do not abort siblings. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Open an existing .dwg from an absolute drive/UNC path on the AutoCAD machine, not the MCP client. This is the tool to use when no drawing is open. Ask the user which recent path to open first. activate=true (default) makes it active; false requires an existing active drawing and restores that drawing after opening (not a viewless background database). read_only=false (default) requests writable access; true requests read-only access. Reuses an already-open drawing without reopening it; an access-mode mismatch is refused rather than closing or changing it. Never saves, closes or overwrites drawings. Runs in application context without a document lock, requires idle multi-document mode (SDI=0), and is not supported inside batch/baked drawing workflows. DWG only: no DXF, templates, cloud URLs, audit or recovery. Native AutoCAD dialogs may require the user. timeout_seconds: 1-900, default 600; timing out does not cancel an Open already running, so inspect AutoCAD before retrying. Returns opened, was_already_open, title, path, actual read_only, activated and active_document. Opening an older DWG does not write upgraded bytes unless subsequently saved.

Query model-space AutoCAD entities with optional filters for entity type, layer, and ACI color index. Existing calls retain their legacy fields, geometry option and order. Set paged=true or supply spatial/field options for bounded numeric-handle pages. Paged defaults are handle/type/layer and 16384 final MCP UTF-8 bytes. Content reports omissions and next_calls; echo their filters/fields with the signed cursor. BBox tests inclusive WCS 3D axis-aligned extents, not exact geometry clipping, in selected-space drawing units without INSUNITS conversion. Unavailable bbox-filter extents/population read failures are counted and block continuation; changed drawing/filter/fields rejects the cursor. Requires matching plugin support; unconfirmed legacy replies are refused. Call directly, outside batches, for paged reads. Use fields=["handle"] for paged spatial handles without changing selection.

Return to the camera of a recent supported capture and return a fresh inline image plus JSON. Changes the visible view and writes a PNG, not drawing geometry. Requires the same unchanged drawing, layout and single top-down model viewport. Use an ancestor capture_id to return to the overview. Returns a new capture_id; use that new ID for subsequent region navigation. History expires after 30 minutes or 64 captures or host restart. Writes a new image file; disabled in read-only mode. Return to another captured camera and delete the generated image to undo these effects.

Rotate entities identified by handle around basePoint on the Z axis. handles is a JSON array of AutoCAD handle strings. basePoint is a JSON point object, and angleDegrees is in degrees. Returns per-item {handle, ok, error}; bad handles do not abort siblings. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Unavailable: LISP execution is blocked in this build. Retained for compatibility; all file/code/command inputs are refused locally without reading files or contacting AutoCAD. There is no isolated executor or approved-script trust mechanism. Use dwg_inspect_lisp for static analysis only; clean/caution/dangerous never authorize execution. MCPENABLECODE does not override this restriction. Do not bypass refusal through dwg_send_code, batch, ToolBaker, or reformatted payloads.

Scale entities identified by handle around basePoint. handles is a JSON array of AutoCAD handle strings. basePoint is a JSON point object. scale must be finite, positive, and less than or equal to 1000. Returns per-item {handle, ok, error}; bad handles do not abort siblings. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Return handles for model-space entities on a required layer, with optional type/color filters. This does not change AutoCAD pickfirst selection.

Return handles for model-space entities of a required type, with optional layer/color filters. This does not change AutoCAD pickfirst selection.

Execute a C# snippet through dwg_send_code against the AutoCAD .NET API as an escape hatch. Enabled by default on the meta toolset; the AutoCAD MCPDISABLECODE command disables it for the session (MCPENABLECODE re-enables). WARNING: send_code runs arbitrary code with full access to the AutoCAD process and local filesystem. Only use with trusted agents. This is not a sandbox. Never use it to bypass a run_lisp refusal or execute untrusted LISP. Globals available: Document doc, Database db, Editor ed. The script runs on the document-lock thread; end with 'return <expr>;' or a trailing expression to return a JSON-safe DTO value in the result field; AutoCAD/COM objects, including nested objects, are rejected. Only inline synchronous snippets are supported: async/await and #load directives are rejected before execution. Do not move AutoCAD API calls to Task.Run or other threads. Use System.Console.WriteLine for stdout output. Execution has cooperative 30s cancellation. An active drawing is required: when none is open, use dwg_list_recent_drawings and dwg_open_drawing first; the host refuses before executing code. doc, db and ed are supplied from that active drawing. Put database writes in one using transaction from db.TransactionManager.StartTransaction(), and Commit only after validation succeeds. Return host warnings and handled errors in your DTO. AutoCAD UNDO can reverse drawing edits; filesystem writes are outside it, and the gateway does not roll back earlier committed transactions after a later script error. Default namespaces: System, System.Collections.Generic, System.Linq, Autodesk.AutoCAD.ApplicationServices, Autodesk.AutoCAD.DatabaseServices, Autodesk.AutoCAD.EditorInput, Autodesk.AutoCAD.Geometry. Large result/stdout is stored as complete UTF-8 JSON before the 10 MiB plugin cutoff, with output_artifact path/bytes/SHA-256/preview when storage permits. The final MCP budget may store a second artifact of the full MCP result it received; inspect scope and upstrea…

Bind this gateway to one AutoCAD instance. A different bound instance requires pid:<PID> or id:acad-<year>-<PID>; an initial year must be unambiguous. verify=true (default) authenticates health and confirms the current drawing before allowing writes. verify=false permits reads only. Without rebind=true, selecting the same process preserves its drawing lifetime pin, including with verify=false. expected_document_id explicitly sets that pin, even without verification. Leaving a live confirmed instance requires rebind=true. A changed drawing must match an explicit expected_document_id or be intentionally accepted with rebind=true. Failed verification preserves the previous binding. Inspect health after opening/switching drawings before accepting a new pin. Unavailable in --read-only. Changes routing only; never activates, saves or closes drawings. Calls pending under an older binding are refused before sending.

PREFERRED translation tool. Writes translated text back to AutoCAD. Input is a JSON array of {id, new_text, render_mode?, width_policy?} where id matches a cluster from dwg_get_selected_texts. The tool handles everything automatically: anchor selection, fragment deletion, MText conversion (when safe), Unicode font style, and height scaling. Optional render_mode='mtext' lets the caller force a safe single DBText or top-level cluster to end up as MText. Simply provide the translated text for each cluster. If a cluster needs no translation (pure numbers, elevation markers), omit it - the tool will still apply the Unicode style to it. Per-cluster response includes an 'action' field: update | collapse | rewrite_in_block | style_only. final_text_height measures the resulting entity's stored height after normalization/scaling, or null if unavailable; style_only reports the anchor and block definitions use local units. Workflow: dwg_get_selected_texts -> translate each cluster -> dwg_translate_and_rewrite. Use dwg_collapse_and_rewrite (low-level) only for expert control or replaying call-log scenarios. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Write new text to AutoCAD entities identified by handle. Input is a JSON array of {handle, new_text} objects. Returns per-item {handle, ok, error} - failures do not abort siblings. Handles are hex strings as returned by dwg_get_selected_texts. All items are written in a single transaction so one Ctrl+Z undoes the batch. If applyUnicodeStyle=true, the same call also reassigns successfully updated entities to the Unicode text style. Changes the current drawing; use AutoCAD UNDO immediately to reverse drawing edits before saving. Disabled in read-only mode.

Zoom to the extents of the drawing viewport.

Zoom viewport to the extents of a specific drawing entity identified by handle.

Zoom viewport to a window defined by two corner points.