generate_pen_cup
Generate a customizable desktop pen or brush cup with optional text, photo, logo, or QR decoration; preview and orbit the result in an interactive 3D stage.
Instructions
Generate a desktop pen / brush cup with optional decoration; adding a QR code needs Kiln Business. 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_pen_cup"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| shape | No | ``"cylinder"`` (default) or ``"rectangle"``. Default: "cylinder". | |
| bottom | No | ``"plain"`` or ``"qr:URL"``; anything else is refused. A QR code under a photo, logo or lettering on ``interior_bottom`` raises the floor inside the cup until both fit; the outside is unchanged and the reply gives the new floor thickness. Default: "plain". | |
| 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: "". | |
| depth_mm | No | Outer depth (rectangle only). Default: 75.0. | |
| exterior | No | Text wrapped on the outer wall as ``"text:..."``; empty for a plain wall. A photo or logo is refused here; it goes on ``interior_bottom``. Default: "". | |
| material | No | Material (default PLA). Default: "PLA". | |
| height_mm | No | Total height in mm (default 100). Default: 100.0. | |
| body_color | No | Body color (default navy). Default: "navy". | |
| 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 or ``"auto"`` follows ``shape``: ``"circle"`` for a cylinder, ``"rounded_rectangle"`` for a rectangle. Default: "auto". | |
| diameter_mm | No | Outer diameter (cylinder) / outer width (rectangle). Default: 75.0. | |
| include_step | No | Also emit a CAD-exact STEP file — REAL analytic B-rep from the same typed parameters, never a tessellated conversion. On success the response gains a ``step`` block with ``step_path``. Image decorations refuse (heightmaps have no analytic form); wrapped wall text on a round cup refuses with the interior-bottom alternative named; QR bottoms refuse (two-solid assembly). The mesh outputs are always unaffected. Default: false. | |
| color_overrides | No | JSON dict mapping role → color name/hex. Default: "". | |
| interior_bottom | No | Inside floor — ``"plain"``, ``"text:..."`` or the path of a photo or logo. A file that is not there is refused. Default: "plain". | |
| corner_radius_mm | No | Outer corner radius for rectangle (default 8). Default: 8.0. | |
| wall_thickness_mm | No | Wall thickness (default 3, min 1.6). Default: 3.0. | |
| bottom_thickness_mm | No | Floor thickness (default 3, min 2.0). Default: 3.0. |