Skip to main content
Glama
AutoCAD MCP Pro

AutoCAD MCP Pro

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ENABLE_3DNoExpose the opt-in `solid_*` tools (COM).false
LOG_LEVELNoPython logging level.INFO
READ_ONLYNo`true` runs only `read` tools and writes no file; anything else is refused `policy_refused` before it runs.false
CAD_LAUNCHNoWhether 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_PROGIDNoCOM ProgID the live backend attaches to.AutoCAD.Application
TOOL_PACKSNoVertical packs to advertise: `core,pid,settings,mech,arch,plant` (`core` always on).all
LISP_POLICYNoHow `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_BACKUPNo`1` copies the previous file to `<name>.bak` before a headless save replaces it.off
JOURNAL_ARGSNoWhat 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_SYNCNosqlite `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_PROFILENo`lean` (67 curated tools, 57 with `TOOL_PACKS=core`) or `full`.full
ALLOWED_PATHSNoComma-separated absolute paths the server may access.
MAX_DXF_BYTESNoReject larger DXF input (512 MB); `0` disables.536870912
MAX_TOOL_COSTNoThe 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_DENYLISTNoComma-separated tool names or globs that are neither advertised nor callable.
DISCOVERY_MODENo`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_LIMITNoBound list/selection response sizes.5000
MAX_SPEC_ITEMSNoItems per list of a `pid_from_spec` / `arch_plan_from_spec` document; `0` disables.2000
MAX_UNDO_STACKNoMaximum retained undo snapshots.5
MCP_AUTH_TOKENNoBearer token required for remote HTTP; scopes `mcp:read` and `mcp:write`.
SHUTDOWN_GRACENoSeconds shutdown waits for a worker still inside a call before exiting without it; `0` does not wait.5
TOOL_ALLOWLISTNoComma-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_KEEPNoCheckpoints kept per drawing lineage besides its first (S0); older ones are evicted (listed with `evicted: true`, restoring one is refused `checkpoint_evicted`).20
JOURNAL_DURABLENo`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_ENTITIESNoRefuse 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_TIMEOUTNoPer-call live AutoCAD timeout (s); `0` disables.60
COM_REFRESH_MODENo`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_TTLNoSeconds 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_PINNEDNoComma-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_DEPTHNoHeadless 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_TRAYSNoTrays a parametric column may carry; `0` disables.500
ACADMCP_STATE_DIRNoThe 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_HTTPNoPermit a non-loopback HTTP bind (which also needs a token and `ALLOWED_PATHS`).false
ACCORECONSOLE_PATHNoThe `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_SOURCENoSet 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_SNoHow 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_TIMEOUTNoPer-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_HOSTSNoHost headers accepted besides the bound host:port and the loopback names; any other is refused 421. `*` allows all.
AUTOCAD_MCP_BACKENDNoWhich engine to run: `auto`, `com`, or `ezdxf`.auto
JOURNAL_RETAIN_DAYSNoJournal rows older than this are dropped when the store opens.30
MAX_HTTP_BODY_BYTESNoAn HTTP request body over this (8 MiB) is refused 413, counted on chunked bodies too; `0` disables.8388608
CHECKPOINT_BUDGET_MBNoThe checkpoint disk budget across lineages: the least recently written lineage, oldest checkpoint first, is evicted, never the one just written.512
HTTP_ALLOWED_ORIGINSNoOrigins 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_DISCOVERYNoSets the plugin's `DISCOVERY_MODE` (default `search`); set `off` for the full catalog.
CHECKPOINT_MAX_DOC_MBNoThe most checkpoint bytes one lineage keeps.32
JOURNAL_RESULT_MAX_KBNoA client id's answer above this keeps only its sha256 and replays as `result_truncated: true`.64
COM_REFRESH_UPDATE_MAXNoA 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_SNoOne 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_READONLYNoA 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_ENABLEDNoAllow 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

NameDescription

No tools

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources