AutoCAD MCP Pro
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ENABLE_3D | No | Expose the opt-in `solid_*` tools (COM). | false |
| LOG_LEVEL | No | Python logging level. | INFO |
| READ_ONLY | No | `true` runs only `read` tools and writes no file; anything else is refused `policy_refused` before it runs. | false |
| CAD_LAUNCH | No | Whether the live engine may start the CAD application when none is running: `auto` attaches, else starts it (and quits an instance it started that never accepts `Visible`); `never` attaches only, and the first call and `system_launch` answer `cad_not_running` instead. An unknown value stops the server at startup. | auto |
| CAD_PROGID | No | COM ProgID the live backend attaches to. | AutoCAD.Application |
| TOOL_PACKS | No | Vertical packs to advertise: `core,pid,settings,mech,arch,plant` (`core` always on). | all |
| LISP_POLICY | No | How `system_run_lisp` checks an expression (live only): `read` runs the AutoLISP read tier and sends the rest to the 1.7 denylist, `denylist` is the 1.7 behaviour, `off` checks nothing. An unknown value falls back to `read` with a warning. | read |
| SAVE_BACKUP | No | `1` copies the previous file to `<name>.bak` before a headless save replaces it. | off |
| JOURNAL_ARGS | No | What a journal row keeps of the arguments: `bounded` (canonical JSON up to 4,096 bytes), `digest` (sha256 only; answers kept as a hash too) or `off`. | bounded |
| JOURNAL_SYNC | No | sqlite `synchronous`: `normal` loses nothing on a process kill; `full` also covers an OS crash or power loss, at about 30x the cost per commit. | normal |
| TOOL_PROFILE | No | `lean` (67 curated tools, 57 with `TOOL_PACKS=core`) or `full`. | full |
| ALLOWED_PATHS | No | Comma-separated absolute paths the server may access. | |
| MAX_DXF_BYTES | No | Reject larger DXF input (512 MB); `0` disables. | 536870912 |
| MAX_TOOL_COST | No | The highest tool cost a call may carry: `read`, `safe`, `mutate`, `destructive` or `escape`. A file write is `mutate` whatever its tool is labelled. | escape |
| TOOL_DENYLIST | No | Comma-separated tool names or globs that are neither advertised nor callable. | |
| DISCOVERY_MODE | No | `search` (the default since 1.8.0) lists `search_tools` + `call_tool` + `describe_tool` and the `DISCOVERY_PINNED` tools, and every tool stays callable by name; `off` advertises the full catalog (the 1.7 default). An unknown value falls back to `off` with a warning. | search |
| MAX_LIST_LIMIT | No | Bound list/selection response sizes. | 5000 |
| MAX_SPEC_ITEMS | No | Items per list of a `pid_from_spec` / `arch_plan_from_spec` document; `0` disables. | 2000 |
| MAX_UNDO_STACK | No | Maximum retained undo snapshots. | 5 |
| MCP_AUTH_TOKEN | No | Bearer token required for remote HTTP; scopes `mcp:read` and `mcp:write`. | |
| SHUTDOWN_GRACE | No | Seconds shutdown waits for a worker still inside a call before exiting without it; `0` does not wait. | 5 |
| TOOL_ALLOWLIST | No | Comma-separated tool names or globs (`entity_*`); only these are advertised and callable. An entry naming no tool is warned about at startup (`system_about.policy.unmatched`). | |
| CHECKPOINT_KEEP | No | Checkpoints kept per drawing lineage besides its first (S0); older ones are evicted (listed with `evicted: true`, restoring one is refused `checkpoint_evicted`). | 20 |
| JOURNAL_DURABLE | No | `off` keeps the operation journal in memory only (the 1.7 behaviour: a restart forgets every operation id) and takes no checkpoints: the checkpoint tools are refused `checkpoints`, and the headless `drawing_undo` needs `EZDXF_UNDO_DEPTH` again. | on |
| MAX_QA_ENTITIES | No | Refuse a QA read (critique, validator, finalize, deliver) of a larger drawing with `scan_incomplete`; `0` disables, a negative value is refused at startup. | 2000000 |
| COM_CALL_TIMEOUT | No | Per-call live AutoCAD timeout (s); `0` disables. | 60 |
| COM_REFRESH_MODE | No | `regen` forces one `Regen` per live job (for a graphics setup where `Update()` does not paint). An unknown value falls back to `auto` with a warning. | auto |
| COM_SNAPSHOT_TTL | No | Seconds a live `entity_get` on a DIMENSION / HATCH reuses its whole-drawing `Document.Export` (counted from when the export returned) while the document's revision and operator-edit count stand still; `0` exports on every read. | 5 |
| DISCOVERY_PINNED | No | Comma-separated tools search mode lists directly, as shortened cards (full input schema; `describe_tool` returns the whole description). Empty pins nothing; a pin the profile or packs hide is not listed, an unregistered name is warned about at startup. | cad_batch,drawing_info,entity_list |
| EZDXF_UNDO_DEPTH | No | Headless per-call undo steps (a full DXF snapshot per mutating call), used before the durable checkpoints; `0` leaves undo to the checkpoints. | 0 |
| MAX_VESSEL_TRAYS | No | Trays a parametric column may carry; `0` disables. | 500 |
| ACADMCP_STATE_DIR | No | The operation journal, pending-save markers, file lineage, durable checkpoints (`docs/<lineage_id>/cp/`) and the `accoreconsole` staging folder. A folder inside a repository checkout or one holding drawings is refused at startup and the journal runs in memory (`system_status.state_store.degraded`). | %LOCALAPPDATA%\autocad-mcp-pro\state ($XDG_STATE_HOME/autocad-mcp-pro elsewhere) |
| ALLOW_REMOTE_HTTP | No | Permit a non-loopback HTTP bind (which also needs a token and `ALLOWED_PATHS`). | false |
| ACCORECONSOLE_PATH | No | The `accoreconsole.exe` the headless `drawing_open` converts a `.dwg` with, after the ODA File Converter. Unset uses AutoCAD 2026's installed console when it exists; `off` disables the route. | |
| AUTOCAD_MCP_SOURCE | No | Set to a checkout (e.g. `C:/path/to/Autocad-MCP[com,pdf,office]`) to have the Claude Code plugin run that code instead of the pinned PyPI release. | |
| COMMAND_DEADLINE_S | No | How long a command sent to AutoCAD's command line (`system_run_command`, live undo / redo, corner operations, the transaction mark) may stay active; past it AutoCAD's `LASTPROMPT` is read, ESC is sent three times and the call fails `command_incomplete`. | 8 |
| EZDXF_CALL_TIMEOUT | No | Per-call headless timeout (s). A read that overruns is never quarantined: until it ends, other calls on its document are refused by name (`kind: "busy"`) while `drawing_open` / `drawing_new` / `drawing_close` / `document_activate` / `document_close` and `document_list` go through without waiting for it. `0` disables the timeout: a call that never ends keeps the document. | 120 |
| HTTP_ALLOWED_HOSTS | No | Host headers accepted besides the bound host:port and the loopback names; any other is refused 421. `*` allows all. | |
| AUTOCAD_MCP_BACKEND | No | Which engine to run: `auto`, `com`, or `ezdxf`. | auto |
| JOURNAL_RETAIN_DAYS | No | Journal rows older than this are dropped when the store opens. | 30 |
| MAX_HTTP_BODY_BYTES | No | An HTTP request body over this (8 MiB) is refused 413, counted on chunked bodies too; `0` disables. | 8388608 |
| CHECKPOINT_BUDGET_MB | No | The checkpoint disk budget across lineages: the least recently written lineage, oldest checkpoint first, is evicted, never the one just written. | 512 |
| HTTP_ALLOWED_ORIGINS | No | Origins an HTTP request may carry; any other Origin is refused 403. A browser-based MCP inspector needs its own origin listed (e.g. `http://localhost:6274`); `*` allows all. | |
| AUTOCAD_MCP_DISCOVERY | No | Sets the plugin's `DISCOVERY_MODE` (default `search`); set `off` for the full catalog. | |
| CHECKPOINT_MAX_DOC_MB | No | The most checkpoint bytes one lineage keeps. | 32 |
| JOURNAL_RESULT_MAX_KB | No | A client id's answer above this keeps only its sha256 and replays as `result_truncated: true`. | 64 |
| COM_REFRESH_UPDATE_MAX | No | A live job that asked for at most this many display refreshes, each naming its entity, calls `Update()` on the last one; a larger job does one `Regen`. `0` makes every job Regen. | 1 |
| ACCORECONSOLE_TIMEOUT_S | No | One DWG -> DXF conversion's deadline (kept inside `EZDXF_CALL_TIMEOUT`); an overrun kills the console's process tree. Must be a number above 0. | 60 |
| MCP_AUTH_TOKEN_READONLY | No | A second bearer token with only `mcp:read`: its requests run under the `read` ceiling and see only read tools. Alone it also enables auth. | |
| DANGEROUS_COMMANDS_ENABLED | No | Allow blocked commands/LISP; reported as unsafe mode. | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
No tools | |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
This server cannot be deployed
Maintenance
ActivityActive
ResponsivenessOutdated data