ams_status
Read-only
Inspect all AMS trays to verify loaded filament type, color, remaining amount, RFID, and humidity before printing or selecting AMS mappings.
Instructions
Full AMS hardware dump — all trays, humidity, RFID (Bambu Lab only).
For just the currently-active material, use ``get_active_material``
instead. For Kiln's software material tracker, use ``get_material``.
Returns what's loaded in each AMS tray: filament type, color, remaining
percentage, RFID tag, temperature ranges, and humidity.
Each tray carries its unit's own ``slot`` (0-3), the printer's
``tray_id`` for it (``unit * 4 + slot`` on a chained unit, the unit id
itself on an AMS HT) and Studio's ``name`` (``A1``…``D4``, ``HT-A``);
each unit carries its ``name`` (``A``, ``HT-B``). ``feeding`` is the
tray feeding the nozzle -- ``{tray_id, unit, slot, name, source}``, or
``None`` when nothing feeds -- and ``feeding_source`` says which field
of the printer's report it came from. The raw ``tray_now`` is kept as
sent: ``"254"`` is the external spool,
``"255"`` no tray. A1 / AMS Lite reports may keep ``tray_now`` at
``"255"`` while exposing loaded AMS trays and selected/target tray
fields such as ``tray_pre`` or ``tray_tar``. The ``ams_exist_bits`` and
``tray_exist_bits`` fields are bitmasks showing which AMS units and
trays are physically present.
Use this to check filament levels before printing, verify the correct
material is loaded, or select the right ``ams_mapping`` for
``start_print()``.
This dump carries no fault line of its own. To follow a print, poll
``printer_status(detail="lite")``: it reports the run state and every
fault code under ``faults``. A fault the printer stops for on a
watched print also rides this and every other tool result as
``printer_fault`` while it stands.
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": "ams_status"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||