BricsCAD MCP
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@BricsCAD MCP Open the site plan DWG and list any empty layers or unused blocks"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
BricsCAD MCP
An MCP server that lets Claude, or any MCP client, read, audit, edit, plot and export drawings in BricsCAD, one at a time or in batches. It starts its own BricsCAD window and controls it through a small LISP listener, so it works at every licence level, including Lite, and doesn't need Windows COM.
Status: all four phases are built: reading and auditing, drawing and editing, plotting and export, and batch jobs.
Platform support
Platform | Server logic tests | Real BricsCAD tests | Status |
macOS | CI | Passed on V26.1.6 Lite | Supported |
Windows | CI | Passed on V25 Lite | Supported |
Linux | CI | Not run: no test machine yet | Experimental |
A platform becomes Supported only when the real BricsCAD tests pass on it. CI has no BricsCAD.
The plot, export and batch tools (bricscad_export_dxf, bricscad_plot_pdf, bricscad_preview_image,
bricscad_batch_run) have so far passed them on macOS only; on Windows they are untested.
The Linux install location is unverified, so set BRICSCAD_EXECUTABLE if yours is not found.
Related MCP server: AutoCAD 2024 MCP
Install
You need BricsCAD in every case.
Claude Desktop
Download the bundle for your computer from the latest release and open it:
macOS with Apple silicon:
bricscad-mcp-<version>-darwin-arm64.mcpbWindows:
bricscad-mcp-<version>-win32.mcpb
The bundle brings its own Python, so there is nothing to install first. Its settings let you pick a
BricsCAD version, or point to the program if it isn't found. On an Intel Mac, use the uvx setup
below.
Claude Code, Codex and other clients
These run the server from PyPI with uv, so install uv first.
Claude Code:
claude mcp add bricscad -- uvx bricscad-mcpCodex (the CLI, the IDE extension and the ChatGPT desktop app share this setting):
codex mcp add bricscad -- uvx bricscad-mcpCursor, VS Code, Windsurf and other clients that take an mcpServers entry:
{
"mcpServers": {
"bricscad": {
"command": "uvx",
"args": ["bricscad-mcp"],
"env": { "BRICSCAD_VERSION": "26" }
}
}
}env is optional. See Environment variables.
On a network that inspects HTTPS
Some office networks check HTTPS traffic with their own certificate. uv then can't download from
PyPI unless it uses the system's certificates, and the first start fails with
invalid peer certificate: UnknownIssuer, which a client may only report as a closed connection.
Setting UV_SYSTEM_CERTS in your shell isn't always enough, because some clients start servers
with only a few environment variables. Set it on the server entry instead:
claude mcp add -e UV_SYSTEM_CERTS=1 bricscad -- uvx bricscad-mcpcodex mcp add bricscad --env UV_SYSTEM_CERTS=1 -- uvx bricscad-mcpIn an mcpServers entry, add "UV_SYSTEM_CERTS": "1" to env. The Claude Desktop bundle downloads
nothing, so it doesn't need this.
From source
git clone https://github.com/alesdev88/bricscad-mcp.gitcd bricscad-mcp && uv syncThen register it, using the full path to your copy:
claude mcp add bricscad -- uv --directory "/full/path/to/bricscad-mcp" run bricscad-mcpTools
Tool | What it does |
| Lists installed versions |
| Starts or closes the server's own BricsCAD |
| Reports whether it's running, listener health and the current drawing |
| Opens a DWG or DXF (read-only by default), or closes it |
| Name, path, state, units, entity count, layouts, and the limits and extents of the current layout |
| Lists what's in the drawing |
| Finds entities by type, layer, block, layout or bounding box |
| Returns all DXF values for one entity |
| Reads block attributes, such as title block contents |
| Searches TEXT, MTEXT, MULTILEADER, table cell and attribute text |
| Empty layers, unused blocks, missing xrefs, raised entities, off-standard layer names |
| Draws lines, polylines, circles, arcs, text, MTEXT, dimensions, hatches and block inserts |
| Moves, rotates, scales, or changes layer, color, linetype or text |
| Erases entities by handle |
| Creates or changes a layer |
| Sets block attribute values, such as title block contents |
| Undoes edit tool calls, one step each |
| Saves to a new path, or over the open file with |
| Writes the drawing as DXF, R12 or 2000 to 2018 |
| Plots the model or a sheet to PDF, with paper, orientation, area, scale and plot style |
| Returns a PNG of the model, a sheet or a window, so the client can check its work |
| Runs one job on up to 500 drawings: audit, find text, export DXF, plot PDF (one sheet or every sheet), save copies, or LISP code |
| Runs LISP for anything the other tools don't cover |
List tools take limit and offset and report total. The default limit is 200 and the maximum
is 2000.
Good to know
One copy per version.
bricscad_startrefuses if that BricsCAD version is already running, because a second copy of the same version doesn't start its listener. Close it first, or choose another version withBRICSCAD_VERSION.The window is occupied. While the listener runs, its BricsCAD window isn't meant for hand use, and it may not show the open drawing. Trust the tools, not the window. Draw in a copy of another version, or stop the server first.
Dynamic blocks go by their own name. Their inserts are stored under anonymous names such as
*U12. Block filters, insert counts and attribute results use the name you know.bricscad_run_lispis powerful. LISP can change or delete files and start programs, so every call goes through your client's tool approval.Timeouts. If a dialog blocks BricsCAD, the call fails after its timeout (30 seconds by default) and says to check the window.
Batches. Run
bricscad_batch_runwithdry_run=truefirst to see what it would do. A failed file doesn't stop the batch, but a timeout does, because a dialog may be blocking BricsCAD. Afterwards the current drawing may be another open drawing. A batch takes up to 500 drawings per call.
Safety
Drawings open read-only by default.
Closing or stopping refuses if there are unsaved changes, unless you pass
discard=true.bricscad_stoponly ever closes the copy this server started.If the client exits, a copy with nothing unsaved closes by itself. A copy with unsaved work stays open so you can save it.
The server doesn't permanently change BricsCAD settings.
Each edit tool call is all-or-nothing and one undo step. Edits made through
bricscad_run_lisphave no step of their own, so they go back with the step before them.Entities on locked layers are refused, and missing layers are never created by drawing on them.
Saving over an existing file needs
overwrite=true, and the server checks that before BricsCAD is involved. A read-only drawing can only be saved to a new path, a file open as another drawing or marked read-only is never replaced, and a replaced file leaves a.bakbeside it.Exporting, plotting and previews never change the drawing, not even its modified state. They refuse an existing file without
overwrite=true, never write over an open drawing, and replace a file only once the new one is complete, with no.bak.Batch jobs open their drawings read-only and never write them unless the output folder is their own folder and
overwrite=true. Drawings already open in BricsCAD are refused, and each output replaces a file only once it is complete, with no.bak. Code in alispjob can still save anywhere itself, as withbricscad_run_lisp.
Environment variables
Variable | Purpose |
| The version to start, for example |
| Full path to BricsCAD, if it isn't found automatically |
Known limits
So far it has only been tested on drawings its tests created. Real project drawings may bring up dialogs that haven't been seen yet, such as missing fonts or proxy objects.
vla-saveopens a dialog andvla-saveasfails on macOS, so use_.QSAVEand_.SAVEASin LISP.On Windows, BricsCAD's LISP holds text in the Windows code page (
SYSCODEPAGE), not Unicode. Slovenian and other text in that code page works. LISP would turn characters outside it, such as Chinese on a Central European system, into?, so the server refuses any call that contains them and names each one. It detects the code page when it starts BricsCAD.Don't close the only open drawing with your own LISP, because the listener stops.
bricscad_close_drawinghandles this for you.PDFs are plotted with
Print As PDF.pc3only. Paper sizes go by BricsCAD's own name, such asISO A3 (297.00 x 420.00 MM); an unknown name is reported, not guessed.Previews are the size of the BricsCAD window, and the model shows on black, as on screen.
Development
uv run pytestThese tests need no BricsCAD. To run the real tests, close that version of BricsCAD first. They open one copy at a time and use only temporary drawings:
uv run pytest -m bricscadPassing them on Windows or Linux is what moves that platform to Supported.
Design and test results are in docs/: start with docs/superpowers/specs/2026-11-06-bricscad-mcp-design.md
and docs/phase-0-results.md.
Releasing
Set the new version in
pyproject.toml,manifest.jsonandserver.json, then runuv lock. A test checks that the three agree, and thatmanifest.jsonlists every tool.Push a tag for it, such as
v0.1.0. Thereleaseworkflow tests the commit, checks a fresh install of the wheel, builds both bundles, creates the GitHub release, publishes to PyPI and then to the MCP registry.Install each bundle on its platform before announcing the release. CI can't start them.
To build a bundle locally, uv run python scripts/build_bundle.py --target darwin-arm64 (or win32
or all). It needs Node for the mcpb packer; --no-pack stops before packing and leaves the
unpacked bundle in build/.
PyPI publishing needs a trusted publisher on pypi.org for this repository, workflow publish.yml,
environment left blank.
Available Tools
28 toolsbricscad_audit_reportARead-only
Report empty layers, unused blocks, missing xrefs, entities not at zero elevation, and off-standard layer names.
Each section has a total count and up to sample_limit items. Blocks and layers used only
inside other blocks count as used, and a dynamic block counts as used through its anonymous
states. Layers 0 and Defpoints are never reported.
allowed_layers: name patterns such as ["A-", "S-"], ignoring case. Leave it out to skip this check.
Inputs: timeout, sample_limit, allowed_layers. Returns: object
bricscad_batch_runADestructive
Run one job on many drawings, one at a time, and report a result per file. Try dry_run first.
job: {"type": ...} with its options. audit and find_text write nothing. export_dxf, plot_pdf (layout "*" plots every sheet to -.pdf), save_as and lisp with save=true write .dxf, .pdf or .dwg into output_folder. lisp runs code in each drawing and returns its value. files or folder: the drawings, up to 500. folder takes a glob pattern, and recursive for subfolders. Sources open read-only. A source is replaced only when output_folder is its own folder and overwrite=true. Drawings already open in BricsCAD are refused. timeout: seconds per file. A timeout stops the batch, since a dialog may be blocking BricsCAD. Afterwards the current drawing may be another open drawing.
Inputs: job (required), files, folder, dry_run, +5 more. Returns: object
bricscad_close_drawingADestructive
Close the current drawing. Refuses if it has unsaved changes.
discard: true closes it anyway and loses the unsaved changes.
Inputs: discard. Returns: object
bricscad_create_entitiesA
Draw entities and return their handles. Draws all of them or none, as one undo step.
entities: up to 2000 items, each with a type and an optional layer, which must exist. Points are [x, y] or [x, y, z]. Angles are degrees. layout: a sheet name. The default is the model, whichever tab is current. MTEXT takes format codes, where \P is a line break. Write a literal backslash or brace as \, { or }.
Inputs: entities (required), layout, timeout. Returns: object
bricscad_drawing_infoARead-only
Describe the current drawing: name, path, read-only and modified state, units, limits, entity count and layouts.
extents and limits describe current_layout only, which may be a sheet rather than the model.
Inputs: no named parameters. Returns: object
bricscad_erase_entitiesBDestructive
Erase entities by handle. Erases all of them or none. bricscad_undo restores them.
Refuses entities on locked layers and attributes, which belong to their block insert.
Inputs: handles (required), timeout. Returns: object
bricscad_export_dxfADestructive
Write the current drawing as a DXF file. The drawing keeps its name and state.
path: a .dxf file in an existing folder. It cannot be an open drawing. version: DXF version, R12 or 2000 to 2018. overwrite: true allows replacing an existing file. It is replaced only once the new one is complete.
Inputs: path (required), timeout, version, overwrite. Returns: object
bricscad_find_textCRead-only
Search TEXT, MTEXT, MULTILEADER, table cell and block attribute text for literal text.
A table cell comes back with its table's handle and position, plus its row and column. Up to 2000 per call.
Inputs: query (required), limit, offset, timeout, +1 more. Returns: object
bricscad_get_entityARead-only
Return one entity's type, layer and all its DXF group codes, as [code, value] pairs.
Inputs: handle (required). Returns: object
bricscad_list_blocksBRead-only
List block definitions with insert counts, including nested inserts and inserts of dynamic blocks. Up to 2000 per call.
include_anonymous: also list the anonymous blocks, such as *U12, that hold a dynamic block's states.
Inputs: limit, offset, timeout, include_anonymous. Returns: object
bricscad_list_layersBRead-only
List layers with their on, frozen and locked state, color, linetype and entity count. Up to 2000 per call.
Inputs: limit, offset, timeout. Returns: object
bricscad_list_layoutsCRead-only
List Model and the paper space layouts with their entity counts. Up to 2000 per call.
Inputs: limit, offset, timeout. Returns: object
bricscad_list_versionsARead-only
List the BricsCAD versions installed on this computer, newest first.
Inputs: no named parameters. Returns: object
bricscad_list_xrefsBRead-only
List external references with their stored path and whether the file was found. Up to 2000 per call.
Inputs: limit, offset, timeout. Returns: object
bricscad_modify_entitiesADestructive
Change entities by handle. Changes all of them or none, and refuses locked layers.
move: a displacement, [dx, dy] or [dx, dy, dz]. rotate: {"angle": degrees, "base": point}. scale: {"factor": number above 0, "base": point}. layer: an existing layer. color: 0 by block, 1 to 255, or 256 by layer. linetype: loaded from iso.lin if the drawing does not have it yet. text: new text for TEXT, MTEXT or MULTILEADER. Change attributes with bricscad_set_attributes. MTEXT and MULTILEADER text takes format codes, where \P is a line break. Write a literal backslash or brace as \, { or }.
Inputs: handles (required), move, text, color, +5 more. Returns: object
bricscad_open_drawingA
Open a DWG or DXF and make it the current drawing. Returns the same details as bricscad_drawing_info.
path: full path to the file. read_only: true by default, so the file cannot be overwritten by accident. timeout: seconds to wait. Large drawings can take a while to open.
Inputs: path (required), timeout, read_only. Returns: object
bricscad_plot_pdfADestructive
Plot one layout of the current drawing to a PDF file, with Print As PDF.pc3. The drawing is not changed.
path: a .pdf file in an existing folder. layout: "Model" or a sheet name. Defaults to the current layout. paper: BricsCAD's paper name, such as "ISO A3 (297.00 x 420.00 MM)". Defaults to the layout's current size. landscape: true or false. Defaults to the layout's current orientation. area: "extents", "layout" (sheets only) or "window". Defaults to extents for the model and layout for sheets. window: [x1, y1, x2, y2] in drawing units, with area="window". scale: "fit", or plotted millimetres to drawing units such as "1:100". Defaults to fit for the model and 1:1 for sheets. style_table: a plot style table such as "monochrome.ctb". Defaults to the layout's own. overwrite: true allows replacing an existing file. It is replaced only once the new one is complete.
Inputs: path (required), area, paper, scale, +6 more. Returns: object
bricscad_preview_imageARead-only
Return a PNG of the current drawing, to check work by eye. The drawing is not changed.
layout: "Model" or a sheet name. Defaults to the current layout. The whole layout is shown. window: [x1, y1, x2, y2] in drawing units, to show only that area. The image is the size of the BricsCAD window. The model shows on black, as on screen.
Inputs: layout, window, timeout.
bricscad_query_entitiesARead-only
Find entities in the current drawing. Returns handle, type, layer, layout and bounding box. Up to 2000 per call.
types: DXF names such as ["LINE", "CIRCLE"]. layer, block: names, which may use the wildcards * and ?. A dynamic block goes by its own name. bbox: [min_x, min_y, max_x, max_y]; entities overlapping it match. layout: "Model" or a layout name.
An entity with no extent, such as an insert of an empty block, returns a null bounding box.
Inputs: bbox, block, layer, limit, +4 more. Returns: object
bricscad_read_attributesARead-only
Read attribute values from block inserts, for example title block contents. Up to 2000 per call.
block: a block name, which may use the wildcards * and ?. A dynamic block goes by its own name. layout: "Model" or a layout name.
Inputs: block, limit, layout, offset, +1 more. Returns: object
bricscad_run_lispADestructive
Run LISP in BricsCAD and return the value of its last expression.
LISP can change or delete files and start programs, so use a dedicated tool where one exists. Do not use vla-save or vla-saveas: they open a dialog or fail. Use _.QSAVE or _.SAVEAS. Do not close the only open drawing: the listener stops.
code: one or more LISP expressions. timeout: seconds to wait for an answer.
Inputs: code (required), timeout. Returns: object
bricscad_save_drawingADestructive
Save the current drawing. Returns the same details as bricscad_drawing_info.
path: a new .dwg path. The drawing then continues under that name, and is no longer read-only. Leave it out to save over the open file, which needs overwrite=true. overwrite: true allows replacing an existing file. BricsCAD leaves a .bak beside it. A read-only drawing cannot be saved over its own file, and a file open as another drawing cannot be replaced.
Inputs: path, timeout, overwrite. Returns: object
bricscad_set_attributesADestructive
Set attribute values on block inserts, such as a title block. Changes all of them or none.
updates: [{"handle": insert handle, "values": {tag: text}}]. Get handles and tags from bricscad_read_attributes. Tags match whatever their case.
Inputs: updates (required), timeout. Returns: object
bricscad_set_layerADestructive
Create a layer, or change one that exists. Only the values you give are changed.
new_name: rename the layer. Layers 0 and Defpoints cannot be renamed. color: a color number from 1 to 255. linetype: loaded from iso.lin if the drawing does not have it yet. on, frozen, locked: true or false. The current layer cannot be frozen.
Inputs: name (required), on, color, frozen, +4 more. Returns: object
bricscad_startA
Start BricsCAD in its own window and connect to it. Refuses if that version is already running.
version: for example "26". Defaults to BRICSCAD_VERSION, then the newest installed.
Inputs: version. Returns: object
bricscad_statusARead-only
Report whether BricsCAD is running, how recently its listener reported, and the current drawing.
Inputs: no named parameters. Returns: object
bricscad_stopADestructive
Close the BricsCAD this server started. Refuses if drawings have unsaved changes.
discard: true closes it anyway and loses the unsaved changes.
Inputs: discard. Returns: object
bricscad_undoADestructive
Undo the last edits to the current drawing. Returns how many steps were undone.
One step is one successful edit tool call. Edits made through bricscad_run_lisp have no step of their own, so they go back with the step before them. steps: how many steps to undo, from 1 to 100. It stops at the oldest step.
Inputs: steps, timeout. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 28 tools
Most tools map cleanly to a distinct resource+action (create_entities vs modify_entities vs erase_entities, read_attributes vs set_attributes). A few pairs overlap in intent: drawing_info vs status both describe the current drawing, and save_drawing vs export_dxf both write files, though the descriptions do clarify the difference.
Nearly all 28 tools follow a bricscad_ prefix with snake_case verb_noun (list_layers, create_entities, plot_pdf, save_drawing); bare verbs like undo/start/stop are reasonable. Minor deviations are the noun-phrase queries drawing_info, audit_report and status, which break the verb-first pattern.
At 28 tools this is on the heavy side of the 3-15 ideal band. Each tool covers genuinely distinct CAD functionality (entity read/write, layers, blocks, xrefs, plotting, batch, lifecycle), so the count is defensible for a full CAD package, but it is still borderline bloated.
Strong coverage of the domain: drawing lifecycle (open/save/close/export), entity read and write, layers, block attributes, plotting, batch processing, plus run_lisp as an escape hatch. Gaps remain for xref attach/detach (only list_xrefs), block definition creation/editing, and layer deletion, but these are workaroundable via LISP.
Maintenance
Related MCP Connectors
Headless CAD engine & MCP server for 2D/3D drafting, solids, DXF/SVG export, and automation.
Global CAD/BIM, industrial engineering (FEM, CFD) and property tools via one MCP endpoint.
Read and edit the Revit 2024–2027 model on your PC. Needs the free Revit MCP add-in.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceEnables programmatic control of AutoCAD through COM automation, allowing natural language commands to create structures, manage layers, and manipulate entities via MCP clients like Claude.70Apache 2.0
- FlicenseBqualityBmaintenanceNatural-language MCP bridge for AutoCAD 2024. Enables users to inspect and edit DWG drawings, manage layers, entities, layouts, styles, and system variables; draw 2D geometry and 3D solids; perform measurements and transactional edits; and export to DWG, STL, PDF, DWF, SVG, or raster formats through a local named-pipe connection.211-
- FlicenseNot gradedqualityAmaintenanceEnables AI assistants like Claude for Desktop or Cursor to control supported CAD applications through MCP, supporting drawing, layer and entity management, block operations, data export, and file/session control via natural language or unified tool calls.-
- AlicenseBqualityBmaintenanceEnables compatible MCP clients to inspect drawings, read units, layers, and entities, and create, edit, transform, or delete CAD objects through a local named-pipe bridge to AutoCAD 2025.231MIT