CAD Agent Foundation

CAD Agent Foundation — AutoCAD MCP & CLI for AI Agents

Current field release: 1.2.0-beta.3.18 adds local CTB controls, transient window PDF output and field reliability fixes. Validation and limits. Earlier milestones below remain historical.

Public runtime preview v1.2.0-beta.3. Proxy/compound geometry and text reads, bounded native views/captures, raster-path repair, rejection classification and polyline-width fixes. Reuses the accepted beta.3 binaries; scope, known capture limitations and upgrade notes.

Optional road interpretation: Agentic Map Tracing v0.1.0-beta.1. The Agent reasons about boundaries; Foundation supplies CAD execution. Install separately.

First priority: reliable operations for increasingly capable agents

Foundation development supports the real task. Provide small, reliable, controlled CAD primitives and truthful feedback so the Agent can act and move forward. The Agent owns visual judgment, structure interpretation, example learning, pattern recognition and final review. Do not turn those judgments into programs, fitting algorithms or compulsory verification workflows. Do not add incidental features unless explicitly requested. When current primitives suffice and the Agent judges the result acceptable, continue the main task. Preserve drawing identity, source protection and no replay of unknown writes.

Local unit closeout: 1.2.0-local.4 carries prior bounded primitives, makes INSUNITS consistency optional for raw-coordinate plans and retains the legacy metres interface. This prerelease is published as v1.2.0-local.4; earlier releases remain available. See units, precision and paper typography; this is not blanket A–P certification.

Agent-first AutoCAD MCP — built for the execution loop, not just command calls. CAD Agent Foundation helps AI agents bind the right drawing, track each request, receive execution feedback, verify what was written or saved, and continue multi-step CAD work with confidence. Independent or third-party CAD Skills can reuse this execution foundation for their own professional workflows.

中文简介：面向 AI Agent 的 CAD 执行底座——不止调用命令，还关注图纸绑定、执行反馈、结果核验与安全续作，可与第三方专业 Skill 组合使用。

While CAD integrations connect AI to drawing commands and data, Foundation focuses on the agent workflow around each operation: knowing what was requested, what actually happened, and whether the next step is safe.

Public runtime preview v1.2.0-beta.3. Release and upgrade notes. Source, documentation and a manifest-bearing Windows runtime ZIP are provided in this preview. Build prerequisites and limits. The accepted local runtime v1.0.0-local is a separate baseline. Companion Skill previews are published independently: callout v0.3.0-rc.1 and distress v0.1.0-rc.1.

简体中文 · Quick start · Capabilities · Compatibility

Registered MCP server: io.github.capskov/cad-agent-foundation. MCPB installation and discovery · Registry metadata. Local Windows/AutoCAD prerequisites still apply; registration does not grant drawing access.

AutoCAD automation bridge for AI agents via MCP and CLI, using a native .NET API.

AI agents can inspect and operate a live AutoCAD drawing through structured native tools for bounded 2D geometry, text, hatches and callouts. The bridge uses MCP (Model Context Protocol) and CLI; drawing identity checks and write/save verification govern the supported operations.

CAD Agent Foundation gives CAD agents a bounded execution contract: explicitly bind a drawing, persist request ownership and execution state, inspect the original request after an uncertain reply, and verify tracked object facts after writes and saves. The current implementation integrates these mechanisms into a modified, pinned Bimwright DWG MCP host.

This Windows/AutoCAD bridge is maintained by capskov. The current preview is v1.2.0-beta.3, with an independently built runtime ZIP and scoped native evidence. The accepted v1.0.0-local baseline is retained; compatibility with every AutoCAD update is not claimed.

Why this project exists

The project grew out of road and civil-engineering CAD work: creating boundaries, fills, quantities and linked callouts, then revising and saving them over a long agent session. A useful drawing command is only part of that workflow. The agent also needs to know which drawing it owns, whether a modification has already happened, what remains unverified, and whether another attempt would duplicate it.

The design focuses on those decisions. Durable records, drawing identity and native readback add overhead; no comparative speed, token-cost or productivity advantage has been established. Engineering judgment and domain-specific layout rules remain in separate Skills.

Native operations and installation

Download v1.2.0-beta.3 runtime, verify SHA256SUMS.txt and extract the complete folder. Requires licensed compatible Windows x64 AutoCAD 2026, .NET 8 Desktop Runtime and Python 3.11+. No Autodesk assemblies or SHX fonts are redistributed. Installation · 25-operation catalog · New validation.

New in this preview: installed-font text styles, dimension styles, native linear/aligned/radius/diameter DIMENSION, layer state management, guarded closed-boundary/hatch continuation, linked callout geometry/format, and same-drawing rotate/scale/copy of supported complete groups. It preserves original-request reconciliation and drawing/object protection.

Current capability overview

Maturity: the bounded local runtime has native acceptance evidence; The release provides a runtime ZIP with dependency licenses, file hashes and plugin MVID; prerequisites remain separately installed. Support follows the actually exposed profile.

Full interfaces, invocation and per-item verification status. Foundation supplies reusable native operations, execution constraints, status and object management. Independently maintained Skills supply domain rules, style parameters, placement algorithms and workflows through actual supported Foundation interfaces. Missing native/backend compatibility is not supplied merely by installing a Skill.

Execution contract

Bind the intended drawing and verify process/session/plugin identity. Persist a stable request before submission; after an uncertain reply, query that original request. Existing edits need fresh native digests and complete associations. Confirm effects, independent readback and fence release separately; save covers the whole working drawing. See architecture and versioned interface catalog.

Choose components by task

The two Skills are optional for basic operations. Their rules are not built into Foundation; installing them does not add missing native operations. Foundation source and both independent Skill previews are public. Installation entries, versions and Agent checks.

Quick start

The commands below use the extracted runtime ZIP. Source checkout alone requires build/packaging first.

foundation.cmd install --workspace "C:\CAD-work\demo01"

foundation.cmd start --workspace "C:\CAD-work\demo01" --source "C:\drawings\input.dwg" --write foundation.cmd doctor --workspace "C:\CAD-work\demo01" foundation.cmd apply --workspace "C:\CAD-work\demo01" --plan "plan.json" foundation.cmd save --workspace "C:\CAD-work\demo01" --handles RETURNED_HANDLES foundation.cmd stop --workspace "C:\CAD-work\demo01"

Omit --write for a read-only session. start creates a working copy; it does not overwrite the source drawing. Save affects the entire working drawing, including other unsaved edits in that instance. Read the quick start for request handling and a small synthetic plan.

Verification and scope

The local release was checked on two different drawing sources, with different coordinates and handles. Each workflow created ten new objects, read them independently, updated linked text, moved the complete callout group, archived it, saved and closed the drawing. Fresh CAD sessions then read the saved objects with matching native digests. The CLI/MCP entry and local package extraction/installation were also checked.

These are bounded workflow results on a recorded Windows AutoCAD 2026 environment. They do not prove universal drawing correctness, production-wide reliability, compatibility with every patch, or a general CAD engineering agent. The validation summary separates native evidence from offline tests and records unresolved historical outcomes honestly.

Current limits

Plans write bounded 2D model-space geometry. Coordinates, lengths and annotation sizes are expressed in drawing units. WCS is the CAD coordinate reference; i