generate_ornament
Create a printable hanging ornament with optional text, photo or logo decoration, then preview it in an interactive 3D stage you can orbit and zoom.
Instructions
Generate a hanging ornament with optional decoration. Opens Kiln's interactive inline 3D stage on the result (orbit/zoom panel in MCP Apps hosts; hosted sessions add a browser stage link). MAKE DOORS: design_session, Kiln's front door for making an object, is not installed here (signed in to Kiln it runs on Kiln's servers). On this install compile_scad IS the make → preview → iterate loop: make it, show the preview, iterate.
INLINE 3D STAGE: on success this tool opens Kiln's interactive 3D stage — an inline viewer panel the user can orbit, zoom, and turn over — in hosts that render MCP Apps panels (Kiln's hosted connection attaches a browser stage link for hosts that don't). Oversized meshes are decimated automatically for the stage; the PNG preview is the floor, not the whole experience.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "generate_ornament"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| back | No | Back face content — ``"plain"`` or ``"text:..."``. A photo or logo is refused here; it goes on ``front``. Default: "plain". | |
| front | No | Front face content — ``"text:..."`` for debossed text, the path of a photo or logo to carve (on a star, inside its waist), or empty for plain. A file that is not there is refused. Default: "". | |
| shape | No | ``"circle"`` (default) or ``"star"``. Default: "circle". | |
| brief_id | No | Optional saved-goal id from ``design_session``. When supplied, the produced mesh gets a ``design_brief:<id>`` intent sidecar so the audit's "matches what you asked for" gate, the brief failure_history wiring, and the ``compare_design_versions`` intent diff all light up against the saved goal. Omit to skip — REST callers without a goal still get an auto-inferred brief at dispatch time. Default: "". | |
| material | No | Material (default PLA). Default: "PLA". | |
| body_color | No | Body color (default white). Default: "white". | |
| photo_mask | No | Photo crop shape for a photograph (a logo on a clean field is carved unmasked whatever is passed; a name outside this list is refused) — ``"circle"``, ``"rectangle"`` or ``"rounded_rectangle"``. Empty follows the ornament's shape: a disc for both ``"circle"`` and ``"star"``. Default: "". | |
| diameter_mm | No | Outer diameter in mm (default 70). Default: 70.0. | |
| star_points | No | Star points (default 5, only for star shape). Default: 5. | |
| include_step | No | Also emit a CAD-exact STEP file. The STEP is REAL analytic B-rep built from the same typed parameters as the mesh — a true cylinder (or a true extruded star profile) with a real drilled hanging hole, the kind a machine shop's CAD opens clean, never a tessellated conversion. On success the response gains a ``step`` block with ``step_path``. Photo-front ornaments refuse the STEP honestly (heightmap relief has no analytic form) — the mesh outputs are always unaffected. Default: false. | |
| thickness_mm | No | Thickness in mm (default 4, min 3). Default: 4.0. | |
| color_overrides | No | JSON dict mapping role → color name/hex. Overrides body_color for "body" role unless body_color is also set. Default: "". | |
| hole_diameter_mm | No | Hanging hole diameter (default 3mm). Default: 3.0. |