MCP serverio.simplyprint/simplyprint

Add a comment (general or feedback) to a queue item or user file. File attachments are not supported via MCP.

Queue a file for printing. Pick exactly one file source: fileId (hex hash from the files.simplyprint.io Upload endpoint) or filesystem (UserFile.uid of an existing library file). S

Adjust the remaining weight of a filament spool (e.g. after manual weighing).

Approve one or more pending/revision/denied queue items, with optional comment.

Archive a print job (hide from default history listings).

Assign a filament spool to a printer (or a specific extruder slot).

Assign a maintenance task to a user, or pass no user_id to unassign it. Set notify true to tell them.

Assign or remove routing tags on a file, including material colour. Use file_id (the UserFile.uid from list_files) and material=[{color, hex, nozzle, ext}] for a colour tag. This t

Cancel a maintenance job that is not going to happen. If it was in progress this also returns the printer to the AutoPrint rotation. Not the same as completing it: no work is recor

Cancel the current print on a printer

Cancel a print that has not started yet - either waiting for its scheduled time or waiting in a staggered start queue - and free the printer. This does NOT cancel a print that is a

Close a maintenance job as done. This RETURNS THE PRINTER TO THE AUTOPRINT ROTATION, so only call it when the work has actually been carried out - confirm with the user first. Opti

Tick one task off a maintenance job. Does NOT complete the job or return the printer to the AutoPrint rotation - use complete_maintenance_job for that once every task is done. If t

Create a new folder (or edit an existing one with optional org-level permissions).

Start a print job on one or more printers, now or at a chosen time. File source is exactly one of: file_id (API file hash from upload), filesystem (user-file uid), queue_file (exis

Delete one or more files.

Delete one or more folders.

Delete an approval comment you authored (or any comment if you have the permission).

Delete a queue group. Optionally move its items to another group via move_to.

Deny a pending queue item, either removing it or requesting revisions. Include a comment explaining the decision.

DESTRUCTIVE: Delete all items from the queue (optionally filtered by group or done-only). Confirm with the user before calling.

Estimate the print cost of a file, optionally for a specific printer.

Account-level print statistics (success rate, filament used, print time, cost) with optional date range and user/printer filters.

One-shot summary of farm-wide printer state. Use this (NOT list_printers) when the user asks "how many printers are printing/idle/awaiting bed clear/etc." or "what is the state of

Get details of one specific filament spool. Use this (NOT list_filaments+grep) when the user names a spool by id or short id. Accepts spool_id (the integer DB id) or spool_short_id

Retrieve the usage history of a filament spool.

Get a folder's details including permissions.

Whole-account maintenance overview in one call: counts (in maintenance, scheduled, overdue, open problems, low/out of stock), the single next due job, the 10 most recent jobs, per-

Full detail for one maintenance job: the task checklist with per-task completion, assignee and spare-part requirement, the printer's stats since its last maintenance, the problems

Cheapest fleet-wide maintenance check; takes no parameters. Returns an object keyed by printer id, each entry holding status (in_maintenance, due or scheduled) and next_scheduled_d

Find the best-matching queue item(s) for a set of printers using SimplyPrint's compatibility matcher.

Read-only preview: for each given printer, return the next queue item that would be started. Uses the same dedup matcher as create_print_job with next_queue_item=true, so the same

Get detailed info for a specific print job.

Get details, status, temps, current job, filament, notifications for ONE specific printer by id. Use this (not list_printers) whenever the user asks about a single printer they've

Everything known about one printer's maintenance: current status, health (last maintenance, days since, open problem count, active job), lifetime print and maintenance stats, the l

Get details of a specific queue item

Calculate the estimated cost of a queue item, optionally for a specific printer.

Referral program statistics: conversions, earnings, pending payout.

Retrieve slicer settings stored for a file.

Get one or more realistic sample webhook payloads for a specific event type, matching the envelope a live webhook delivery would produce. Used by integration platforms (Activepiece

Home the printer axes (move to origin position)

Show which queue items match/miss a specific printer and why. Useful for diagnosing why a queue item will not print.

List filament products from a specific brand.

List custom field definitions with pagination and search.

List custom field definitions for a specific entity category and optional sub-category (e.g. PRINT + PRINT_QUEUE for queue-item custom fields).

List available filament colors (for UI pickers or picking similar spools).

List filament spools with optional filters and sorting. Accounts often have hundreds of spools, so ALWAYS pair sort_by with a limit. Use sort_by=last_used + limit=10 for "most used

List files and folders in the user's SimplyPrint storage. With pid set, only returns files compatible with that printer (full compatibility check). With global_search=true (default

List maintenance jobs across the account with filters, paging and sorting — the tool for "what maintenance is outstanding, and on which printer". Each job carries its printer, prio

List reported printer problems with their description, problem type, reporter, status and age — get_maintenance_dashboard returns only an open-problem count, none of this. Returns

List queue items pending approval (status: PENDING, DENIED, or REVISION).

List past print jobs with pagination, filters, and sort. Compact mode (default) drops gcodeAnalysis, filament breakdowns, and panel-only flags.

List MULTIPLE printers with optional filters. For details on a single known printer, call get_printer instead — do not list-then-filter. For farm-wide counts ("how many printers ar

List print queue items with optional filters. Supports filtering by assigned printer(s), group, approval status, tags, queue-item custom-field values, and age. Example: older_than_

Retrieve all approval comments on a queue item or user file.

List all queue groups in the user's account.

List every print across the account that is waiting for a scheduled start time, soonest first. Use this for "what is scheduled tonight", "do I have anything queued up for tomorrow"

List maintenance spare parts with stock level, low-stock threshold, SKU, category, cost and the printer models each part fits. Requires the Maintenance Inventory plan feature: with

Mark a filament spool as freshly dried (resets humidity tracking).

Find which printer models in the account are compatible with a given file.

Move one or more files to a folder.

Move a folder to another location.

Move a printer axis to a relative position

Move one or more queue items to a different queue group.

Pause the current print on a printer

Remove an item from the print queue

Move a queue group to a new position.

Move a single queue item to a new 1-based position.

Change when a scheduled print starts, or release it immediately. Pass schedule_for with a new absolute instant to move it; omit schedule_for (or send null) to start the print now.

Resubmit a denied or revision-requested queue item back to pending approval. File-replacement is not supported via MCP.

Resume a paused print on a printer

Bring a completed (done) queue item back to the active queue.

Create a new queue group or update an existing one.

Revoke approval on an already-approved item and send it back to the submitter for revisions.

Send G-code commands to a printer

Set custom field values on one or more entities (queue items, files, printers, etc.). Use this to set a "deadline" or similar field across many queue items at once.

Set the printers/models/groups a file is assigned to.

Control the printer cooling fans

Enable or disable the printer stepper motors

Set target temperatures (nozzle, bed and/or chamber) on one or more printers - works while idle and mid-print. Values above the printer model maximum are clamped; 0 turns a heater

Mark a task as skipped rather than done - it was not needed this time. Reversible with unskip_maintenance_task.

Move a scheduled maintenance job to in-progress, putting the printer into maintenance mode so AutoPrint stops sending it work. Only works on a job in "scheduled" status. This is th

Restore an archived print job.

Remove a filament spool from its printer assignment.

Reopen a task that was ticked off by mistake. The undo for complete_maintenance_task.

Undo a skip, putting the task back on the job as outstanding.

Update file metadata such as name and GCODE analysis.

Edit an approval comment you authored.

Update a queue item (amount, note, custom print time, material usage, printer assignments).