register_printer
Register a 3D printer with the Kiln fleet. Specify the printer type, host, and API key to enable remote monitoring and job submission via MCP.
Instructions
Register a new printer in the fleet.
Free and Pro each allow 1 printer. Fleet starts at Business (3 printers
included, $15/mo per additional to a cap of 50); Enterprise is uncapped.
Args:
name: Unique human-readable name (e.g. "voron-350", "bambu-x1c").
printer_type: Backend type -- "octoprint", "moonraker", "bambu",
"creality", "elegoo", "prusalink", "duet", or "usb".
"serial" is accepted as a legacy alias for "usb".
host: Base URL or IP address of the printer. For USB printers,
this is the port path (e.g. "/dev/ttyUSB0", "COM3").
api_key: API key (required for OctoPrint and Bambu, optional for
Moonraker/Creality, unused for USB). For Bambu printers
this is the LAN Access Code.
serial: Printer serial number (required for Bambu printers).
verify_ssl: Whether to verify SSL certificates (default True).
Set to False for printers using self-signed certificates.
For Bambu, True maps to TLS pin mode and False maps to
insecure mode.
printer_model: Optional safety/profile key (e.g. "k1_max").
persist: Save the printer to ``~/.kiln/config.yaml`` so future MCP
sessions load the same printer. Default ``True``.
verify_connection: For Bambu printers, immediately query AMS status
after registration and return a proof summary. Default ``True``.
baudrate: Baud rate for USB printers. Defaults to
``DEFAULT_SERIAL_BAUDRATE``; many Marlin boards are flashed
for 250000 and will not talk at the default.
Once registered the printer appears in ``fleet_status()`` and can be
targeted by ``submit_job()``.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| host | Yes | ||
| name | Yes | ||
| serial | No | ||
| api_key | No | ||
| persist | No | ||
| baudrate | No | ||
| verify_ssl | No | ||
| printer_type | Yes | ||
| printer_model | No | ||
| verify_connection | No |