MCP Overview

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

Select printers by safe criteria such as status, tags, ready verification, bed-clear verification, no AMS, and not locked. A prefixed tag matches its value and its key: value label. The prefix key alone does not match. Tags are labels, not rack, row, or bay.

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.

Render a 1280×720 Status Card JPEG: the printer's latest camera frame with a live telemetry overlay. Returns the image, the same text summary as printer_live_status, and structured card data. Frames older than 60 seconds are dimmed and labeled LAST FRAME; frames older than 15 minutes render CAMERA UNAVAILABLE. The `overlay` argument selects `full` (default), `minimal` (slim bottom strip), or `none` (bare frame).

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. With a printerId, map the file's filaments onto that printer's trays and return the mapping, its blockers, and a picture of it.

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.

Rank materials by replenishment risk across on-hand stock, minimums, burn rate, queued demand, and open purchase requests, with quantity recommendations and read-first purchase-request intent.

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.

Start a quick, read-only Connectivity Diagnostic Run against a host or printer's current host — network reachability, resource, and printer-liveness checks only.

Read a previously started Connectivity Diagnostic Run by id, including its per-check evidence and originating context.

Read the live per-check progress snapshot for a Connectivity Diagnostic Run that may still be executing.

Start a standard Connectivity Diagnostic Run: bounded printer control-channel checks (TCP, TLS, authentication, heartbeat) without touching printer storage.

Start a deep Connectivity Diagnostic Run: a guarded, disposable data-plane canary against one printer, executed only after a fresh Action Guard confirms it is safe.

Request Recovery Verification for an open Connectivity Incident after an operator reports a corrective action; the platform chooses the check battery that proves recovery.

Read-only diagnostic packet for a stuck, locked, or failed printer or print job — correlates current state, job status, lock ownership, HMS/print-error evidence, and recent timeline into one versioned packet with a headline, stable reason tags, cited evidence, and safe next actions.

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.

Validate a potential assistant watch (printer/print job/material slot/action item condition) and explain what it would monitor, without creating anything.

Read the organization's active durable shop operating preferences (scheduling, quality-gate, escalation, material-substitution, and assistant-decision policies).

Evaluate active shop policies against a printer, material, job/order, or operator context and return matches with effect, hard/soft mode, confidence, and reasons.

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.

List global and organization printer tag templates (prefix catalogs).

List observed printer tags: simple labels, prefixed keys, and values in use. This is not rack, row, or bay.

Read simple and prefixed tags on one organization printer.

Create a confirmed organization printer tag template (prefix plus allowed values).

Rename or revise a confirmed organization printer tag template. Global templates cannot be changed.

Delete a confirmed organization printer tag template. Assigned printer tags stay on printers.

Replace all tags on one organization printer. Pass the full list. Omit a tag to unassign it.

Apply one printer tag template to a printer using the template default or first allowed value.

Create a bounded, read-only assistant watch on a printer, print job, material slot, or action item after explicit operator confirmation.

Cancel an active assistant watch by id after explicit operator confirmation.

List the organization's webhook endpoints and event subscriptions. Signing secrets are never returned.

Create a named HTTPS subscription with confirm:true and webhooks:write. The signing secret is returned once; store it securely.

Update a subscription or rotate its signing secret with confirm:true and webhooks:write. A replacement secret is returned once.

Delete an organization webhook endpoint with confirm:true and webhooks:write.

Queue a synthetic webhook.test event with confirm:true and webhooks:write. The worker delivers it asynchronously.

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, including tags.

Search active organization Model Files by literal filename or tag substring. Consume current pages until nextCursor is null. Revisions are decimal strings. This tool does not freeze a selection.

Preview an exact selection with source Model IDs and decimal-string revision preconditions. The preview does not reserve files or authorize a move. General rollout remains gated.

Move 1 to 200 reviewed Model Files atomically with library write authority, confirm: true, an idempotency key, and Hex approval. Returns a durable receipt. Retry the same exact command and key after resource_busy. General rollout remains gated.

Read a durable move receipt by operation ID within the current organization. Receipt reads and exact retries remain available when new moves are disabled.

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.

Plan a restock run from OUT/LOW retail SKUs: match each item to one Make, then list the queueable printers per linked model file. Read-only; the operator picks among candidates and job_create does the queueing.

List Operator Tasks on the organization Task Board. Filter by Make, SKU / retail alias, or linked Print Job. This is not action_items_list and not operator_annotation_*.

Get one Operator Task by id, including linked Print Job ids, Make id, and SKU / retail aliases.

Create confirmed model metadata from an external source.

List distinct tags already in use on organization models and model files.

Replace tags on one organization model. Pass the full list. Omit a tag to unassign it.

Replace tags on one organization model file. Pass the full list. Omit a tag to unassign it.

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.

Create an Operator Task the same way the web Create Task action does. Link an existing Print Job and/or Make. Optional skuAliases store retail names for later restock matching. Requires confirm:true. Does not start a print. This is not action_items_list and not operator_annotation_*.

Update an Operator Task, including Make, Print Job, and SKU / retail alias links. Requires confirm:true. Does not start a print.

Complete an Operator Task by moving it to the Done swimlane. Requires confirm:true. This is not archive and not a printer Device Task Identity.

Attach a .stl or .3mf onto an existing library Model using the same upload intent, signed PUT URL, finalize RPC, and processing worker as the web uploader. These files are library slice sources. 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.

Get signed URLs for a Cloud Slice Request's published output archive and available thumbnails in the authenticated organization. Requires models:read. URLs expire after one hour. includeGcode defaults to false; set it to true for base64 plate G-code, limited to 1 MiB total from archives up to 64 MiB. Missing files and extraction limits are reported in unavailable. Does not send G-code or start a printer.

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.

Read one Cloud Slice catalog profile with flattened, sanitized settings. Does not start a printer.

Read one setting from a Cloud Slice catalog profile. Does not start a printer.

Create a Cloud Slice Profile Set draft from selected catalog profiles and structured overrides. Does not start a printer.

Read one Cloud Slice Profile Set by id, including selections, overrides, and last validation. Does not start a printer.

Read the effective value of one setting on a Cloud Slice Profile Set: the override when present, else the base profile value. Does not start a printer.

Upsert one structured override on a Cloud Slice Profile Set. Dangerous and protected keys are rejected. Does not start a printer.

Remove one structured override from a Cloud Slice Profile Set. Does not start a printer.

Recompute and store validation findings for one Cloud Slice Profile Set. Does not start a printer.

Create a Cloud Slice Plate Layout draft from a library source file's 3MF object inventory and a catalog printer profile. Does not start a printer.

Read one Cloud Slice Plate Layout by id, including objects, quantities, placements, fit, and the request selections projection. Does not start a printer.

Set the requested quantity of one object on a Cloud Slice Plate Layout. Does not start a printer.

Place one object instance at explicit plate coordinates on a Cloud Slice Plate Layout. Does not start a printer.

Run the deterministic arrange pass over the requested quantities on a Cloud Slice Plate Layout. Does not start a printer.

Recompute fit findings for one Cloud Slice Plate Layout: off-plate, exclusion-zone, overlap, and unplaced findings. Does not start a printer.

Read printability findings for one Cloud Slice Plate Layout: fit findings plus per-object support and overhang analysis from the source 3MF mesh stats. Does not start a printer.

Read plates, parts, and filaments for one library source file, with default selections and suggested material bindings for slice_request_create. Call after model_file_upload finishes. Does not start a printer.

Read the Cloud Slice Service configuration status: booleans only, never secrets or values. Shows whether Fly dispatch, library storage, the callback URL, and the bundle secret are configured. Does not start a printer.

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

Queue a copy of a completed print job by id, with its printer and filament mapping. Hex duplicates through an operator-approved proposal instead.

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.