
vcad
vcad MCP server + skill (loon authoring, verify with inspect/render/receipts, live edits in vcad.app).
- GitHub stars
- 450
Install
/plugin install vcad@vcadRun it inside Claude Code after adding the marketplace with /plugin marketplace add muni-works/vcad.
Contents
Discovered from sourceSkills 1
vcad
vcad is a parametric CAD system with its own BRep kernel. It runs entirely on
the user's machine — no accounts, no cloud, no share links. You drive it through
the vcad MCP server; the user watches in vcad.app.
The one flow
- Open vcad. The user launches vcad.app. On first launch it registered
itself with their agents, so you are already attached — the
vcadtools are in your tool list. (No app? The same server runs asnpx -y @vcad/mcp.) - Author in loon. Write the whole part as loon source in one
create_cad_looncall. That returns adocument_id; every later tool takes it. - Verify before you claim. Measure with
inspect_cad, look withrender_view, prove with receipts (below). Never describe a dimension you haven't measured. - Edits appear live. In vcad.app, each authoring call shows up in the
viewport as one named undo step the user can step back through. Under npx,
hand the result over with
open_in_app(avcad://link). - Ship it.
export_cadwrites STL / GLB / STEP;save_documentwrites a.vcad(plus the.loonsource) the user owns.
Loon in 60 seconds
Lisp-like, square brackets, millimetres, Z-up. Operations are
subject-last, so they thread through pipe.
[defparam wall 3.0]
[defparam bore 8.2]
[let plate [extrude 0 0 wall
[sketch 0 0 0 1 0 0 0 1 0
#[[polygon #[0 0 60 0 60 40 0 40]
#[#[8 8 2.2] #[52 8 2.2] #[8 32 2.2] #[52 32 2.2]]]]]]]
[root [pipe plate
[union [translate 30 20 0 [cylinder 9 20]]]
[difference [translate 30 20 -1 [cylinder bore 22]]]]
"aluminum"]
[cube x y z]sits with its corner at the origin;[cylinder r h]/[cone rb rt h]stand on the XY plane along +Z;[sphere r]is centred.- Booleans:
[difference tool subject],[union other subject]. - Plates with holes: ONE
[polygon outline #[holes]]extruded — not a stack of difference cutters. [defparam name value]survives into the document — change it later withset_parametersinstead of re-authoring.[let …]does not.- Never hand-mirror by negating coordinates:
[mirror-x s],[mirror-pattern-x s],[mirror-group-x "-r" side]for assemblies. - The full vocabulary (sweeps, lofts, sheet metal, assemblies and joints,
imports, modules) is in the
create_cad_loontool description. Read it.
Verify
| Question | Tool |
|---|---|
| Size, volume, mass, centre of mass | inspect_cad |
| What does it look like? | render_view (look at it — every time) |
| Do these parts collide / keep a gap? | check_clearance (labeled assertions persist) |
| Will it print / machine? | dfm_check |
| Is every claim still true after edits? | build_receipt, then verify_receipt |
Receipts are fail-closed: a claim is Holds, Stale (the geometry changed since it was checked) or Violated. Predicted values from simulation are provisional until measured. Report the receipt verdict, not your own summary.
When something looks broken
Call server_info first.
- Low
uptime_sor a changedinstance_id→ the server restarted; re-run the last authoring call. It is not a renderer bug. update.state: "stale"→ this server is older than the newest release. Tell the user and suggest restarting their agent (or updating vcad.app).durable: false→ sessions won't survive a restart; keep the loon source.
More than one vcad.app
Each running vcad.app registers itself in ~/.vcad/instances/<pid>.json
(pid, port, open document, launch time); ~/.vcad/app.json only points at
the newest. Every app-bridge result ends with [vcad.app pid N · document]
and carries _meta["io.vcad/instance"]: check it names the window you mean.
A ⚠ vcad.app CHANGED notice means the app relaunched or another window took
over — re-check the open document before trusting earlier state.
Pick the window explicitly when more than one runs:
VCAD_APP_PID=<pid>— that instance; fails loudly if it's gone.VCAD_APP_URL=http://127.0.0.1:<port>/mcp— that endpoint, verbatim.VCAD_APP_DOCUMENT=<path>— the instance with that file open.- otherwise the newest, with a warning listing the others. The choice is pinned for the client's lifetime; a later launch never steals it.
VCAD_APP=0—@vcad/mcpdoesn't link to any app.
Never pkill/killall vcad.app by pattern. Other sessions may be driving
other windows, and to them it looks like a crash. Quit only an instance you
launched, by its pid (kill <pid>, from ~/.vcad/instances/).
Ground rules
- vcad has no hosted services. Never send the user to a website to view,
share, or order a part; use
open_in_appand local files. - One
create_cad_loonfor a whole part beats dozens of tiny edits. - Units are millimetres unless the user says otherwise; say which you used.
MCP servers 1
Sponsors
Details
- Marketplace
- muni-works/vcad
- Source
- plugins/vcad
- Category
- Community