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.

Return generic connection slots (secret, identifier, host, port) for a printer brand and model. Does not write. Does not accept vendor column names. Unknown types are not defaulted to Bambu.

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

Resolve the current organization-scoped printer identity and checked-in motion profile, then return a read-only camera-coverage proposal when `recipe` is `camera_coverage` or omitted. The tool sends no hold, release, capture, or printer command and does not prove clearance, homing, plate state, or current Z.

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, in chronological order (at most 500 samples). Sets `truncated` when the print ran past the cap, so a clipped series is never mistaken for the whole print — `returned_sample_count` counts the samples in that response and is never a total for the job.

List one page of print jobs in the organization, newest first (at most 200), optionally filtered by status or printer. Sets `jobs_truncated` when older matching jobs were left out, so a page is never mistaken for the whole queue or used as a job count — `queue_health` owns queue totals.

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 organization-scoped models, model files, printers, materials, and makes. Models and materials include a uniqueness match so close scores are not picked in silence.

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 explicitly named printers ready as an operator override. Resolve a set with printers_query first so the approval prompt can enumerate every printer being changed.

Return trusted Print Hive web destinations for signup, printer credential entry, and binary model-file uploads.

List active organization models with metadata, tags, and visibility.

List organization-scoped model files, optionally for one model.

List global and organization-owned filament materials.

List Parts (farm hardware and spares). These are not filament materials. Diameter is not used.

Parse a filament product page URL into brand, product name, color, and material type, then match the existing filament catalog. confirm imports an Organization Filament. Missing required fields fail closed.

List filament inventory with material details and low-stock state.

List organization Inventory Orders for filament and Parts bought from vendors. Status pending means ordered or incoming.

Get one Inventory Order and its filament and Part lines in the authenticated organization.

List Makes and their linked model files.

Create confirmed model metadata from an external source.

Create a confirmed Organization Filament. Color is hex RGB stored as #RRGGBB. Finish is standard, matte, or silk.

Create a confirmed organization-owned Part catalog item for farm hardware or spares. Diameter is not accepted. Does not add stock.

Update a confirmed Organization Filament (hex color, finish, SKU, name, brand, material type, diameter, ASIN). Color is hex RGB stored as #RRGGBB. Finish is standard, matte, or silk. SKU must be unique. Global Filament rows are read-only. Inventory item ids stay the same. Illegal calls: confirm false, empty update, display-name color, translucent finish, raw metadata bag, a Global Filament id.

Atomically add or remove confirmed stock and record an audit transaction.

Record a confirmed vendor purchase of filament, Parts, or both as a pending Inventory Order. Filament lines use materialId and weightPerUnit in grams. Part lines use kind=part and partId. Reuse orderId for retries. Does not add stock.

Create a confirmed Make linked to validated organization model files, optional named filament slots, and SKU.

Attach a .3mf onto an existing library Model using the same upload intent, signed PUT URL, finalize RPC, and processing worker as the web uploader. Does not send files to printers.

List Cloud Slice printer, filament, and process profiles in the authenticated organization. Does not start a printer.

Read one Cloud Slice Request by id. Returns phase, quality, and the published Model File id when complete.

List Cloud Slice Requests for the authenticated organization. Paginated. Does not start a printer.

Create a Cloud Slice Request from a library source file and profile ids. Requires confirm=true. Slices in the cloud. Does not start a printer or send G-code.

Cancel one Cloud Slice Request that is not yet terminal. Requires confirm=true. Does not stop a printer.

Request confirmed dispatch of a queued, assigned job through the canonical atomic start flow.

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.