prepare_ai_model_for_print
Fix unit errors in AI-generated 3D models and prepare them for printing—corrects meters-to-millimeters mix-ups, scales to target height, validates, and recommends simplification or hollowing.
Instructions
Prepare any AI-generated model for printing — fixes the unit mix-up.
AI model generators (Meshy, Tripo, Stability, Gemini) routinely
export models in meters instead of millimeters, so a 60mm figurine
reads as 0.06mm. This tool corrects that by the real unit
conversion when exactly one explains the size — never by scaling
to an invented "reasonable" target — then runs the full validation
pipeline and provides smart recommendations for simplification
and hollowing.
Pipeline:
1. Run validate_and_prepare for baseline analysis
2. Size — scale to target_height_mm when given; otherwise
apply a unit correction only when exactly one real
conversion (meters, centimeters, inches, microns) lands
the model at a printable size. A size several units
could explain, or none can, is reported, never guessed at.
3. Mesh simplification recommendation (if > 100K triangles)
4. Smart hollow recommendation (only when appropriate)
5. Re-validate the scaled model
6. Return combined before/after comparison
Works with STL, OBJ, and 3MF files.
:param input_path: Path to the AI-generated model file.
:param target_height_mm: Desired height in mm — an instruction,
honored at any starting size. If 0, only a unit mistake is
ever fixed; the model's designed size is otherwise kept.
:param printer_id: Optional printer model ID for bed-fit checking.
:param material: Material name (default "PLA") for material checks.
:returns: Dict with original/prepared comparison, actions taken,
recommendations, and next_action for slicing.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
| Name | Required | Description | Default |
|---|---|---|---|
| material | No | PLA | |
| input_path | Yes | ||
| printer_id | No | ||
| target_height_mm | No |