MCP Overview

List printers in the organization, including connectivity (`offline` / `is_connected`) and print activity (`status`).

Select printers by safe criteria such as status, ready verification, bed-clear verification, no AMS, and not locked.

Get real-time printer state including temperatures, progress, speeds, fans, and AMS data.

Get Bambu AMS tray state or Snapmaker/Klipper toolchanger extruder state, including material, color, and remaining amount.

Read the current Guided Filament Rotation lifecycle state for a printer.

Resolve narrated filament assignment intent to a visible printer, Bambu AMS slot, and existing catalog candidate without changing Hive or claiming physical loading.

List 3MF files stored on a connected printer and available for printing.

Check the status of an asynchronous printer file upload or delete task.

Get temperature telemetry for a specific print job.

List print jobs in the organization, optionally filtered by status or printer.

Get detailed information about a specific print job.

Get event history for a specific print job.

Summarize queued jobs, schedulable jobs, and idle or soon-available printers with nothing compatible queued.

Find active print jobs that are busy but not productively progressing, such as paused, failed, stalled, or overrunning jobs.

Rank printers by how well each can run a given model file, including model and filament compatibility evidence.

Forecast whether proposed or existing production work is safe to promise using capacity, queue, material, printer, and risk evidence without mutating production state.

Return ranked observe-mode Smart Queue intervention bundles with operator actions, evidence, and expected impact without mutating farm state.

Analyze recurring print failures by printer, job, model file, material, spool, and reason so Hex can answer reliability and root-cause questions without implying automatic controls.

Search safe, organization-scoped resources needed to create queued print jobs, such as model files, printers, materials, and job context.

Report fleet and per-printer utilization over a time window with idle-reason attribution.

Return a prioritized action list that synthesizes utilization, risk, queue health, and network health.

Show per-printer idle gaps between jobs, ordered worst-first by idle time.

Predict filament runout risk by comparing loaded AMS material against upcoming job requirements.

Report per-printer and fleet throughput, completed jobs, success rate, duration, filament use, and failure reasons.

Summarize a bounded operator session or shift, including starts, resumes, cleared errors, and utilization change.

Diagnose why printers are unreachable on the local network, including host-side evidence and possible IP drift.

Summarize due and overdue maintenance tasks by printer, priority, severity, task definition, current condition, health signals, freshness, and warnings.

Plan downtime-aware maintenance service windows for what to service now, next idle window, or defer cautiously without mutating production state.

Read sanitized briefing and at-risk alert settings, schedules, thresholds, notification runs, and recent delivery failures.

Read sanitized Hex capability statuses, reason codes, remediation targets, and prompt suggestions for the active organization.

Read durable recommendation receipts so Hex can answer what is still open, completed, assigned, or dismissed.

Read active human-authored operational context such as avoided printers, reservations, suspect spools, and handoff notes.

Resolve and preview one temporary farm, printer, print-job, or material annotation without changing active operating context.

Read the prioritized operator action feed (the same ActionItem envelope the web feed uses) to answer "what should I do next?", render Hex action cards, or inspect current blockers.

Read the operator-aware dispatch queue, including personal assignments, unassigned work, stale assignments, and blocked task eligibility.

Store a server-owned, versioned Hex operation proposal without executing it or returning its private normalized payload. The app later verifies and decides by proposal id/version only.

Create, revise, or resolve one server-stored temporary operator annotation proposal after explicit approval; replay returns the same receipt.

Record one narrated filament assignment intent in Hive after explicit operator approval. It updates assignment metadata only and does not physically load filament or move hardware.

Load filament from an AMS tray into the extruder after re-validating printer eligibility.

Unload the currently loaded filament from the extruder after eligibility checks and explicit confirmation.

Send the Bambu acknowledgment that completes a Guided Filament Rotation load prompt.

Sync Hive filament slot assignments to a printer's AMS metadata — the control action behind filament-blocked action cards; records the loaded spool mapping and sends AMS settings to the printer.

Create a queued Hive print job after explicit approval. This queues the job record only; it does not start physical printing.

Duplicate the latest terminal Hive Cloud print job assigned to a printer and queue it for the same printer.

Mark one or more printers ready as an operator override, using named printers or safe criteria.

Pause the currently running print job.

Resume a paused print job.

Set print speed to silent, normal, sport, or ludicrous.

Turn the chamber or work light on or off.

Set part cooling, auxiliary, or chamber fan speed from 0 to 100 percent.

Home all axes. This should not be used while printing.

Run automatic bed leveling. This should not be used while printing.

Upload a model file from the library to a printer as an asynchronous task.

Delete a file from a printer as an asynchronous task.

Cancel or stop the current print job. This action cannot be undone.

Set nozzle or bed temperature directly, including an extruder selector for multi-extruder printers.

Execute raw G-code commands on the printer.