AutoCAD MCP Pro
Production-grade AutoCAD automation for AI agents. Live through COM on Windows, or headless through ezdxf anywhere — one typed contract, two engines.
Install · What's new · Tools · Engines · Evidence · Limits · Config · Changelog
Not a mockup. Every line on this sheet was drawn by the tools this server exposes — ISO layers, involute gear geometry, DIN 6885 keyway, section A-A, ISO 129 dimensions, an ISO 286 H7 bore fit, ISO 7200 title block — then rendered headlessly by view_screenshot. drawing_critique returns 0 issues on it. Rebuild it with python scripts/render_readme_showcase.py.
v1.6 release snapshot: 247 tools · 8 resources · 5 prompt templates · 4992 collected tests. 247 is the registered count; a default install advertises 242 over
tools/list, becauseENABLE_3Dis unset.system_aboutis the runtime authority.
What's new in 1.6
Five tracks of one roadmap, 154 → 247 registered tools. Each track has its own design spec, correctness checks that can fail, and a live AutoCAD 2026 run of its COM paths recorded in the changelog.
| Track | What it adds | Pack |
|---|---|---|
| P&ID — drafter and reader | 43 ISO 10628-2 / ISA-5.1 symbols as real blocks with ports and TAG attributes, port-to-port lines with ISA-5.1 classes and line numbers, pid_graph reading any P&ID back with a confidence per node, instrument index, line list, equipment list, pid_from_spec for a whole sheet in one transaction |
pid |
| The AutoCAD environment | ISO-25 / ANSI dimension styles, text and leader styles, drawing_apply_standard, ISO 216 / ANSI page setups checked against the plotted PDF's own /MediaBox, five bundled templates, several open documents headlessly, portable layer states, named views, UCS, a 90-entry system-variable catalogue; on a live seat, preferences, launch and operator prompts |
core, settings |
| Mechanical parts and the sheet | one part model and one view engine (front, side, top, section and detail views with hidden lines, cut faces and ISO 129 dimensions), ISO fasteners and bearings as blocks with attributes, ISO 21920-1 surface texture, ISO 2553 welds, ISO 5457 frames A4–A0, ISO 7200 title blocks, an ISO 7573 parts list read off the drawing with linked ISO 6433 balloons, xrefs, images, real .dwg |
mech, core |
| Architecture | walls with hosted doors and windows: one engine resolves L / T / X junctions and cuts the openings. Room areas are measured from the faces the walls enclose, and rooms are read back from any plan. Door / window / room schedules are real tables; labels in English or Turkish | arch |
| Understanding and takeoffs | drawing_understand reads a drawing somebody else made in one call. Also drawing_scale_check, drawing_diff and drawing_topology_check. pipe_takeoff / cable_takeoff take the topology from the P&ID and the lengths from the layout into a Turkish, English or Russian workbook |
core, plant |
TOOL_PACKS keeps a client from paying for the tracks it does not use (idle cost below).
A mechanical sheet, gated. The mech_assembly benchmark sheet: a hub drawn from its part model with a full section and chain dimensions, a flange with its bolt-circle end view, two ISO 4014 M12×60 bolts and ISO 4032 nuts inserted as blocks, the ISO 7573 parts list read off the drawing, balloons linked to its rows, an ISO 5457 frame and an ISO 7200 title block. drawing_critique(focus=None) returns 0 issues and the finalize score is 100. Rebuild it with python scripts/render_readme_mech.py.
A floor plan whose areas nobody typed. arch_plan_from_spec's example, drawn in one transaction: a 250 mm brick ring split by a 100 mm AAC wall, two doors, two windows, a straight stair and exterior dimension chains at 1:50. The rooms measure 27.74 and 21.99 m², read from the faces the walls enclose, and the door, window and room schedules are read off the drawing. drawing_critique(focus=None) returns 0 issues. Rebuild it with python scripts/render_readme_arch.py.
The same server as a P&ID drafter. pid_from_spec placed five catalogue symbols as real blocks with TAG attributes and named ports and routed four port-to-port lines with ISA-5.1 classes and line numbers, all in one transaction. Then pid_graph read the sheet back: 5 nodes, 4 edges, 0 dangling ends, confidence_min 1.0. Rebuild it with python scripts/render_readme_pid.py.
The catalogue, authored in code. 43 ISO 10628-2 / ISA-5.1 symbols: 11 valve bodies × 6 actuators, 6 rotating machines, 4 heat exchangers, 6 parametric vessels, 7 inline items, the instrument bubble in 4 types × 5 locations, 5 line markers and 3 connectors. Every one was placed through pid_symbol_insert's own path. Rebuild it with python scripts/render_pid_catalog.py.
Why this exists
A big MCP server is expensive to be connected to. The full catalog costs a client 83,921 tokens before it has asked for anything. Discovery mode replaces it with two tools and costs 356.
A drafter searches for FILLET, not entity_fillet. Before the corpus, those command names appeared in no tool name or description. That was df = 0 against a stock index: the tools were not ranked badly, they were absent. The fix was data: an authored corpus of 206 AutoCAD command names and 1439 synonym phrases covering all 247 tools. A test refuses to let a tool exist without one.
| Advertised surface | Tools seen | Idle cost |
|---|---|---|
TOOL_PROFILE=full (default) |
242 | 83,921 tokens |
TOOL_PACKS=core,settings (full profile) |
205 | 63,890 tokens |
TOOL_PACKS=core,mech (full profile) |
197 | 64,836 tokens |
TOOL_PACKS=core,arch (full profile) |
195 | 63,549 tokens |
TOOL_PACKS=core,pid (full profile) |
192 | 60,844 tokens |
TOOL_PACKS=core,plant (full profile) |
185 | 59,290 tokens |
TOOL_PACKS=core (full profile) |
183 | 57,122 tokens |
TOOL_PROFILE=lean |
65 | 22,661 tokens |
DISCOVERY_MODE=search |
2 | 356 tokens |
[!NOTE] These are offline ratio estimates, not tokenizer counts, and they are the uncached cost: prompt caching amortises the idle term.
benchmarks/token_suite.py --tokenizer anthropiccounts for real.
Install
pip install autocad-mcp-pro # or: uvx autocad-mcp-pro
autocad-mcp # stdio MCP server, backend auto-selected
AUTOCAD_MCP_BACKEND=ezdxf autocad-mcp # portable DXF engine, no AutoCAD needed
AUTOCAD_MCP_BACKEND=com autocad-mcp # live AutoCAD (needs the [com] extra)
| Extra | Pulls in | For |
|---|---|---|
| (none) | fastmcp, ezdxf, pydantic |
Headless DXF on any OS — no rendering |
[com] |
pywin32, Pillow |
Live AutoCAD control + window capture |
[pdf] |
matplotlib |
PDF export and headless PNG, any platform |
[office] |
openpyxl |
XLSX workbooks (takeoffs, data_extract); CSV is |