MCP server
Agents that can see what they design.
An AI agent can write OpenSCAD on its own, but it can't tell whether the result renders, looks right or prints. ScadBox's built-in MCP server gives it 36 tools to find out, all running on your Mac.
What changes when the agent has ScadBox
| What the agent can do | Agent alone | Agent + ScadBox |
|---|---|---|
| Write and edit .scad files | ✓ | ✓ |
| Check it renders, with errors located by line | ✗ | ✓ |
| See the model from any angle | ✗ | ✓ |
| Cross-sections of joints and walls | ✗ | ✓ |
| Follow a design guide for clean, customisable models | ✗ | ✓ |
| Test every customizer value | ✗ | ✓ |
| Fits the bed and prints | ✗ | ✓ |
| Supports, and whether they come off | ✗ | ✓ |
| Walls, text and gaps that survive slicing | ✗ | ✓ |
| Best way up on the bed | ✗ | ✓ |
| Strength, tipping and how it hangs | ✗ | ✓ |
| Real print time and grams (Bambu Studio or OrcaSlicer) | ✗ | ✓ |
| Pause layers for inserts and colour changes | ✗ | ✓ |
| Your printer's fits and bed size | ✗ | ✓ |
| Real screw, nut and magnet sizes | from memory | ✓ |
| Exact font names, with previews | ✗ | ✓ |
| Measure from plans and photos | by eye | ✓ |
| Image to outline, photo to lithophane | ✗ | ✓ |
| Assembly steps and a PDF guide | text only | ✓ |
| Export STL, 3MF and OBJ with colours | ✗ | ✓ |
Connect an agent
1. Open ScadBox
The server runs while ScadBox is open. Its status is in Settings › MCP Server.
2. Add it to Claude Code
Copy the command for your agent (Claude Code, Codex or Gemini CLI) and run it in Terminal. For other agents, copy the JSON configuration.
3. Ask for something
Reconnect with /mcp, add the skills, then describe what you want to make. The agent renders and checks as it goes.
claude mcp add --scope user scadbox -- /Applications/ScadBox.app/Contents/Helpers/scadbox-mcp
Skills
Skills teach your agent ScadBox's workflows, so it follows them without being told: it uses one whenever your request matches, or you can name one, like /scadbox-print-ready in Claude Code. They're in the open Agent Skills format, for Claude Code, Codex and Gemini CLI. Install them from Settings › MCP Server › Skills: choose the agent, confirm its skills folder once, and ScadBox keeps them up to date with each update.
scadbox-designA new part: the sizes that matter first, a template where one fits, every check before it's done.
scadbox-open-designWorks on the design in ScadBox's front window, saved or not, with changes you can undo.
scadbox-print-readyBed fit, best way up, supports, thin walls, pauses, real slicer numbers, 3MF export.
scadbox-fit-real-objectsReal object sizes, things you measure, and clearances from your printer's fits.
scadbox-multi-partAssembly planned first, joints checked, step-by-step instructions, big parts split.
scadbox-from-imagesMeasures drawings and photos, traces logos into shapes, makes lithophanes.
scadbox-remix-meshBuilds on an STL, 3MF or OBJ: bases, name plates, magnet pockets, holes.
scadbox-strengthBrackets, hooks and stands: screws, wall fixings, orientation, load and tipping checks.
scadbox-make-customizableTurns fixed numbers into customizer parameters and checks every slider value.
scadbox-text-and-colourFonts you have, lettering that prints, colours for multi-material or filament changes.
Try asking
“Make a wall mount for my router. It's 180 × 120 × 30 mm. Check it holds 1 kg and print it without supports.”
“Here's a photo of my desk organiser with a ruler in it. Measure it and make a matching drawer.”
“Design a box with a sliding lid that fits my printer. Test every slider value and fix anything that breaks.”
“Make a name sign for my daughter's door in a rounded font, in two colours, and tell me which layer to change filament at.”
The tools
Your open designs
open_designsThe designs open in ScadBox, which is in front, and their current errors.
read_open_designThe code exactly as it is in the editor, unsaved edits included.
write_open_designChanges an open design, even one never saved, as a step you can undo.
Designing
renderRenders a design: errors and warnings by line, size, separate bodies, manifold check.
snapshotImages from any camera angle, or zoomed into a region.
get_parametersThe design's customizer parameters, with estimates listed first.
check_designChecks the file against the ScadBox design guide.
sweepRenders every slider's ends, every option and random combinations.
assessPrintability against your printer profile, on the print layout.
sectionA cross-section through any plane, with its area and size.
get_design_guideThe full design guide for clean, customisable models.
get_templateProven starting parts: boxes, hinges, clips, jars, enclosures, Gridfinity bins.
Printing
supportsWhere supports go, and whether each can be removed or is trapped inside.
feature_checkWalls, pins and text too thin for the nozzle; gaps that fuse.
orientThe best way to stand a part on the bed.
hang_checkHow an ornament, keyring or sign hangs from its loop.
stabilityWhether it tips over, contact by contact for parts stacked on each other.
load_checkWhether a wall-mounted part holds its load, and its screws.
pause_planLayers to pause at for magnets, nuts or a colour change.
splitSplits parts too big for the bed, with locating pins.
sliceReal print time, grams and support use from Bambu Studio or OrcaSlicer.
Parts, fits and libraries
get_printer_profileYour printer's nozzle, bed and measured fits.
fit_testWrites a fit test to measure your printer's clearances.
get_hardwareReal sizes for screws, nuts, inserts, magnets, bearings and LEDs.
find_objectReal sizes of devices, furniture, storage boxes, plugs and standards, with sources.
object_modelA real object as OpenSCAD to design around, with its ports and cable room.
save_objectRemembers things you measured, for next time.
assembly_instructionsChecks the assembly steps and writes a PDF guide.
librariesInstalls BOSL2 and gives the agent a cheat sheet for it.
Text, images and meshes
list_fontsFonts OpenSCAD can use, with their exact names.
preview_fontsSample text in several fonts, side by side.
trace_imageTurns a logo or silhouette into an outline to extrude.
lithophaneTurns a photo into a lithophane or relief.
measure_imageMeasures plans and photos from a reference of known size, corrected for perspective.
import_meshInspects an STL, 3MF or OBJ before building on it.
Files
exportSTL, 3MF for slicers (one object per part, colours as filaments), OBJ with colours, SVG, DXF, PDF and more.
There's also a new_model prompt that starts a design with the full guide, and each skill above is a prompt too. Free includes 50 tool calls a day; Pro has no limit.
Safe with your files
Only your Mac
Agents start ScadBox's helper, which reaches ScadBox through a private connection only the two of them share. Nothing listens on your network.
No surprise overwrites
Tools never write over the file they read, only write the expected file types, and won't replace an existing .scad unless the agent asks to.
Undo everything
When an agent edits an open design, ScadBox reloads it and you can undo the change with ⌘Z.
Questions
- What is the ScadBox MCP server?
- A Model Context Protocol server built into the ScadBox app. While ScadBox is open, AI agents such as Claude Code connect to it on your Mac and use 36 tools to render OpenSCAD designs, look at them, check them for printing and export them.
- How do I connect Claude Code to ScadBox?
- Open ScadBox, go to Settings › MCP Server, copy the command for Claude Code and run it in Terminal. Then reconnect with
/mcpin Claude Code. Codex and Gemini CLI have their own commands there. - Can an agent change or delete my files through ScadBox?
- ScadBox's tools never write over the design or image they read, only write the expected file types, and won't replace an existing .scad file unless the agent asks to. Agents edit your .scad files with their own file tools, and ScadBox shows the changes, undoable with ⌘Z.
- What are ScadBox's agent skills?
- Instructions in the Agent Skills format that teach Claude Code, Codex and Gemini CLI ScadBox's workflows: designing a part, working on the design you have open, getting it ready to print, fitting real objects and more. Install them in Settings › MCP Server › Skills; ScadBox keeps them up to date.
- Does the MCP server work over the network?
- No. Agents start ScadBox's own helper program, which talks to ScadBox through a private connection on your Mac. Nothing listens on your network, and no other app can reach it.