show_on_stage
Read-only
Open existing STL, OBJ, 3MF, STEP, or G-code files in Kiln's interactive 3D stage to orbit, zoom, and inspect them before printing—no remaking or importing needed.
Instructions
Open Kiln's interactive 3D stage on a file that already exists.
The door for "let me see it" when nothing needs making: a mesh
from an earlier session, a download, or the sliced print file
about to go to the printer. Nothing is re-made, re-sliced,
imported or written. Free on every install, like the stage.
What the stage draws (``shows`` says which, in words):
- An STL, OBJ or 3MF is drawn as itself; a STEP file is drawn
from Kiln's mesh of it.
- A sliced ``.gcode.3mf`` is drawn as the model it carries — the
file going to the printer, in its paint — with the slicer's
skirt, brim, prime tower and supports under EXTRAS while this
machine still holds that slice's G-code.
- A print file with no model of its own (raw G-code, or an
archive holding only Kiln's 1 mm placeholder) is drawn as the
mesh this machine sliced it from, and refused, with the
reason, when there is no record of that mesh.
Before a print: open the print file here, let the person turn it
over, then call ``issue_preview_token(file_path, door="stage")``
for that same file — the panel's own fetch is the evidence the
gate reads. On a host that draws no panel, or until a panel has
fetched since the server started, the result also carries
``viewer_url``: hand it over, and use ``door="url"``. ``shown``
says which door this result took.
``visualize_model`` is the still-picture door: renders to check
yourself, and the sign-off only when neither this panel nor a
link is possible.
A slice result that opened the stage has already drawn its print,
from the mesh the slicer was handed, and the print gate counts
that panel's fetch for the print file the slice wrote. Called on
that print file right after, this draws the same slice again,
from the model the file carries. ``shown.repeat`` says when the
panel just above already shows what this one draws.
:param file_path: Path to an STL, OBJ, 3MF, STEP, ``.gcode.3mf``
or G-code file on this machine.
:returns: ``stage_mesh_path`` (the file the stage draws),
``shows`` and ``message``, plus ``came_from`` for a file a
generator or a marketplace download brought in; the stage
adds ``artifact``, ``shown`` and, when the link is the
stage, ``viewer_url``.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
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"file_path": "<file_path>"
},
"name": "show_on_stage"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file_path | Yes | Path to an STL, OBJ, 3MF, STEP, ``.gcode.3mf`` or G-code file on this machine. |