splice_mesh_at_z
Combine an STL's geometry above a Z-plane with another's below, clipping boundary triangles cleanly to create a new mesh for design iteration.
Instructions
Splice two meshes at a z-plane: top from one STL, bottom from another.
Takes geometry ABOVE *z_plane* from *top_path* and geometry BELOW
*z_plane* from *bottom_path*. Triangles crossing the boundary are
clipped cleanly. No boolean ops -- works on non-manifold meshes.
**Use case:** Combine a body with the correct top (e.g. logo from
v5.3) with a body that has the correct bottom (e.g. larger pocket
from v5.4) to create the next design iteration.
:param top_path: STL providing geometry above z_plane.
:param bottom_path: STL providing geometry below z_plane.
:param z_plane: Z height (mm) where the splice happens.
:param output_path: Output STL path. Auto-generated if empty.
:returns: Dict with splice stats and output path.INLINE 3D STAGE: on success this tool also 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.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| z_plane | Yes | ||
| top_path | Yes | ||
| bottom_path | Yes | ||
| output_path | No |