Skip to main content
Glama
BricsCAD MCP

BricsCAD MCP

by alesdev88

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.mcpb

  • Windows: 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-mcp

Codex (the CLI, the IDE extension and the ChatGPT desktop app share this setting):

codex mcp add bricscad -- uvx bricscad-mcp

Cursor, 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-mcp
codex mcp add bricscad --env UV_SYSTEM_CERTS=1 -- uvx bricscad-mcp

In 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.git
cd bricscad-mcp && uv sync

Then register it, using the full path to your copy:

claude mcp add bricscad -- uv --directory "/full/path/to/bricscad-mcp" run bricscad-mcp

Tools

Tool

What it does

bricscad_list_versions

Lists installed versions

bricscad_start / bricscad_stop

Starts or closes the server's own BricsCAD

bricscad_status

Reports whether it's running, listener health and the current drawing

bricscad_open_drawing / bricscad_close_drawing

Opens a DWG or DXF (read-only by default), or closes it

bricscad_drawing_info

Name, path, state, units, entity count, layouts, and the limits and extents of the current layout

bricscad_list_layers / _blocks / _xrefs / _layouts

Lists what's in the drawing

bricscad_query_entities

Finds entities by type, layer, block, layout or bounding box

bricscad_get_entity

Returns all DXF values for one entity

bricscad_read_attributes

Reads block attributes, such as title block contents

bricscad_find_text

Searches TEXT, MTEXT, MULTILEADER, table cell and attribute text

bricscad_audit_report

Empty layers, unused blocks, missing xrefs, raised entities, off-standard layer names

bricscad_create_entities

Draws lines, polylines, circles, arcs, text, MTEXT, dimensions, hatches and block inserts

bricscad_modify_entities

Moves, rotates, scales, or changes layer, color, linetype or text

bricscad_erase_entities

Erases entities by handle

bricscad_set_layer

Creates or changes a layer

bricscad_set_attributes

Sets block attribute values, such as title block contents

bricscad_undo

Undoes edit tool calls, one step each

bricscad_save_drawing

Saves to a new path, or over the open file with overwrite=true

bricscad_export_dxf

Writes the drawing as DXF, R12 or 2000 to 2018

bricscad_plot_pdf

Plots the model or a sheet to PDF, with paper, orientation, area, scale and plot style

bricscad_preview_image

Returns a PNG of the model, a sheet or a window, so the client can check its work

bricscad_batch_run

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

bricscad_run_lisp

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_start refuses 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 with BRICSCAD_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_lisp is 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_run with dry_run=true first 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_stop only 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_lisp have 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 .bak beside 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 a lisp job can still save anywhere itself, as with bricscad_run_lisp.

Environment variables

Variable

Purpose

BRICSCAD_VERSION

The version to start, for example 26. Defaults to the newest installed

BRICSCAD_EXECUTABLE

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-save opens a dialog and vla-saveas fails on macOS, so use _.QSAVE and _.SAVEAS in 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_drawing handles this for you.

  • PDFs are plotted with Print As PDF.pc3 only. Paper sizes go by BricsCAD's own name, such as ISO 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 pytest

These 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 bricscad

Passing 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

  1. Set the new version in pyproject.toml, manifest.json and server.json, then run uv lock. A test checks that the three agree, and that manifest.json lists every tool.

  2. Push a tag for it, such as v0.1.0. The release workflow 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.

  3. 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 tools
bricscad_audit_reportA
Read-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_runA
Destructive

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_drawingA
Destructive

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_infoA
Read-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_entitiesB
Destructive

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_dxfA
Destructive

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_textC
Read-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_entityA
Read-only

Return one entity's type, layer and all its DXF group codes, as [code, value] pairs.

Inputs: handle (required). Returns: object

bricscad_list_blocksB
Read-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_layersB
Read-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_layoutsC
Read-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_versionsA
Read-only

List the BricsCAD versions installed on this computer, newest first.

Inputs: no named parameters. Returns: object

bricscad_list_xrefsB
Read-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_entitiesA
Destructive

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_pdfA
Destructive

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_imageA
Read-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_entitiesA
Read-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_attributesA
Read-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_lispA
Destructive

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_drawingA
Destructive

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_attributesA
Destructive

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_layerA
Destructive

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_statusA
Read-only

Report whether BricsCAD is running, how recently its listener reported, and the current drawing.

Inputs: no named parameters. Returns: object

bricscad_stopA
Destructive

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_undoA
Destructive

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

    A3.5/5.0

    Scored across 28 tools

    Disambiguation4/5

    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.

    Naming Consistency4/5

    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.

    Tool Count3/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables programmatic control of AutoCAD through COM automation, allowing natural language commands to create structures, manage layers, and manipulate entities via MCP clients like Claude.
      70
      Apache 2.0
    • F
      license
      B
      quality
      B
      maintenance
      Natural-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.
      21
      1
      -
    • F
      license
      Not graded
      quality
      A
      maintenance
      Enables 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.
      -
    • A
      license
      B
      quality
      B
      maintenance
      Enables 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.
      23
      1
      MIT