mcp server

SimplyPrint: 3D Print Farm Management

3D print farm management for AI. Monitor, queue, and control prints on your SimplyPrint account.

Description as published by the maintainer. Source

• version 1.0.1
• slowing

slowing — Registry entry last updated 2026-04-22.

What this server can do

71 functions, named and described by the server itself. Parameter names are shown because they say more about what a function does than its name usually does.

add_queue_comment(type, comment, file_id, item_id)

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

add_to_queue(tags, group, amount, fileId, position, filesystem, for_groups, for_models, for_printers, custom_fields)

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). Supports PRINT_QUEUE custom fields.

adjust_filament_weight(filament_id, percent_left, weighed_gross, grams_remaining, empty_spool_weight, subtract_empty_spool, save_empty_spool_weight)

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

approve_queue_item(job, jobs, comment)

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

archive_print_job(jobs, reason)

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

assign_filament(source, extruder, printer_id, filament_id)

Assign a filament spool to a printer (or a specific extruder slot). Required: printer_id, filament_id.

cancel_print(reason, comment, printer_id, custom_position, return_position, return_to_queue)

Cancel the current print on a printer Required: printer_id.

create_folder(org, name, item_id, org_perms, parent_folder)

Create a new folder (or edit an existing one with optional org-level permissions). Required: name, parent_folder.

create_print_job(file_id, mms_map, reprint, filesystem, printer_id, queue_file, custom_fields, start_options, next_queue_item, individual_custom_fields)

Start a print job on one or more printers. File source is exactly one of: file_id (API file hash from upload), filesystem (user-file uid), queue_file (existing queue item id), reprint (previous print-job id), or next_queue_item=true (auto-pick the next matching queue item per printer, deduplicated across printers). Supports PRINT_JOB custom fields (shared and per-printer). Auto-starts when the account's autostartPrints setting is on (default). Required: printer_id.

delete_file(file)

Delete one or more files. Required: file.

delete_folder(folder)

Delete one or more folders. Required: folder.

delete_queue_comment(item_id)

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

delete_queue_group(item_id, move_to)

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

deny_queue_item(job, jobs, remove, comment)

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

empty_queue(group, done_items)

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

estimate_file_cost(item_id, mms_map, newFile, analysis, printer_id)

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

get_account_statistics(users, general, end_date, printers, fake_data, start_date, printer_models)

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

get_farm_overview

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 the farm". Returns a total and {count, printers:[{id,name}]} for each bucket: online, offline, not_connected, operational (idle), printing, paused, awaiting_bed_clear (a print finished but the bed has not been cleared yet — printer is online + operational + still has a job; this is NOT print_pending), in_maintenance, print_pending (a queued staggered/scheduled start), requires_attention (has unresolved error notifications), ai_running, ai_detected_low, ai_detected_high. Counts overlap intentionally: a printer can be in "online" + "printing" + "ai_running" at once.

get_filament(public, spool_id, company_id, locationscount, spool_short_id)

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 (the 4-character code shown on QR labels and the spool view page, e.g. "T2SO", "M0WT").

get_filament_history(page, public, item_id, perPage, user_id)

Retrieve the usage history of a filament spool.

get_folder(item_id)

Get a folder's details including permissions. Required: item_id.

get_maintenance_dashboard

Overview of maintenance jobs, problems, inventory, and printer maintenance status.

get_next_queue_item(compact, filters, sorting, settings, deselects, normalOnly, printer_id, mustClearBed, queueGroupsOrder, skippedQueueItems, includeTodoSummary, specificQueueGroups)

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

get_next_queue_items_for_printers(compact, printer_id)

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 queue item is never returned twice across printers in one call. Includes match failures per printer (issues) so you can explain why a printer has nothing to print. Does NOT start any job. Required: printer_id.

get_print_job(extra, item_id, getcustomfields)

Get detailed info for a specific print job. Required: item_id.

get_printer(compact, printer_id)

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 already identified — "status of printer X", "what's printer 5 doing", "temperature on Creality K2". Cheaper and less noisy than listing all printers. Required: printer_id.

get_queue_item(item_id)

Get details of a specific queue item Required: item_id.

get_queue_item_cost(item_id, mms_map, printer_id, queue_item_id)

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

get_referral_stats

Referral program statistics: conversions, earnings, pending payout.

get_slicer_settings_for_file(file)

Retrieve slicer settings stored for a file. Required: file.

get_webhook_sample(event, limit, version)

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 (Activepieces, n8n, Zapier) to show the payload shape before any real event fires. Falls back to synthetic data when no applicable entity exists in the account. Required: event.

home_printer(axes, printer_id, snippet_id)

Home the printer axes (move to origin position) Required: printer_id.

inspect_printer_queue(mode, printer_id)

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

list_brand_filaments(item_id)

List filament products from a specific brand. Required: item_id.

list_custom_fields(page, search, sort_id, end_date, sort_dir, page_size, start_date)

List custom field definitions with pagination and search. Required: page, page_size.

list_custom_fields_for(category, subCategory, includeDisabled)

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

list_filament_colors

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

list_filaments(brand, color, empty, limit, compact, sort_by, assigned, sort_dir, printer_id, material_type)

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 / most popular spool" questions. Use sort_by=created + limit=N for recently added. Use sort_by=left for emptiest/fullest. Filters (material_type/brand/color) are case-insensitive substring matches. If the user names a specific spool by id or 4-character short id (e.g. "T2SO"), call get_filament instead — do NOT list and grep. Amount-remaining fields: report weight from leftGrams/totalGrams (grams) and percentLeft (%), NOT the raw total/left which are internal filament LENGTH in mm. density (g/cm³) is the value used for the gram conversion; densityIsEstimated=true means the spool has no material profile so a default density was assumed.

list_files(f, limit, search, compact, sort_by, sort_dir, has_gcode, printer_id, global_search)

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), searches recursively across all folders.

list_pending_queue_items(page, status, per_page)

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

list_print_jobs(page, limit, search, compact, sort_by, sort_id, end_date, sort_dir, spool_id, user_ids, page_size, queue_job, start_date, printer_ids, printer_types, printer_groups, archived_status, accepted_statuses)

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

list_printers(page, tags, limit, search, status, compact, sort_by, sort_id, group_id, order_by, sort_dir, page_size, job_columns, out_of_order, printer_columns, filament_columns)

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 are doing X"), call get_farm_overview instead — do not paginate this. Use status=["online"] to only see reachable printers, status=["printing"] for ones actively printing, status=["was_printing_when_offline"] for printers that dropped mid-print, status=["idle"] for available printers ready to accept a job, status=["awaiting_bed_clear"] for printers whose last print finished but the bed has not been cleared yet (NOT print_pending, which means a queued staggered start).

list_queue(page, tags, group, search, compact, sort_by, sort_dir, page_size, printer_id, added_after, added_before, custom_fields, approval_status, newer_than_days, older_than_days)

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_days=7 for "items added more than 7 days ago", or custom_fields=[{id: "<uuid>", value: "Engineering"}] for a specific department field.

list_queue_comments(file_id, item_id)

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

list_queue_groups(item_id)

List all queue groups in the user's account.

mark_filament_dried(dried_at, filament_id)

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

match_file_to_printers(model, gcodeAnalysis)

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

move_file(files, folder)

Move one or more files to a folder. Required: files, folder.

move_folder(folder, target)

Move a folder to another location. Required: folder, target.

move_printer_axis(speed, distance, direction, printer_id, snippet_id)

Move a printer axis to a relative position Required: printer_id, direction, distance.

move_queue_item(jobs, target_group_id)

Move one or more queue items to a different queue group. Required: jobs, target_group_id.

pause_print(printer_id)

Pause the current print on a printer Required: printer_id.

remove_from_queue(job, jobs)

Remove an item from the print queue

reorder_queue_group(to, group_id)

Move a queue group to a new position. Required: to, group_id.

reorder_queue_item(to, from, queue_item_id)

Move a single queue item to a new 1-based position. Required: queue_item_id, to.

resubmit_queue_item(comment, queue_item_id)

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

resume_print(printer_id)

Resume a paused print on a printer Required: printer_id.

revive_queue_item(group, amount, position, priority, queue_item_id, position_index)

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

save_queue_group

Create a new queue group or update an existing one.

send_back_for_revision(comment, queue_item_id)

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

send_gcode(gcode, macro, printer_id, snippet_id, macro_context)

Send G-code commands to a printer Required: printer_id.

set_custom_field_values(values, category, entityIds, subCategory)

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. Required: category, entityIds, values.

set_file_printers(items, groups, models, printers)

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

set_printer_fans(speed, printer_id, snippet_id)

Control the printer cooling fans Required: printer_id, speed.

set_printer_motors(enabled, printer_id, snippet_id)

Enable or disable the printer stepper motors Required: printer_id, enabled.

set_printer_temperatures(bed, tool, chamber, printer_id, tool_index)

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 off. Required: printer_id.

unarchive_print_job(jobs)

Restore an archived print job. Required: jobs.

unassign_filament(source, filament_id, location_id)

Remove a filament spool from its printer assignment. Required: filament_id.

update_file(name, item_id, analysis, printers, printer_groups, printer_models, remove_thumbnail)

Update file metadata such as name and GCODE analysis. Required: item_id.

update_queue_comment(comment, item_id)

Edit an approval comment you authored. Required: item_id, comment.

update_queue_item(note, time, amount, paused, printed, deadline, infinite, priority, for_groups, for_models, persistent, for_printers, queue_item_id, material_usage, max_concurrent_printers)

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

Last successful function declaration observed on 2026-08-13. Source: https://simplyprint.io/api/mcp. We list what the server declared; we do not call any of these functions.

Endpoint status observed on 2026-08-13. Source: https://simplyprint.io/api/mcp.

Signals

These are separate measurements of different things. They are deliberately not combined into one score, because a popularity number that mixes website traffic with saves and stars cannot be checked or acted on.

Where to get it

• Repository — https://github.com/simplyprint/simplyprint-claude-plugin
• Website — https://simplyprint.io
• Remote endpoint (streamable-http) — https://simplyprint.io/api/mcp