parcad
Open-source CAD your AI can check. Parts are JavaScript on an exact B-rep kernel, measured before you print. Use the hosted MCP server or run it on your machine.
Install / Use
claude mcp add ierehon1905 -- npx -y github:ierehon1905/parcadIf the server publishes to npm under a different name, use that package instead — check the repo README.
MCP Server
Model Context Protocol server
Quality Score
Category
Development & EngineeringSupported Platforms
Tags
Our assessment of parcad
parcad scores 83/100 on our quality scale, 2981st of 4,698 Development & Engineering skills we index.
Its MCP Server is 12 KB long, well organised into 12 sections with 9 code examples: a thorough specification that gives an agent plenty to work with.
It has 10 GitHub stars, so there is little community track record yet; judge it on its content.
Maintenance, license and trust
- The repository was last updated today, so parcad is actively maintained.
- It is released under AGPL-3.0, a copyleft license: you can use it, but modified versions you distribute must carry the same license.
- Its trust signals score 97/100, with no cautions. These come from repository metadata, not a code audit — read the skill file before letting an agent act on it.
Safety scan
No issues foundOur scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful.
AI review by kimi-k2.7-code on 2026-11-13. Automated pattern scan on 2026-11-13. It catches known dangerous patterns, not every risk — read a skill before letting an agent act on it.
parcad compared with similar skills
All 4 of these similar skills score higher than parcad; compare them before choosing.
| Skill | Score | Stars | Updated | Format |
|---|---|---|---|---|
| parcad (this skill)by ierehon1905 | 83 | 10 | today | MCP Server |
| taste-skillby Leonxlnx | 100 | 116.8k | 8d ago | CLAUDE.md |
| Agent-Reachby Panniantong | 100 | 112.3k | 8d ago | CLAUDE.md |
| rufloby ruvnet | 100 | 81.9k | today | CLAUDE.md |
| headroomby headroomlabs-ai | 100 | 79.8k | today | CLAUDE.md |
Frequently asked questions
- How do I install parcad?
- Run
claude mcp add ierehon1905 -- npx -y github:ierehon1905/parcad. The install tabs above show the steps for each supported agent. - Which AI agents does parcad work with?
- It is written for Claude Code and Claude Desktop, as a MCP Server file. Other agents that read the same format can often use it too.
- Is parcad safe to use?
- Our scan of the whole file found no instruction hijacking, hidden characters, credential access, data exfiltration or destructive commands. An AI review of the same text found nothing harmful. It is AGPL-3.0-licensed and scores 97/100 on trust signals. Skills are instructions an agent will follow, so read the file before installing it and do not approve commands you do not understand.
- Is parcad still maintained?
- The repository was last updated today, so parcad is actively maintained.
Skill content
View source on GitHubParCAD
Parametric CAD you write as code — for people, and for agents.
Status: 0.0.25, experimental. Made by Maging Studio, and the DSL still moves. Every operation is checked against measured geometry (eval/cases/), but none of it has had the years of abuse that make a CAD kernel trustworthy. Measure a part before you machine it.
Start here: Getting started, five minutes in a browser
tab. Or give your AI one URL, https://mcp.parcad.dev/mcp, and sign in with
GitHub or Google: details.

const plate = box(80, 60, 8).tag("plate");
const wall = box(8, 60, 40).at(-36, 0, 20).tag("wall");
const body = union(plate, wall, { blend: 6 }); // the blend is the fillet
const drilled = body.cut(...grid(2, 2, 36, 40).map(([x, y]) => cylinder(3, 32).at(x, y)));
return drilled
.edges({ curve: "circle", role: "hole", adjacentTo: { faceNormal: "+z" } })
.expect({ count: 4 }) // a build error, not a surprise
.fillet(0.8);
You never name an edge by index. You describe it — the circular rims that open onto the top face — and the description still works after you move a hole.

One graph, one exact kernel
Your script builds a small JSON graph, and an exact kernel reads it — OpenCASCADE: real faces and edges, STEP export, and a refusal rather than an approximation when it cannot do something faithfully. The graph is what keeps today's script working after tomorrow's kernel swap.
Every kernel returns valid-looking wrong answers somewhere, OpenCASCADE and NVIDIA's newly open SMLIB included. ParCAD carries eight patches to OpenCASCADE 8.0.1 for the cases its parts ran into, and checks each build itself after the kernel reports success.


Parts get measured, not assumed — volume, wall thickness, whether two bores actually meet. An agent gets the same numbers over MCP, with no screen to look at.
And when it does look, it gets pictures made for reading: views that share one scale, sections through the inside, and every surface coloured by the tag that built it.

It is aimed at small mechanical parts — brackets, flanges, manifolds, heat sinks, the things you print or machine one of. examples/ has thirty-five.
Why not CadQuery, build123d or OpenSCAD
Those are good, and much older. Three differences. Selectors are descriptive and
checked — .expect({ count: 4 }) turns a selector that silently started
matching three edges into a build error, which is the failure mode that makes
code-CAD fragile. What you see, what you measure and what you export come off
one exact B-rep, so the preview and the STEP file are one model, not two
projects. And measurement is an output rather than something you eyeball,
which is what makes the MCP surface real instead of a wrapper.
Install it
With Homebrew, on macOS or Linux (Linux from 0.0.6), which installs the host and no window:
brew tap ierehon1905/parcad
brew trust ierehon1905/parcad
brew install parcad
Then add it to your agent, which starts parcad when it
needs it. To use the app yourself, run parcad serve and open
http://127.0.0.1:4242 — the whole app is there, in your browser.
Nothing on the Homebrew path is quarantined. The same parcad is the headless driver
(parcad part.js), and a client of the running host: parcad tools
lists what an agent can call over MCP and parcad call <tool> calls it from
a shell.
Or the desktop app, from Releases:
| platform | download |
|---|---|
| macOS, Apple silicon | ParCAD-aarch64-apple-darwin.zip — unzip, drag to Applications |
| Linux x86_64 | .deb or .AppImage (also on AppImageHub) |
| Windows x86_64 | .msi or -setup.exe (a winget package is waiting for review) |
Each platform's build measures the whole eval corpus with the worker it ships
before it is uploaded. The Mac app is not notarised yet, so macOS refuses it the
first time: run xattr -dr com.apple.quarantine /Applications/ParCAD.app once.
The Windows installer is not signed yet: SmartScreen warns, More info, then
Run anyway. Every
platform also has a parcad-cli-* archive — parcad, its worker beside it and
the seed parts — for running the host without a window. Keep the two binaries
together.
Build it
macOS, Linux and Windows. Day-to-day development is on macOS; the release workflow builds and measures on all three, and Linux on arm64 builds too.
You need Rust (the toolchain is pinned; rustup honours it),
Bun, CMake, a C++ compiler, patch(1) and Python 3.11+. A
full build wants around 20 GB free. On Linux the window also needs WebKitGTK
(libwebkit2gtk-4.1-dev), and libclang-dev for the script sandbox's
bindings. On Windows, use MSVC (Visual Studio Build Tools) and run the scripts
from Git Bash, which also provides patch.
cd app && bun install --frozen-lockfile && cd .. # first: the Rust build shells out to bun
cargo build --locked --release
tools/build-worker.sh --release # the exact kernel — ~5 min on 14 cores, once
cd app && bun run tauri dev
cargo build produces a dev app whatever the profile — Tauri's switch is the
custom-protocol feature, not --release — so launch the window through tauri dev or tauri build, never the bare binary. And a root cargo build
deliberately does not build OpenCASCADE; tools/build-worker.sh does.
tools/check.sh # everything that gates a change (~5 min)
tools/check.sh --fast # the kernel crates and the editor tests (~4 s)
Or headless:
bun tools/run.ts examples/bracket.js > /tmp/bracket.json
./target/release/parcad /tmp/bracket.json --out out --step out/part.step
The app serves its UI and an MCP endpoint on http://127.0.0.1:4242. Parts live
in ~/Library/Application Support/parcad as plain .js files you can edit anywhere.
Use it from an agent
The hosted server, nothing to install
Add https://mcp.parcad.dev/mcp to your AI client and sign in with GitHub or
Google when it asks. It's free, with limits on builds and storage per account.
A part you haven't used for 30 days is deleted and nothing is backed up, so
download the parts you want to keep.
-
Claude (web and desktop): Customize → Connectors → Add custom connector, paste the URL. In Claude the part shows up in 3D right in the chat.
-
Claude Code:
claude mcp add --transport http parcad https://mcp.parcad.dev/mcp -
Codex:
codex mcp add parcad --url https://mcp.parcad.dev/mcp && codex mcp login parcad -
ChatGPT, Cursor and other clients: add a remote MCP server with the URL. The client opens the sign-in page itself.
What the server keeps about you is in its privacy notice.
In a browser tab
With nothing installed: open ParCAD web, choose Connect your AI, and give your client the link it shows — Claude Code, the Claude app as a custom connector, Cursor, VS Code, or any client that connects to a URL. The tab is the server, with the same tools as the app, and it has to stay open; a relay passes the messages and keeps none (relay/README.md).
On your own machine
Every route below runs the same parcad on your machine: the one Homebrew
installs, which the desktop app carries too. Install either first.
As a plugin, which brings the MCP server and a skill that says how to use it:
/plugin marketplace add ierehon1905/parcad
/plugin install parcad@parcad
In Codex, which finds parcad on PATH, so the Homebrew install:
codex plugin marketplace add ierehon1905/parcad
codex plugin add parcad@parcad
In Cursor or VS Code, with parcad on PATH:
Or add the server by hand, in any client that launches stdio servers:
claude mcp add parcad -- parcad mcp
codex mcp add parcad -- parcad mcp
parcad mcp relays to the app or parcad serve when one is running, so the
agent shares the live session with your window. When none is running it hosts
one itself, for as long as the client stays connected. A client that connects
by URL can use http://127.0.0.1:4242/mcp directly, but only while a host is
up; brew services start parcad keeps one up from login.
The same tools are on the command line, with the same names and arguments —
parcad tools lists them, parcad call evaluate_part --set script=@part.js
calls one — and they work whether or not the app is open.
ParCAD is also in the official MCP Registry
as io.github.ierehon1905/parcad, so clients that browse it can install it by
that name.
Start the agent on the read_docs tool, which hands over the whole language in
one call.
More
- docs/GETTING_STARTED.md — five minutes, from the browser to your own agent
- examples/ — thirty-five parts, from a bracket to a hydraulic manifold
- CONTRIBUTING.md — the gate, and what a change has to satisfy
- docs/ARCHITECTURE.md — how the pieces fit, and why
- docs/GOTCHAS.md — traps that have already cost a day each
- docs/NEXT.md — what's missing, in order
Privacy
ParCAD on your own computer collects nothing about you: no accounts, no analytics, no telemetry. PRIVACY.md lists everything that touches the network. The hosted server at mcp.parcad.dev needs an account; its privacy notice says what it keeps.
Licensing
ParCAD is free software under the GNU AGPL-3.0 or later: use it,
change it and share it, but a modified ParCAD you distribute or run as a service
must publish its source too. The parts you make are yours — part scripts and
everything ParCAD exports from them can be licensed however you like, and the
seed parts in examples/ are MIT. Releases through v0.0.9 stay MIT or
Apache-2.0.
Built on components under other licences: OpenCASCADE
and its bindings under vendor/ are LGPL-2.1, and one file of our own,
crates/parcad-core/src/occlusion.rs, is MPL-2.0 because it was ported from
fidget. Building from source is
unencumbered; redistributing a binary carries obligations —
NOTICE.md spells them out, including how to swap in your own
OpenCASCADE.
This software makes use of facilities provided by the Open CASCADE Technology software.
Related Skills
taste-skill
116.8kAgent skills that give coding agents taste: art direction, reference images and a browser check instead of generic AI pages
Agent-Reach
112.3kGive your AI agent eyes to see the entire internet. Read & search Twitter, Reddit, YouTube, GitHub, Bilibili, XiaoHongShu — one CLI, zero API fees.
ruflo
81.9k🌊 The original agent harness. Deploy intelligent multi-player swarms, coordinate autonomous workflows, and build conversational AI systems. Features adaptive memory, self-learning intelligence, federation, vector RAG integration, and native Claude Code / Codex / Hermes and many more Integrated
headroom
79.8kCompress tool outputs, logs, files, and RAG chunks before they reach the LLM. 20% fewer tokens for coding agents, 60-95% fewer tokens for JSON, same answers. Library, proxy, MCP server.
Languages
Trust signals
From repository metadata: license, adoption, age and documentation. Not a code audit — see the Safety scan above for what the skill file itself contains.
