download_model
Downloads marketplace model files to local storage and converts GLBs to STLs for preview, slicing, or printing, with optional file selection and destination control.
Instructions
Download model file(s) from a marketplace to local storage.
**Community models are unverified.** Always preview dimensions and
validate the mesh (``validate_generated_mesh``) before printing.
Models with high download counts and positive ratings are generally
safer. AI-generated or untested designs can damage delicate printer
hardware — prefer proven blueprints when possible.
Args:
brief_id: The saved goal's id from ``design_session``, so this make
is recorded against the goal and checked against it. Empty when
there is no goal.
file_id: Numeric file ID (from ``model_files`` results). If
omitted and ``model_id`` is provided, downloads all files
for the model.
dest_dir: Local directory to save into. Default: Kiln's own
downloads folder in the temp directory (the reply names
the path).
file_name: Override the saved file name (single-file mode only).
Defaults to the original name from the marketplace.
model_id: Model/thing ID. When ``file_id`` is omitted,
all files for this model are downloaded.
source: Marketplace source — ``"thingiverse"`` (default),
``"myminifactory"``, etc.
download_all: When True, downloads all files for the model
regardless of whether ``file_id`` is provided.
A downloaded GLB is handed on as an STL beside it, because the
stage, the slicer and printers cannot open a GLB: its
``local_path`` is the STL, and ``conversion`` names the
original, which stays on disk (``conversion_failed`` says so
when a GLB cannot be read). The stage opens on the first
downloaded file it can draw, and
the result measures that file (``validation``, ``dimensions``;
``size_check`` when its size reads like a units mix-up) and says
where the files came from (``came_from``: the marketplace and,
when its listing could be read, the designer, license and page).
A note beside each file keeps where it came from, so the stage
and design history can say so later; ``show_on_stage(path)``
opens any of the other files. Then upload to a printer with
``upload_file`` and print with ``start_print``.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.
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.
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": "download_model"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| source | No | Marketplace source — ``"thingiverse"`` (default), ``"myminifactory"``, etc. Default: "thingiverse". | |
| file_id | No | Numeric file ID (from ``model_files`` results). If omitted and ``model_id`` is provided, downloads all files for the model. | |
| brief_id | No | The saved goal's id from ``design_session``, so this make is recorded against the goal and checked against it. Empty when there is no goal. Default: "". | |
| dest_dir | No | Local directory to save into. Default: Kiln's own downloads folder in the temp directory (the reply names the path). | |
| model_id | No | Model/thing ID. When ``file_id`` is omitted, all files for this model are downloaded. | |
| file_name | No | Override the saved file name (single-file mode only). Defaults to the original name from the marketplace. | |
| download_all | No | When True, downloads all files for the model regardless of whether ``file_id`` is provided. Default: false. |