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 doAgent aloneAgent + 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 sizesfrom memory✓
Exact font names, with previews✗✓
Measure from plans and photosby eye✓
Image to outline, photo to lithophane✗✓
Assembly steps and a PDF guidetext 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-design

A new part: the sizes that matter first, a template where one fits, every check before it's done.

scadbox-open-design

Works on the design in ScadBox's front window, saved or not, with changes you can undo.

scadbox-print-ready

Bed fit, best way up, supports, thin walls, pauses, real slicer numbers, 3MF export.

scadbox-fit-real-objects

Real object sizes, things you measure, and clearances from your printer's fits.

scadbox-multi-part

Assembly planned first, joints checked, step-by-step instructions, big parts split.

scadbox-from-images

Measures drawings and photos, traces logos into shapes, makes lithophanes.

scadbox-remix-mesh

Builds on an STL, 3MF or OBJ: bases, name plates, magnet pockets, holes.

scadbox-strength

Brackets, hooks and stands: screws, wall fixings, orientation, load and tipping checks.

scadbox-make-customizable

Turns fixed numbers into customizer parameters and checks every slider value.

scadbox-text-and-colour

Fonts 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_designs

The designs open in ScadBox, which is in front, and their current errors.

read_open_design

The code exactly as it is in the editor, unsaved edits included.

write_open_design

Changes an open design, even one never saved, as a step you can undo.

Designing

render

Renders a design: errors and warnings by line, size, separate bodies, manifold check.

snapshot

Images from any camera angle, or zoomed into a region.

get_parameters

The design's customizer parameters, with estimates listed first.

check_design

Checks the file against the ScadBox design guide.

sweep

Renders every slider's ends, every option and random combinations.

assess

Printability against your printer profile, on the print layout.

section

A cross-section through any plane, with its area and size.

get_design_guide

The full design guide for clean, customisable models.

get_template

Proven starting parts: boxes, hinges, clips, jars, enclosures, Gridfinity bins.

Printing

supports

Where supports go, and whether each can be removed or is trapped inside.

feature_check

Walls, pins and text too thin for the nozzle; gaps that fuse.

orient

The best way to stand a part on the bed.

hang_check

How an ornament, keyring or sign hangs from its loop.

stability

Whether it tips over, contact by contact for parts stacked on each other.

load_check

Whether a wall-mounted part holds its load, and its screws.

pause_plan

Layers to pause at for magnets, nuts or a colour change.

split

Splits parts too big for the bed, with locating pins.

slice

Real print time, grams and support use from Bambu Studio or OrcaSlicer.

Parts, fits and libraries

get_printer_profile

Your printer's nozzle, bed and measured fits.

fit_test

Writes a fit test to measure your printer's clearances.

get_hardware

Real sizes for screws, nuts, inserts, magnets, bearings and LEDs.

find_object

Real sizes of devices, furniture, storage boxes, plugs and standards, with sources.

object_model

A real object as OpenSCAD to design around, with its ports and cable room.

save_object

Remembers things you measured, for next time.

assembly_instructions

Checks the assembly steps and writes a PDF guide.

libraries

Installs BOSL2 and gives the agent a cheat sheet for it.

Text, images and meshes

list_fonts

Fonts OpenSCAD can use, with their exact names.

preview_fonts

Sample text in several fonts, side by side.

trace_image

Turns a logo or silhouette into an outline to extrude.

lithophane

Turns a photo into a lithophane or relief.

measure_image

Measures plans and photos from a reference of known size, corrected for perspective.

import_mesh

Inspects an STL, 3MF or OBJ before building on it.

Files

export

STL, 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 /mcp in 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.