ams_filament_drying
Destructive
Start or stop an active filament-drying cycle on Bambu AMS 2 Pro or AMS HT units, with temperature ceiling checks before commands are sent.
Instructions
Start or stop an AMS 2 Pro / AMS HT active dry cycle.
Bambu printers with an AMS 2 Pro or AMS HT dry filament in place.
This controls that dryer.
To START (``mode=1``): set ``temp_c`` (drying temperature),
``duration_min`` (> 0), and ``cooling_temp_c`` -- which must be
>= 45, or the printer silently ignores the command. A start is
checked against the unit's own ceiling (AMS 2 Pro 65 C, AMS HT 85 C)
before it is sent; when Kiln cannot run that check, nothing is sent and
the answer says why. To STOP (``mode=0``): only ``ams_id`` is needed,
and a stop is always sent.
Only Bambu printers with an AMS 2 Pro / AMS HT support this; other
printers and plain AMS / AMS Lite units return an error.
:param ams_id: AMS unit index (0-based).
:param mode: 1 to start drying, 0 to stop.
:param duration_min: Dry-cycle length in minutes (> 0 to start).
:param temp_c: Drying temperature in C (required to start). A value
above the unit's own drying ceiling is refused, never lowered;
the refusal names the ceiling.
:param cooling_temp_c: Cooldown temperature in C (>= 45 to start).
:param humidity: Target relative humidity in percent, when the unit
supports a humidity target.
:param rotate_tray: Whether the unit turns the spool during the cycle
(``True``/``False``); leave unset to keep the unit's own setting.
:param printer_name: Target printer. Omit for the default printer.
:returns: Dict with the dispatched command and a status message.
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": {
"ams_id": "<ams_id>",
"mode": "<mode>"
},
"name": "ams_filament_drying"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | 1 to start drying, 0 to stop. | |
| ams_id | Yes | AMS unit index (0-based). | |
| temp_c | No | Drying temperature in C (required to start). A value above the unit's own drying ceiling is refused, never lowered; the refusal names the ceiling. | |
| humidity | No | Target relative humidity in percent, when the unit supports a humidity target. | |
| rotate_tray | No | Whether the unit turns the spool during the cycle (``True``/``False``); leave unset to keep the unit's own setting. | |
| duration_min | No | Dry-cycle length in minutes (> 0 to start). Default: 0. | |
| printer_name | No | Target printer. Omit for the default printer. | |
| cooling_temp_c | No | Cooldown temperature in C (>= 45 to start). |