Qcad MCP

Create a new DXF file from primitive entities and store it in the depot. Supported entity types (lenient key aliases accepted — the webapp Demo page sends x1/y1/x2/y2 shapes, MCP clients may send x/y/w/h): - line: {"type": "line", "x1": 0, "y1": 0, "x2": 100, "y2": 0, "layer": "walls"} - rect: {"type": "rect", "x": 10, "y": 10, "w": 80, "h": 60, "layer": "rooms"} alias: {"type": "rect", "x1": 10, "y1": 10, "x2": 90, "y2": 70, "layer": "rooms"} - circle: {"type": "circle", "cx": 50, "cy": 50, "r": 20, "layer": "columns"} alias: {"type": "circle", "x": 50, "y": 50, "r": 20, "layer": "…

List all DXF files in the local CAD depot with metadata. ## Return Format {"success": bool, "data": {"files": [{"name": ..., "size_kb": ..., "modified": ..., "meta": {...}}]}} ## Examples await plan_depot()

Add dimension entities to a DXF drawing using QCAD Pro. Adds aligned, radial, diametric, angular, or rotated dimensions to existing geometry. Requires QCAD Pro installed. ## Return Format {"success": bool, "output": str, "data": {"entity_count": int, "dim_count": int}} ## Examples await plan_dimension(file_name="floorplan.dxf", dimensions=[ {"type": "aligned", "x1": 0, "y1": 0, "x2": 5000, "y2": 0, "xd": 2500, "yd": -500}, {"type": "radial", "cx": 2500, "cy": 2000, "px": 2800, "py": 2000}, ])

Generate the full architectural drawing set from a floor plan DXF. Derives elevations (N/S/E/W), a cross-section (A-A), an axonometric isometric, and a roof plan from the detected wall segments — the standard drawings an architect produces beyond the floor plan. Openings (doors / windows on DOOR/WINDOW layers) are cut into elevations when present. Unit convention: DXF units are millimetres; wall_height in metres. ## Return Format {"success": bool, "outputs": {"elev_n": ..., ...}, "data": {"wall_count": int, "views": [...], ...}} ## Examples await plan_drawings(file_name="office.dxf") await…

Convert between DWG/DXF and modify layers/entities in place. ## Return Format {"success": bool, "output": str, "data": {...}} ## Examples await plan_edit(op="convert", file_name="plan.dwg", output_name="plan.dxf") await plan_edit(op="modify", file_name="plan.dxf", operations=[{"op": "layer-freeze", "layer_filter": "Furniture"}])

Execute ECMAScript in a temporary QCAD Pro session and return results. Quick code runner - shorter startup than plan_script since no output file is saved. Use for queries, lightweight modifications, or prototyping before committing with plan_script. ## Return Format {"success": bool, "data": {"entity_count": int, "layers": [...], "errors": [...]}} ## Examples await plan_exec(code='var op = new RAddObjectsOperation(); op.addObject(new RCircleEntity(document, new RCircleData(new RVector(10,10), 5))); op.apply(document);') await plan_exec(code='document.queryAllEntities().length;', file_name="…

Export a DXF file to SVG, PDF, or PNG. Tries QCAD Pro for high-fidelity output first (SVG, PDF). Falls back to ezdxf+matplotlib if QCAD Pro is unavailable. For guaranteed QCAD Pro rendering, use plan_render instead. ## Return Format {"success": bool, "output": str, "data": {"size_kb": float, "backend": str}} ## Examples await plan_export(file_name="floorplan.dxf", format="svg")

Extrude walls from a DXF floor plan into a 3D STL mesh. Finds LINE and LWPOLYLINE entities on wall layers, extrudes them vertically to wall_height with wall_thickness on each side. Unit convention: DXF units are millimetres (1 unit = 1 mm, real-world scale). wall_height / wall_thickness are given in METRES and converted internally (x1000). ## Return Format {"success": bool, "output": str, "data": {"vertices": int, "faces": int, "wall_count": int, "size_kb": float}} ## Examples await plan_extrude(file_name="floorplan.dxf") await plan_extrude(file_name="floorplan.dxf", wall_height=2.5, wall_…

Design a floor plan from natural language: LLM geometry -> validated entities -> DXF. Sampling-first agentic workflow: with a sampling-capable client (Claude Desktop) the host model designs the plan via ``ctx.sample_step``. Without sampling it falls back to the local Ollama model from Settings, and refuses (no silent substitution) when none is selected. Output is validated (known types, finite mm coordinates, sane bounds) and bad entities are dropped with warnings before anything is created. ## Return Format {"success": bool, "output": str | list, "source": "sampling" | "ollama", "model": …

Convert a plan (or existing OBJ) to GLB via headless Blender. Resonite only imports .glb/.gltf/.vrm — this is the ticket in. Materials and PNG textures from plan_obj carry through Blender's glTF exporter. Millimetre geometry is scaled to metres on export. ## Return Format {"success": bool, "output": str, "data": {"size_kb": float, ...}} ## Examples await plan_glb(file_name="office.dxf") await plan_glb(obj_name="office.obj", output_name="office.glb")

Add hatch/fill patterns to closed regions in a DXF drawing via QCAD Pro. Supports ANSI, architectural, earth, and solid fill patterns with configurable scale and angle. Requires QCAD Pro installed. ## Return Format {"success": bool, "output": str, "data": {"entity_count": int, "hatch_count": int}} ## Examples await plan_hatch(file_name="floorplan.dxf", hatches=[ {"points": [[0,0], [5000,0], [5000,4000], [0,4000]], "pattern": "AR-CONC", "scale": 0.5}, {"points": [[1000,1000], [2000,1000], [2000,2000], [1000,2000]], "pattern": "SOLID", "color": "#FF0000"}, ])

Read a DXF file from the depot and return metadata: layers, entity counts, bounding box, blocks. Upload DXF files first via POST /api/v1/upload or use plan_create to generate one. ## Return Format {"success": bool, "data": {"layers": [...], "entity_counts": {...}, "bounding_box": {...}, "block_count": int}} ## Examples await plan_info(file_name="floorplan.dxf")

Search 4800+ CAD blocks and the QCAD script gallery; download to the depot. ## Return Format {"success": bool, "data": {"results": [...]}, "output": str} ## Examples await plan_library(op="blocks", query="door", category="doors-windows") await plan_library(op="scripts_search", query="hatch")

Measure distances, angles, areas, and perimeters in a DXF drawing via QCAD Pro. Uses QCAD Pro's geometry engine for precise measurements. Returns structured measurement data for all entities in the drawing. Requires QCAD Pro installed. ## Return Format {"success": bool, "data": {"entity_count": int, "entities": [...], "total_line_length": float, "total_area": float}} ## Examples await plan_measure(file_name="floorplan.dxf")

Modify entities and layers in a DXF/DWG file. Operations are applied in order. The file is saved back to the depot. ## Return Format {"success": bool, "operations": int, "summary": [str, ...]} ## Examples await plan_modify(file_name="plan.dxf", operations=[{"op": "layer-set-color", "layer_filter": "Walls", "color": 7}]) await plan_modify(file_name="plan.dxf", operations=[{"op": "delete", "type_filter": "TEXT"}])

Export walls to a COLORED Wavefront OBJ + MTL with procedural textures. Same wall detection as plan_extrude (incl. per-entity XDATA heights), but each layer gets an architectural material: plaster/brick walls, concrete columns, wood doors, translucent glass windows. Textures are generated PIL tiles (world-scale UVs, set RepeatWrapping in the viewer). ## Return Format {"success": bool, "output": str, "data": {"materials": [...], "textures": [...], ...}} ## Examples await plan_obj(file_name="office.dxf") await plan_obj(file_name="church.dxf", output_name="church.obj")

Execute ECMAScript in QCAD Pro and render publication-quality output. Requires a QCAD Pro install (check qcad(op="status") first). ## Return Format {"success": bool, "output": str, "data": {...}} ## Examples await plan_pro(op="exec", code="print(transientEntityCount());") await plan_pro(op="render", file_name="floorplan.dxf", output_name="proof.pdf")

High-fidelity rendering of a DXF/DWG via QCAD Pro. Uses QCAD Pro's native rendering engine for perfect output with hatches, TrueType fonts, dimension styles, and lineweights - superior to the ezdxf+matplotlib fallback used by plan_export. Requires QCAD Pro installed. ## Return Format {"success": bool, "output": str, "data": {"size_kb": float}} ## Examples await plan_render(file_name="floorplan.dxf", format="svg") await plan_render(file_name="floorplan.dxf", format="pdf", output_name="floorplan_pro.pdf")

Execute arbitrary ECMAScript in QCAD Pro against a DXF document. This is the most powerful tool - it provides full access to QCAD Pro's ECMAScript API including entity creation, modification, layer management, block operations, and geometry queries. User code has access to: - `document` - RDocument (the drawing) - `di` - RDocumentInterface (import/export) - Full QCAD API: RLineEntity, RCircleEntity, RArcEntity, RVector, RAddObjectsOperation, RModifyObjectsOperation, RLayer, etc. - Full Qt API for data processing - `print()` outputs are captured but only the structured result is ret…

Download an ECMAScript from a library to the local depot. Gallery scripts (gallery://id) are pre-curated and served from the local bundle. Downloaded .js files go to the depot and can be viewed, edited, or used with plan_script. ## Return Format {"success": bool, "filename": str, "size_kb": float, "content": str} ## Examples await plan_scripts_download(title="Door Swing Arc", source="gallery", url="gallery://door_swing.js")

Search QCAD ECMAScript libraries for reusable CAD scripts. Searches curated gallery, GitHub Gist, and QCAD bundled examples. ## Return Format {"success": bool, "source": str, "results": [{"title": str, "description": str, "source": str, "url": str, ...}]} ## Examples await plan_scripts_search(query="dimension") await plan_scripts_search(category="drawing", source="gallery")

Stack multiple single-storey DXF plans into one multilevel STL mesh. Each file is extruded at its base_elevation (e.g. ground 0 m, L1 3.5 m). Per-entity XDATA heights apply within each storey as usual. A floor slab is added under every storey (set slab=False to skip). ## Return Format {"success": bool, "output": str, "data": {"levels": [...], "wall_count": int, ...}} ## Examples await plan_stack(files=[{"file_name": "tower_L0.dxf", "base_elevation": 0}, {"file_name": "tower_L1.dxf", "base_elevation": 3.5}])

Add text annotations to a DXF drawing via QCAD Pro. Supports multi-line text with configurable height, alignment, rotation, and font styling (bold, italic). Requires QCAD Pro installed. ## Return Format {"success": bool, "output": str, "data": {"entity_count": int, "text_count": int}} ## Examples await plan_text(file_name="floorplan.dxf", texts=[ {"text": "Living Room", "x": 2500, "y": 3000, "height": 250, "halign": "center"}, {"text": "Kitchen", "x": 6000, "y": 2000, "height": 250, "layer": "Labels"}, ])

Extract wall lines, doors, and windows as a structured BIM schema JSON. Ready for consumption by `freecad-mcp` or direct IFC compilation. ## Return Format Dictionary with `success` and `data` containing BIM schema JSON details. ## Examples await plan_to_ifc_data("simple_floorplan.dxf", wall_height=3000.0)

Convert a DXF file to an SVG preview image. Uses ezdxf's matplotlib backend for rendering. The SVG is saved to the outputs directory and viewable at GET /api/v1/download/{output_name}. ## Return Format {"success": bool, "output": str, "data": {"size_kb": float}} ## Examples await plan_to_svg(file_name="floorplan.dxf")

Translate AutoLISP to QCAD ECMAScript and execute the result. AI sampling (when a sampling-capable client is connected) asks the connected model to translate the AutoLISP using a reference mapping table - quality depends on that model, not on this code. Without sampling, falls back to a real (if limited) heuristic engine: it parses AutoLISP s-expressions properly (not regex matching), handles LINE/CIRCLE/ARC/RECTANG/TEXT/DIMLINEAR/LAYER commands, unrolls `repeat` loops with literal bounds, substitutes `defun` parameters, and translates `ssget`/`sslength` selection-set queries into live docum…

Extract wall segment coordinates as structured BIM-ready JSON. Reads a DXF floor plan and exports wall line segments as structured data ready for freecad-mcp BIM tools (bim_create_wall). Each wall segment includes: start/end coordinates, length, angle, and layer name. LWPOLYLINE entities on wall layers are decomposed into individual segments. Requires QCAD Pro. ## Return Format {"success": bool, "data": {"wall_count": int, "total_length_m": float, "walls": [{"x1":.., "y1":.., "x2":.., "y2":.., "length_mm":.., "angle_deg":.., "layer":..}]}} ## Examples await plan_wall_data(file_name="floor…

QCAD server itself: install status, live help catalog, orderly shutdown. ## Return Format {"success": bool, "message": str, "data": {...}} ## Examples await qcad(op="status") await qcad(op="help", topic="extrude") await qcad(op="shutdown", confirm=True)

List server capabilities: MCP tools, REST routes, and config. Start here when you do not know which tool fits. Returns the tool catalog (8 portmanteau tools + 4 Prefab cards across 2 modules), key REST endpoints, ports, and env vars. Filter with `topic` for a focused subset. ## Return Format {"success": bool, "data": {"tools": [...], "rest": [...], "config": {...}}} ## Examples await qcad_help() await qcad_help(topic="extrude")

Shut the QCAD MCP server down gracefully (orderly exit). Responds first, then exits the process ~500 ms later so in-flight writes (depot sidecars, settings) can flush. The fleet launcher calls POST /api/shutdown before service restarts for the same reason. ## Return Format {"success": bool, "message": str} ## Examples await qcad_shutdown(confirm=True)

Check QCAD Pro installation status, version, and capabilities. Reports whether QCAD Pro is installed, running, and the version string. Use this first to determine which QCAD Pro tools are available. ## Return Format {"success": bool, "data": {"installed": bool, "running": bool, "version": str, "install_dir": str}} ## Examples await qcad_status()

Show 2D beam FEA structural analysis as a rich Prefab card.

Show building storeys and level metadata as a rich Prefab card.

Show the CAD file depot contents as a rich Prefab card. ## Return Format ToolResult with PrefabApp card, or text summary fallback. ## Examples await show_depot_card()

Show QCAD Pro installation status as a rich Prefab card. ## Return Format ToolResult with PrefabApp card, or text summary fallback. ## Examples await show_qcad_status_card()