Create filament profile
create_filament_profileCreates a filament preset from spool-label details, fills missing values with material defaults, and previews before saving to the slicer's user presets.
Instructions
Turn the details printed on a filament spool label into a filament preset for the slicer.
Read the label photo yourself and pass what it says; only material is required, and anything missing gets a typical value for that material (listed in the result). The preset inherits from the closest existing preset for the printer. With save=false it only returns a preview; show it to the user, then call again with save=true to write it to the slicer's user presets (overwrite=true replaces an existing one). For other preset edits use save_user_preset.
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": {
"material": "<material>"
},
"name": "create_filament_profile"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| name | No | Preset name. Default: 'Brand Product Colour @printer'. | |
| save | No | False (default) only previews. True writes the preset; do it after the user confirms the preview. | |
| brand | No | Brand on the label. | |
| price | No | Price paid for the spool, used to set cost per kg. | |
| drying | No | Drying instructions from the label, kept in the profile notes. | |
| bed_max | No | Highest bed temperature on the label, °C. | |
| bed_min | No | Lowest bed temperature on the label, °C. | |
| density | No | Density in g/cm³ if printed on the label. | |
| printer | No | Printer preset name or a unique part of it, e.g. 'Kobra X'. Omit to use the printer selected in the slicer window. | |
| product | No | Product line on the label, e.g. 'Silk' or 'Matte'. | |
| material | Yes | Material printed on the label, e.g. 'PLA', 'PETG', 'PLA+', 'ABS', 'TPU', 'PA-CF'. | |
| weight_g | No | Net filament weight in grams, e.g. 1000. | |
| overwrite | No | With save=true, replace an existing preset of the same name. | |
| colour_hex | No | Colour as '#RRGGBB', estimated from the photo if the label has none. | |
| nozzle_max | No | Highest nozzle temperature on the label, °C. | |
| nozzle_min | No | Lowest nozzle temperature on the label, °C. | |
| colour_name | No | Colour name on the label, e.g. 'Galaxy Black'. | |
| diameter_mm | No | Filament diameter, usually 1.75. | |
| max_speed_mm_s | No | Maximum print speed in mm/s if printed on the label. | |
| add_to_inventory | No | With save=true, also record the spool in the local inventory. | |
| nozzle_recommended | No | Recommended nozzle temperature if the label gives one, °C. |