io.simplyprint/simplyprint

Est-ce que io.simplyprint/simplyprint est sûr ?

Au dernier audit MCP Hub, le serveur MCP « io.simplyprint/simplyprint » est classé « Non encore testé ». Référencé dans l'annuaire. Seul le pentest comportemental fait foi, et il n'a pas encore été exécuté sur ce serveur. Le verdict est réévalué en continu ; consultez la fiche pour l'état à jour.

Méthode : MCP Hub analyse la description de chaque outil (couche 1) et, pour le verdict fort, exécute le serveur dans une micro-VM isolée avec leurres et réseau bloqué (couche 2). On publie des noms et des compteurs, jamais le contenu brut renvoyé par un outil.

Les 93 outils

• add_queue_comment≈ 131 tokens

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

  Paramètres, retour & exemple (4)

  Paramètres

  • type · string · optionnel
  • comment · string · optionnel
  • file_id · string · optionnel
  • item_id · integer · optionnel

  Exemple d'appel

  {"name": "add_queue_comment", "arguments": {"type": "texte", "comment": "texte", "file_id": "texte", "item_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• add_to_queue≈ 920 tokens

  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 and a tags object for material colour, nozzle, build plate, or custom tags (for example tags={"material":[{"color":"Red","hex":"#FF0000","nozzle":0,"ext":0}]}).

  Paramètres, retour & exemple (10)

  Paramètres

  • tags · object · optionnel
    Tag-assignment object. Use material for colour, for example {"material":[{"color":"Red","hex":"#FF0000","nozzle":0,"ext":0}]}; use custom or tag_ids for custom tag IDs, nozzleData for nozzle positions, bedType for the build plate, and detach_tag_ids to remove custom tags.
  • group · integer · optionnel
    Queue group id to add the item to. Use list_queue_groups to discover available groups.
  • amount · integer · optionnel
    Number of copies to queue. Default 1.
  • fileId · string · optionnel
    Hex bucket hash returned by the files.simplyprint.io Upload endpoint. Use this when the file was uploaded via the API (recommended for integrations).
  • position · string · optionnel
    Where to insert: "top", "bottom", or a 1-based numeric position.
  • filesystem · string · optionnel
    UserFile.uid of an existing library file (use list_files to discover). Either numeric id or UID string is accepted.
  • for_groups · string · optionnel
  • for_models · string · optionnel
  • for_printers · string · optionnel
  • custom_fields · array · optionnel
    PRINT_QUEUE custom fields for the new queue item. Each entry: {customFieldId: string uuid, value: one-of {string, number, boolean, date, options[]}}.

  Exemple d'appel

  {"name": "add_to_queue", "arguments": {"tags": {}, "group": 1, "amount": 1, "fileId": "texte", "position": "texte", "filesystem": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• adjust_filament_weight≈ 244 tokens

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

  Paramètres, retour & exemple (10)

  Paramètres

  • log_print · boolean · optionnel
  • filament_id · integer · requis
    The filament ID
  • percent_left · number · optionnel
  • weighed_gross · number · optionnel
  • grams_remaining · number · optionnel
  • empty_spool_weight · integer · optionnel
  • log_print_filename · string · optionnel
  • log_print_printer_id · integer · optionnel
  • subtract_empty_spool · boolean · optionnel
  • save_empty_spool_weight · boolean · optionnel

  Exemple d'appel

  {"name": "adjust_filament_weight", "arguments": {"filament_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• approve_queue_item≈ 115 tokens

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

  Paramètres, retour & exemple (3)

  Paramètres

  • job · integer · optionnel
  • jobs · string · optionnel
  • comment · string · optionnel

  Exemple d'appel

  {"name": "approve_queue_item", "arguments": {"job": 1, "jobs": "texte", "comment": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• archive_print_job≈ 110 tokens

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

  Paramètres, retour & exemple (2)

  Paramètres

  • jobs · array · requis
  • reason · string · optionnel

  Exemple d'appel

  {"name": "archive_print_job", "arguments": {"jobs": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• assign_filament≈ 191 tokens

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

  Paramètres, retour & exemple (4)

  Paramètres

  • source · string · optionnel · changer | tag | filamentpage | viewspool | startprint | slicer | codescanner | slot_action
  • extruder · array · optionnel
  • printer_id · integer · requis
    The printer ID
  • filament_id · integer · requis
    The filament IDs (comma-separated for multiple)

  Exemple d'appel

  {"name": "assign_filament", "arguments": {"printer_id": 1, "filament_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• assign_maintenance_task≈ 119 tokens

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

  Paramètres, retour & exemple (3)

  Paramètres

  • notify · boolean · optionnel
  • task_id · integer · requis
  • user_id · integer · optionnel

  Exemple d'appel

  {"name": "assign_maintenance_task", "arguments": {"task_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• assign_tags≈ 597 tokens

  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 tool targets files only (type defaults to 3).

  Paramètres, retour & exemple (13)

  Paramètres

  • type · integer · requis · 3
  • custom · array · optionnel
    Custom tag ids to assign.
  • edited · string · optionnel · nozzle | material | custom | bedType
  • nozzle · number · optionnel
    Legacy single-nozzle size in millimetres.
  • tag_id · integer · optionnel
    Legacy alias for a single custom tag id.
  • bedType · object · optionnel
    Build-plate tag.
  • file_id · string · optionnel
    UserFile.uid of one file from list_files.
  • tag_ids · array · optionnel
    Alias for custom.
  • file_ids · array · optionnel
    UserFile.uid values when assigning the same tags to multiple files.
  • material · array · optionnel
    Material tags, one object per extruder. Set color and/or hex to tag a file by colour.
  • override · boolean · optionnel
  • nozzleData · array · optionnel
    Nozzle data, one object per nozzle.
  • detach_tag_ids · array · optionnel
    Custom tag ids to remove.

  Exemple d'appel

  {"name": "assign_tags", "arguments": {"type": 3}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• cancel_maintenance_job≈ 132 tokens

  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 recorded and schedule counters are not reset.

  Paramètres, retour & exemple (1)

  Paramètres

  • job_id · integer · requis

  Exemple d'appel

  {"name": "cancel_maintenance_job", "arguments": {"job_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• cancel_print≈ 304 tokens

  Cancel the current print on a printer

  Paramètres, retour & exemple (6)

  Paramètres

  • reason · integer · optionnel
    Cancel reason ID. May be required depending on organization settings.
  • comment · string · optionnel
    Optional comment explaining why the print was cancelled. May be required depending on organization settings.
  • printer_id · integer · requis
    The printer IDs (comma-separated for multiple)
  • custom_position · integer · optionnel
    Custom sort position when return_position is 'custom'.
  • return_position · string · optionnel · top | bottom | custom | original
    Position to insert queue item at when returning to queue (original, top, bottom or custom).
  • return_to_queue · boolean · optionnel
    Whether to return cancelled queued print to the queue. Uses organization default if not specified.

  Exemple d'appel

  {"name": "cancel_print", "arguments": {"printer_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• cancel_scheduled_print≈ 198 tokens

  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 already running; use cancel_print for that.

  Paramètres, retour & exemple (2)

  Paramètres

  • printer_id · integer · requis
    The printer IDs (comma-separated for multiple)
  • expected_job_uid · string · optionnel
    Job uid returned by list_scheduled_prints. The action is refused if that printer now holds a different pending print.

  Exemple d'appel

  {"name": "cancel_scheduled_print", "arguments": {"printer_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• complete_maintenance_job≈ 190 tokens

  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. Optionally pass completion_summary, and resolve_problem_ids to close the problems this job fixed.

  Paramètres, retour & exemple (4)

  Paramètres

  • job_id · integer · requis
  • completion_summary · string · optionnel
  • resolve_problem_ids · array · optionnel
  • skip_resolve_linked · boolean · optionnel

  Exemple d'appel

  {"name": "complete_maintenance_job", "arguments": {"job_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• complete_maintenance_task≈ 199 tokens

  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 the task is tied to a spare-part category you must pass selected_spare_part_id, or skip_spare_part true; completing it decrements that part's stock.

  Paramètres, retour & exemple (4)

  Paramètres

  • task_id · integer · requis
  • custom_fields · array · optionnel
  • skip_spare_part · boolean · optionnel
  • selected_spare_part_id · integer · optionnel

  Exemple d'appel

  {"name": "complete_maintenance_task", "arguments": {"task_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_folder≈ 148 tokens

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

  Paramètres, retour & exemple (5)

  Paramètres

  • org · boolean · optionnel
  • name · string · requis
  • item_id · integer · optionnel
  • org_perms · array · optionnel
  • parent_folder · integer · requis

  Exemple d'appel

  {"name": "create_folder", "arguments": {"name": "texte", "parent_folder": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• create_print_job≈ 892 tokens

  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 (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). Pass schedule_for to hold the print until a specific time instead ("print this tonight at 10pm", "start it tomorrow morning").

  Paramètres, retour & exemple (11)

  Paramètres

  • file_id · string · optionnel
    Hex bucket hash returned by the files.simplyprint.io Upload endpoint. Choose this when starting from a file uploaded via the API.
  • mms_map · string · optionnel
  • reprint · integer · optionnel
    Previous print_job id to reprint with the same file and settings.
  • filesystem · string · optionnel
    UserFile.uid of an existing library file. Choose this when starting from an already-imported file.
  • printer_id · string · requis
    Comma-separated printer id(s) to start the job on. Must be operational. When next_queue_item=true, each printer gets a different queue item (same item never duplicated within one call).
  • queue_file · integer · optionnel
    Existing print queue item id. Choose this to start the job from a queued item (most common flow).
  • schedule_for · string · optionnel
    Hold the print until this absolute instant instead of starting it now. ISO 8601 with an offset or Z, e.g. "2026-08-18T22:30:00Z". Must be at least 1 minute and at most 7 days ahead. Requires the Schedule Print feature (Pro and up) and the schedule_print permission. The printer is reserved as soon as the job is created and reports state print_pending until it starts. Print allowance is only reserved on plans that have quotas (Print Farm and up); Pro has none. Not valid with next_queue_item. Resolve relative times ("tonight", "in 3 hours") against the user's clock before calling - this field takes an absolute instant only.
  • custom_fields · array · optionnel
    PRINT_JOB custom fields shared across all started jobs. Each entry is an object with customFieldId (string uuid) and value (one-of string/number/boolean/date/options).
  • start_options · string · optionnel
  • next_queue_item · boolean · optionnel
    If true, auto-pick the next matching queue item for each printer in pid. Uses the same compatibility matcher as get_next_queue_items_for_printers. Mutually exclusive with file_id/filesystem/queue_file/reprint.
  • individual_custom_fields · array · optionnel
    Per-printer or per-queue-item PRINT_JOB custom fields. Each entry: {id: <string>, value: [customFieldSubmissions]}.

  Exemple d'appel

  {"name": "create_print_job", "arguments": {"printer_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_file≈ 76 tokens

  Delete one or more files.

  Paramètres, retour & exemple (1)

  Paramètres

  • file · string · requis

  Exemple d'appel

  {"name": "delete_file", "arguments": {"file": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_folder≈ 79 tokens

  Delete one or more folders.

  Paramètres, retour & exemple (1)

  Paramètres

  • folder · string · requis

  Exemple d'appel

  {"name": "delete_folder", "arguments": {"folder": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_queue_comment≈ 101 tokens

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

  Paramètres, retour & exemple (1)

  Paramètres

  • item_id · integer · requis

  Exemple d'appel

  {"name": "delete_queue_comment", "arguments": {"item_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• delete_queue_group≈ 110 tokens

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

  Paramètres, retour & exemple (2)

  Paramètres

  • item_id · integer · requis
  • move_to · integer · optionnel

  Exemple d'appel

  {"name": "delete_queue_group", "arguments": {"item_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• deny_queue_item≈ 130 tokens

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

  Paramètres, retour & exemple (4)

  Paramètres

  • job · integer · optionnel
  • jobs · string · optionnel
  • remove · boolean · optionnel
  • comment · string · optionnel

  Exemple d'appel

  {"name": "deny_queue_item", "arguments": {"job": 1, "jobs": "texte", "remove": true, "comment": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• empty_queue≈ 113 tokens

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

  Paramètres, retour & exemple (2)

  Paramètres

  • group · integer · optionnel
  • done_items · boolean · optionnel

  Exemple d'appel

  {"name": "empty_queue", "arguments": {"group": 1, "done_items": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• estimate_file_cost≈ 136 tokens

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

  Paramètres, retour & exemple (5)

  Paramètres

  • item_id · string · optionnel
  • mms_map · array · optionnel
  • newFile · boolean · optionnel
  • analysis · array · optionnel
  • printer_id · integer · optionnel

  Exemple d'appel

  {"name": "estimate_file_cost", "arguments": {"item_id": "texte", "mms_map": [], "newFile": true, "analysis": [], "printer_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_account_statistics≈ 194 tokens

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

  Paramètres, retour & exemple (7)

  Paramètres

  • users · array · optionnel
  • general · boolean · optionnel
  • end_date · string · optionnel
  • printers · array · optionnel
  • fake_data · boolean · optionnel
  • start_date · string · optionnel
  • printer_models · array · optionnel

  Exemple d'appel

  {"name": "get_account_statistics", "arguments": {"users": [], "general": true, "end_date": "texte", "printers": [], "fake_data": true, "start_date": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_farm_overview≈ 255 tokens

  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.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_farm_overview", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_filament≈ 181 tokens

  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").

  Paramètres, retour & exemple (5)

  Paramètres

  • public · boolean · optionnel
  • spool_id · integer · optionnel
  • company_id · integer · optionnel
  • locationscount · boolean · optionnel
  • spool_short_id · string · optionnel

  Exemple d'appel

  {"name": "get_filament", "arguments": {"public": true, "spool_id": 1, "company_id": 1, "locationscount": true, "spool_short_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_filament_history≈ 131 tokens

  Retrieve the usage history of a filament spool.

  Paramètres, retour & exemple (5)

  Paramètres

  • page · integer · optionnel
  • public · boolean · optionnel
  • item_id · integer · optionnel
  • perPage · integer · optionnel
  • user_id · string · optionnel

  Exemple d'appel

  {"name": "get_filament_history", "arguments": {"page": 1, "public": true, "item_id": 1, "perPage": 1, "user_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_folder≈ 86 tokens

  Get a folder's details including permissions.

  Paramètres, retour & exemple (1)

  Paramètres

  • item_id · integer · requis

  Exemple d'appel

  {"name": "get_folder", "arguments": {"item_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_maintenance_dashboard≈ 196 tokens

  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-printer status and the active maintenance plans. Good for "how is the farm doing"; use list_maintenance_jobs for anything that needs filtering, paging or more than the 10 most recent jobs. Note low_stock_parts is silently [] when the account lacks the Maintenance Inventory feature — list_spare_parts says so explicitly instead.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_maintenance_dashboard", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_maintenance_job≈ 199 tokens

  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 linked to the job, and other unresolved problems on the same printer. Task checklists and spare-part requirements are available nowhere else over MCP. Pass the job id as job_id (list_maintenance_jobs returns it as "id"); each task's id is what the task tools take as task_id.

  Paramètres, retour & exemple (1)

  Paramètres

  • job_id · integer · requis
    Maintenance job id.

  Exemple d'appel

  {"name": "get_maintenance_job", "arguments": {"job_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_maintenance_status_map≈ 187 tokens

  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_date. Only printers with a scheduled or in-progress job appear, so a printer that is absent has no maintenance outstanding and an empty object means nothing is scheduled anywhere. Follow up with get_printer_maintenance_profile for one printer, or list_maintenance_jobs for job-level detail.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_maintenance_status_map", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_next_queue_item≈ 321 tokens

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

  Paramètres, retour & exemple (12)

  Paramètres

  • compact · boolean · optionnel
    Keep at default true. Returns minimal data tuned for AI context. Only set to false if you specifically need fields the compact view drops, and then pair with limit to keep the response small.
  • filters · array · optionnel
  • sorting · array · optionnel
  • settings · array · optionnel
  • deselects · string · optionnel
  • normalOnly · boolean · optionnel
  • printer_id · integer · requis
    The printer IDs (comma-separated for multiple)
  • mustClearBed · boolean · optionnel
  • queueGroupsOrder · array · optionnel
  • skippedQueueItems · array · optionnel
  • includeTodoSummary · boolean · optionnel
  • specificQueueGroups · array · optionnel

  Exemple d'appel

  {"name": "get_next_queue_item", "arguments": {"printer_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_next_queue_items_for_printers≈ 284 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • compact · boolean · optionnel
    Keep at default true. Returns minimal data tuned for AI context. Only set to false if you specifically need fields the compact view drops, and then pair with limit to keep the response small.
  • printer_id · string · requis
    Comma-separated printer id(s). Does not need to be operational — offline printers return their would-be match too, so you can see what's waiting for them.

  Exemple d'appel

  {"name": "get_next_queue_items_for_printers", "arguments": {"printer_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_partner_maintenance_overview≈ 224 tokens

  For a partner, reseller, OEM or Enterprise group account: maintenance across every account it services. Returns counters (in maintenance, scheduled, overdue, open problems, open alerts, out of order, accounts needing a visit), one row per serviced account (printers, open problems, overdue jobs, next scheduled job, next visit, agreement), the most recent open problems, and the accounts due a visit. Fails on an account that is not a partner with the maintenance module.

  Paramètres, retour & exemple (2)

  Paramètres

  • problems · string · optionnel · all | sent_to_partner
  • problem_limit · integer · optionnel

  Exemple d'appel

  {"name": "get_partner_maintenance_overview", "arguments": {"problems": "all", "problem_limit": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_print_job≈ 104 tokens

  Get detailed info for a specific print job.

  Paramètres, retour & exemple (3)

  Paramètres

  • extra · string · optionnel
  • item_id · string · requis
  • getcustomfields · string · optionnel

  Exemple d'appel

  {"name": "get_print_job", "arguments": {"item_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_printer≈ 222 tokens

  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.

  Paramètres, retour & exemple (2)

  Paramètres

  • compact · boolean · optionnel
    Keep at default true. Returns minimal data tuned for AI context. Only set to false if you specifically need fields the compact view drops, and then pair with limit to keep the response small.
  • printer_id · string · requis

  Exemple d'appel

  {"name": "get_printer", "arguments": {"printer_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_printer_maintenance_profile≈ 287 tokens

  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 last 50 jobs, per-task completion history and spare parts consumed. The only source of a PREDICTED next-due date — when nothing is scheduled yet, health.next_scheduled_job is filled from the matching maintenance plan and carries is_predicted=true with a null id. Large response: ask for one printer at a time, and use get_maintenance_status_map for fleet-wide questions.

  Paramètres, retour & exemple (2)

  Paramètres

  • printer_id · integer · requis
    The printer to profile. Required.
  • include_active_job_detail · boolean · optionnel
    Also return the full task checklist of the active (or next scheduled) job. Off by default; get_maintenance_job gives the same detail for any job.

  Exemple d'appel

  {"name": "get_printer_maintenance_profile", "arguments": {"printer_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_queue_item≈ 82 tokens

  Get details of a specific queue item

  Paramètres, retour & exemple (1)

  Paramètres

  • item_id · integer · requis

  Exemple d'appel

  {"name": "get_queue_item", "arguments": {"item_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_queue_item_cost≈ 130 tokens

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

  Paramètres, retour & exemple (4)

  Paramètres

  • item_id · integer · optionnel
  • mms_map · array · optionnel
  • printer_id · integer · optionnel
  • queue_item_id · integer · requis

  Exemple d'appel

  {"name": "get_queue_item_cost", "arguments": {"queue_item_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_referral_stats≈ 82 tokens

  Referral program statistics: conversions, earnings, pending payout.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "get_referral_stats", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_slicer_settings_for_file≈ 89 tokens

  Retrieve slicer settings stored for a file.

  Paramètres, retour & exemple (1)

  Paramètres

  • file · string · requis

  Exemple d'appel

  {"name": "get_slicer_settings_for_file", "arguments": {"file": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• get_webhook_sample≈ 614 tokens

  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.

  Paramètres, retour & exemple (3)

  Paramètres

  • event · string · requis · test | job.started | job.paused | job.resumed | job.cancelled | job.done | job.failed | job.bed_cleared
  • limit · integer · optionnel
  • version · integer · optionnel

  Exemple d'appel

  {"name": "get_webhook_sample", "arguments": {"event": "test"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• home_printer≈ 178 tokens

  Home the printer axes (move to origin position)

  Paramètres, retour & exemple (3)

  Paramètres

  • axes · string · optionnel
    Axes to home, space-separated. Examples: "X Y Z" (all), "X Y" (XY only), "Z" (Z only)
  • printer_id · integer · requis
    The printer IDs (comma-separated for multiple)
  • snippet_id · integer · optionnel
    ID of a gcode snippet to send. Either gcode, macro, or snippet_id is required.

  Exemple d'appel

  {"name": "home_printer", "arguments": {"printer_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• inspect_printer_queue≈ 135 tokens

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

  Paramètres, retour & exemple (3)

  Paramètres

  • mode · string · optionnel · autoprint
  • criteria · array · optionnel
  • printer_id · string · requis

  Exemple d'appel

  {"name": "inspect_printer_queue", "arguments": {"printer_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_accounts_due_maintenance_visit≈ 132 tokens

  For a partner account: serviced accounts due a maintenance visit under their agreed visits per year, soonest first, with visits used this year, the next booked visit, and whether it is overdue. Suggestions only; nothing is booked.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_accounts_due_maintenance_visit", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_brand_filaments≈ 88 tokens

  List filament products from a specific brand.

  Paramètres, retour & exemple (1)

  Paramètres

  • item_id · integer · requis

  Exemple d'appel

  {"name": "list_brand_filaments", "arguments": {"item_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_custom_fields≈ 150 tokens

  List custom field definitions with pagination and search.

  Paramètres, retour & exemple (7)

  Paramètres

  • page · integer · requis
  • search · string · optionnel
  • sort_id · string · optionnel
  • end_date · number · optionnel
  • sort_dir · string · optionnel · asc | desc
  • page_size · integer · requis
  • start_date · number · optionnel

  Exemple d'appel

  {"name": "list_custom_fields", "arguments": {"page": 1, "page_size": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_custom_fields_for≈ 236 tokens

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

  Paramètres, retour & exemple (3)

  Paramètres

  • category · string · requis · project | project_item | project_variant | print | user | printer | filament | maintenance_job
  • subCategory · string · optionnel · project_edit | project_slice | project_release | manufacturing_input | print_queue | print_job | user_file | user_file_printable
  • includeDisabled · string · optionnel · true | false | 1 | 0

  Exemple d'appel

  {"name": "list_custom_fields_for", "arguments": {"category": "project"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_filament_colors≈ 85 tokens

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

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "list_filament_colors", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_filaments≈ 597 tokens

  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.

  Paramètres, retour & exemple (10)

  Paramètres

  • brand · string · optionnel
    Brand name substring
  • color · string · optionnel
    Color substring — matches hex, name, or color group
  • empty · boolean · optionnel
    true = only empty spools; false = only non-empty spools
  • limit · integer · optionnel
    Cap on number of spools returned after sorting/filtering. Use this with sort_by to grab e.g. the 3 newest.
  • compact · boolean · optionnel
    Keep at default true. Returns minimal data tuned for AI context. Only set to false if you specifically need fields the compact view drops, and then pair with limit to keep the response small.
  • sort_by · string · optionnel · created | last_used | left | brand | color
    Field to sort by. Defaults to created (newest first).
  • assigned · boolean · optionnel
    true = only spools assigned to a printer; false = only unassigned spools
  • sort_dir · string · optionnel · asc | desc
    Sort direction. Defaults to desc.
  • printer_id · integer · optionnel
    Only spools assigned to this printer id
  • material_type · string · optionnel
    Material type substring (e.g. "PLA", "PETG")

  Exemple d'appel

  {"name": "list_filaments", "arguments": {"brand": "texte", "color": "texte", "empty": true, "limit": 1, "compact": true, "sort_by": "created"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_files≈ 559 tokens

  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.

  Paramètres, retour & exemple (12)

  Paramètres

  • f · integer · optionnel
    Folder id to list (0 or omitted = root)
  • limit · integer · optionnel
    Cap on returned files (1-500). Useful with sort_by for "5 largest files" or "10 most recent". Projects come at most 100 per page.
  • start · boolean · optionnel
  • cursor · string · optionnel
    The next page of projects: pass projects_page.next_cursor from the previous answer, with the same folder, search and sort.
  • search · string · optionnel
    Filename substring search. Matches with or without extension — "Schleife oben 1_PLA_1h4m" and "Schleife oben 1_PLA_1h4m.3mf" both find the same file.
  • compact · boolean · optionnel
    Keep at default true. Returns minimal data tuned for AI context. Only set to false if you specifically need fields the compact view drops, and then pair with limit to keep the response small.
  • sort_by · string · optionnel · name | size | created
    Sort files by this field (folders are not affected). Default: repository order (user's saved files-page sort). Projects follow it by name or age.
  • sort_dir · string · optionnel · asc | desc
    Sort direction; default desc (newest/largest first).
  • has_gcode · boolean · optionnel
    true = only files with a parsed G-code analysis (printable); false = only non-printable files (models, etc.)
  • nest_into · string · optionnel
  • printer_id · integer · optionnel
    Only return files compatible with this printer (full compatibility check, not just model)
  • global_search · boolean · optionnel
    If true (default), search recursively across all folders instead of only the current one

  Exemple d'appel

  {"name": "list_files", "arguments": {"f": 1, "limit": 1, "start": true, "cursor": "texte", "search": "texte", "compact": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_maintenance_jobs≈ 502 tokens

  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, priority, scheduled date, task progress, assignees and linked problems. Returns 10 per page by default; raise page_size (max 100) or advance page. IMPORTANT: a returned job status may read "overdue", but that value is DERIVED (a scheduled job whose scheduled_date has passed) and is NOT accepted by the status filter — ask for status "scheduled" and read each job's returned status, or use the dashboard's overdue count.

  Paramètres, retour & exemple (8)

  Paramètres

  • page · integer · optionnel
    Page number (1-based).
  • search · string · optionnel
    Substring match over job title, description and printer name.
  • status · string · optionnel · scheduled | in_progress | completed | cancelled
    Filter by stored job status. "overdue" is not a stored status and is rejected here — it is derived from scheduled_date at read time.
  • sort_id · string · optionnel · created_at | scheduled_date | status | priority | printer | title
    Sort field; default created_at.
  • sort_dir · string · optionnel · asc | desc
    Sort direction; default desc.
  • page_size · integer · optionnel
    Jobs per page, 1-100. Defaults to 10 over MCP; job records are large.
  • printer_id · integer · optionnel
    Only jobs for this printer. Takes precedence over printer_ids.
  • printer_ids · string · optionnel
    Only jobs for these printers, as a comma-separated list of ids ("4,9,12"). Ignored when printer_id is set.

  Exemple d'appel

  {"name": "list_maintenance_jobs", "arguments": {"page": 1, "search": "texte", "status": "scheduled", "sort_id": "created_at", "sort_dir": "asc", "page_size": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_maintenance_problems≈ 374 tokens

  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 10 per page by default; raise page_size (max 100) or advance page.

  Paramètres, retour & exemple (8)

  Paramètres

  • page · integer · optionnel
    Page number (1-based).
  • search · string · optionnel
    Substring match over problem description, printer name, problem type name and reporter name.
  • status · string · optionnel · open | acknowledged | resolved
    Filter by problem status. Use "open" for what still needs attention.
  • sort_id · string · optionnel · created_at | status | printer | problem_type
    Sort field; default created_at.
  • sort_dir · string · optionnel · asc | desc
    Sort direction; default desc (newest first).
  • page_size · integer · optionnel
    Problems per page, 1-100. Defaults to 10 over MCP.
  • printer_id · integer · optionnel
    Only problems reported against this printer.
  • problem_type_id · integer · optionnel
    Only problems of this problem type.

  Exemple d'appel

  {"name": "list_maintenance_problems", "arguments": {"page": 1, "search": "texte", "status": "open", "sort_id": "created_at", "sort_dir": "asc", "page_size": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_partner_maintenance_alerts≈ 201 tokens

  For a partner account: its maintenance "needs attention" inbox - alerts its escalation rules opened for serviced accounts (problem thresholds, printers out of order too long, overdue jobs, visits due). Open alerts by default; status can be acknowledged, resolved, unresolved or all. Each alert has a human-readable message.

  Paramètres, retour & exemple (3)

  Paramètres

  • limit · integer · optionnel
  • status · string · optionnel · open | acknowledged | resolved | unresolved | all
  • company_id · integer · optionnel

  Exemple d'appel

  {"name": "list_partner_maintenance_alerts", "arguments": {"limit": 1, "status": "open", "company_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_partner_maintenance_visits≈ 196 tokens

  For a partner account: its maintenance visits to serviced accounts. Open visits (proposed, confirmed, in progress) by default, soonest first; filter by status, company_id or a from/to date range.

  Paramètres, retour & exemple (5)

  Paramètres

  • to · string · optionnel
  • from · string · optionnel
  • limit · integer · optionnel
  • status · string · optionnel · open | proposed | confirmed | in_progress | completed | cancelled | all
  • company_id · integer · optionnel

  Exemple d'appel

  {"name": "list_partner_maintenance_visits", "arguments": {"to": "texte", "from": "texte", "limit": 1, "status": "open", "company_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_pending_queue_items≈ 120 tokens

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

  Paramètres, retour & exemple (3)

  Paramètres

  • page · integer · optionnel
  • status · string · optionnel
  • per_page · integer · optionnel

  Exemple d'appel

  {"name": "list_pending_queue_items", "arguments": {"page": 1, "status": "texte", "per_page": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_print_jobs≈ 648 tokens

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

  Paramètres, retour & exemple (20)

  Paramètres

  • page · integer · requis
    Page number (1-based)
  • limit · integer · optionnel
    Cap on results per page (1-100). Alias for page_size.
  • search · string · optionnel
    Filename / UID / custom-field substring search
  • compact · boolean · optionnel
    Keep at default true. Returns minimal data tuned for AI context. Only set to false if you specifically need fields the compact view drops, and then pair with limit to keep the response small.
  • sort_by · string · optionnel · filename | dates | status | cost
    Sort by this field. Default: started date desc (newest first).
  • sort_id · string · optionnel
  • sources · array · optionnel
  • end_date · string · optionnel
    Latest start (ISO-8601)
  • sort_dir · string · optionnel · asc | desc
    Sort direction; default desc.
  • spool_id · integer · optionnel
    Only jobs that used this filament spool
  • user_ids · array · optionnel
    Only jobs started by these users (requires VIEW_ALL_PRINT_HISTORY)
  • page_size · integer · requis
    Items per page (1-100)
  • queue_job · integer · optionnel
  • start_date · string · optionnel
    Earliest start (ISO-8601)
  • printer_ids · array · optionnel
    Only jobs from these printer ids
  • machine_types · array · optionnel
  • printer_types · array · optionnel
  • printer_groups · array · optionnel
    Only jobs from printers in these groups
  • archived_status · string · optionnel · null | archived | both
    null (default): hide archived; archived: only archived; both: include archived
  • accepted_statuses · array · optionnel
    Filter by job status. Multiple values OR-matched.

  Exemple d'appel

  {"name": "list_print_jobs", "arguments": {"page": 1, "page_size": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_printers≈ 830 tokens

  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).

  Paramètres, retour & exemple (16)

  Paramètres

  • page · integer · optionnel
    Page number (1-based) when paginating beyond limit/page_size.
  • tags · array · optionnel
    Filter printers that have any of the given tag names
  • limit · integer · optionnel
    Cap on results (1-100). Alias for page_size. Use this with sort_by for "top N" queries.
  • search · string · optionnel
  • status · array · optionnel
    Filter by status. Multiple values are OR-matched. Macros (derived): online, offline, idle, was_printing_when_offline, in_maintenance, print_pending, can_accept_commands, awaiting_bed_clear. Raw PrinterStatus: printing, operational, paused, pausing, resuming, cancelling, error, downloading, unknown. Note: awaiting_bed_clear means a print finished but the bed has not been cleared yet (online + operational + still has a job) — use this NOT print_pending (which means a queued/staggered start) when the user asks "which printers need to be cleared off?".
  • compact · boolean · optionnel
    Keep at default true. Returns minimal data tuned for AI context. Only set to false if you specifically need fields the compact view drops, and then pair with limit to keep the response small.
  • sort_by · string · optionnel · name | sku | mac | created | status | last_online
    Sort by this field. Default: stable (no sort).
  • sort_id · string · optionnel
  • group_id · integer · optionnel
    Only return printers in this printer group
  • order_by · string · optionnel · status | name | online | last_online | ui | created
  • sort_dir · string · optionnel · asc | desc
    Sort direction; default asc when sort_by is set.
  • page_size · integer · optionnel
  • job_columns · string · optionnel
  • out_of_order · boolean · optionnel
    If true, only out-of-order printers; if false, only in-order printers (enterprise feature)
  • printer_columns · string · optionnel
  • filament_columns · string · optionnel

  Exemple d'appel

  {"name": "list_printers", "arguments": {"page": 1, "tags": [], "limit": 1, "search": "texte", "status": [], "compact": true}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_queue≈ 735 tokens

  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.

  Paramètres, retour & exemple (15)

  Paramètres

  • page · integer · optionnel
  • tags · array · optionnel
    Match items that have any of the given tag names
  • group · integer · optionnel
    Only return items in this queue group (0 = the ungrouped bucket)
  • search · string · optionnel
    Filename substring search
  • compact · boolean · optionnel
    Keep at default true. Returns minimal data tuned for AI context. Only set to false if you specifically need fields the compact view drops, and then pair with limit to keep the response small.
  • sort_by · string · optionnel · sort_position | created | name | approval_status
    Sort by this field. Default: sort_position (ascending — matches the queue's display order).
  • sort_dir · string · optionnel · asc | desc
    Sort direction; default asc.
  • page_size · integer · optionnel
    Items per page (1-200). Use this as the result-size cap.
  • printer_id · array · optionnel
    Only return queue items assigned to (via for_printers) any of these printer ids
  • added_after · string · optionnel
    Items created strictly after this ISO-8601 date
  • added_before · string · optionnel
    Items created strictly before this ISO-8601 date
  • custom_fields · array · optionnel
    Filter by custom field values. Each entry must specify the field id (uuid) and either value (exact match against string/number/boolean/date/options) or contains (case-insensitive substring on text fields). Multiple entries are AND-joined.
  • approval_status · string · optionnel · not_required | pending | approved | denied | revision
    Filter by approval status. Default excludes denied.
  • newer_than_days · integer · optionnel
    Items created within the last this many days
  • older_than_days · integer · optionnel
    Items created more than this many days ago

  Exemple d'appel

  {"name": "list_queue", "arguments": {"page": 1, "tags": [], "group": 1, "search": "texte", "compact": true, "sort_by": "sort_position"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_queue_comments≈ 100 tokens

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

  Paramètres, retour & exemple (2)

  Paramètres

  • file_id · string · optionnel
  • item_id · integer · optionnel

  Exemple d'appel

  {"name": "list_queue_comments", "arguments": {"file_id": "texte", "item_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_queue_groups≈ 87 tokens

  List all queue groups in the user's account.

  Paramètres, retour & exemple (1)

  Paramètres

  • item_id · integer · optionnel

  Exemple d'appel

  {"name": "list_queue_groups", "arguments": {"item_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_scheduled_prints≈ 212 tokens

  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", or before rescheduling/cancelling so you can name the right printer. Returns printer, filename, scheduled_for and who scheduled it. Prints already released and starting are NOT listed here - use get_farm_overview for those.

  Paramètres, retour & exemple (3)

  Paramètres

  • page · integer · requis
  • page_size · integer · requis
  • printer_ids · array · optionnel

  Exemple d'appel

  {"name": "list_scheduled_prints", "arguments": {"page": 1, "page_size": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• list_spare_parts≈ 460 tokens

  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: without it this tool fails with an explicit "your account doesn't have access to this feature" error, so an empty list here always means the account genuinely has no matching parts. (get_maintenance_dashboard cannot tell you that — its low_stock_parts is silently [] both when the feature is missing and when stock is healthy.)

  Paramètres, retour & exemple (9)

  Paramètres

  • page · integer · optionnel
    Page number (1-based).
  • search · string · optionnel
    Substring match over part name, SKU, description and category.
  • sort_id · string · optionnel · name | quantity | category | sku | cost_per_unit | status
    Sort field; default name.
  • category · string · optionnel
    Exact spare-part category match.
  • sort_dir · string · optionnel · asc | desc
    Sort direction; default asc.
  • page_size · integer · optionnel
    Parts per page, 1-100; default 25.
  • stock_status · string · optionnel · in_stock | low_stock | out_of_stock
    Filter by derived stock state. low_stock means at or below the part's threshold but not yet zero.
  • printer_brand · string · optionnel
    Only parts that fit this printer brand.
  • printer_model_ids · array · optionnel
    Only parts that fit these printer models.

  Exemple d'appel

  {"name": "list_spare_parts", "arguments": {"page": 1, "search": "texte", "sort_id": "name", "category": "texte", "sort_dir": "asc", "page_size": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• mark_filament_dried≈ 123 tokens

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

  Paramètres, retour & exemple (2)

  Paramètres

  • dried_at · string · optionnel
  • filament_id · integer · requis
    The filament IDs (comma-separated for multiple)

  Exemple d'appel

  {"name": "mark_filament_dried", "arguments": {"filament_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• match_file_to_printers≈ 119 tokens

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

  Paramètres, retour & exemple (2)

  Paramètres

  • model · string · requis
  • gcodeAnalysis · array · optionnel

  Exemple d'appel

  {"name": "match_file_to_printers", "arguments": {"model": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• move_file≈ 99 tokens

  Move one or more files to a folder.

  Paramètres, retour & exemple (3)

  Paramètres

  • files · string · requis
  • folder · integer · requis
  • all_or_nothing · boolean · optionnel

  Exemple d'appel

  {"name": "move_file", "arguments": {"files": "texte", "folder": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• move_folder≈ 90 tokens

  Move a folder to another location.

  Paramètres, retour & exemple (2)

  Paramètres

  • folder · integer · requis
  • target · integer · requis

  Exemple d'appel

  {"name": "move_folder", "arguments": {"folder": 1, "target": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• move_printer_axis≈ 255 tokens

  Move a printer axis to a relative position

  Paramètres, retour & exemple (5)

  Paramètres

  • speed · number · optionnel
    Movement speed in mm/min. If not specified, uses printer default.
  • distance · number · requis
    Distance to move in millimeters
  • direction · string · requis · X | X- | Y | Y- | Z | Z-
    Axis and direction to move. Use axis letter, optionally with minus for negative. Examples: "X" (+X), "X-" (-X), "Y", "Y-", "Z", "Z-"
  • printer_id · integer · requis
    The printer IDs (comma-separated for multiple)
  • snippet_id · integer · optionnel
    ID of a gcode snippet to send. Either gcode, macro, or snippet_id is required.

  Exemple d'appel

  {"name": "move_printer_axis", "arguments": {"distance": 1, "direction": "X", "printer_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• move_queue_item≈ 101 tokens

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

  Paramètres, retour & exemple (2)

  Paramètres

  • jobs · string · requis
  • target_group_id · integer · requis

  Exemple d'appel

  {"name": "move_queue_item", "arguments": {"jobs": "texte", "target_group_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• pause_print≈ 102 tokens

  Pause the current print on a printer

  Paramètres, retour & exemple (1)

  Paramètres

  • printer_id · integer · requis
    The printer IDs (comma-separated for multiple)

  Exemple d'appel

  {"name": "pause_print", "arguments": {"printer_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• remove_from_queue≈ 91 tokens

  Remove an item from the print queue

  Paramètres, retour & exemple (2)

  Paramètres

  • job · integer · optionnel
  • jobs · string · optionnel

  Exemple d'appel

  {"name": "remove_from_queue", "arguments": {"job": 1, "jobs": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• reorder_queue_group≈ 101 tokens

  Move a queue group to a new position.

  Paramètres, retour & exemple (2)

  Paramètres

  • to · integer · requis
  • group_id · integer · requis

  Exemple d'appel

  {"name": "reorder_queue_group", "arguments": {"to": 1, "group_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• reorder_queue_item≈ 114 tokens

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

  Paramètres, retour & exemple (3)

  Paramètres

  • to · integer · requis
  • from · integer · optionnel
  • queue_item_id · integer · requis

  Exemple d'appel

  {"name": "reorder_queue_item", "arguments": {"to": 1, "queue_item_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• reschedule_print≈ 258 tokens

  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. Only affects prints still waiting on a scheduled time - a print already staggered or downloading cannot be pushed back.

  Paramètres, retour & exemple (3)

  Paramètres

  • printer_id · string · requis
    Comma-separated printer id(s) whose scheduled print should move.
  • schedule_for · string · optionnel
    New absolute instant (ISO 8601), at least 1 minute and at most 7 days ahead. Omit or null to start the print now.
  • expected_job_uid · string · optionnel
    Job uid returned by list_scheduled_prints. The action is refused if that printer now holds a different pending print.

  Exemple d'appel

  {"name": "reschedule_print", "arguments": {"printer_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• resubmit_queue_item≈ 125 tokens

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

  Paramètres, retour & exemple (2)

  Paramètres

  • comment · string · optionnel
  • queue_item_id · integer · requis

  Exemple d'appel

  {"name": "resubmit_queue_item", "arguments": {"queue_item_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• resume_print≈ 102 tokens

  Resume a paused print on a printer

  Paramètres, retour & exemple (1)

  Paramètres

  • printer_id · integer · requis
    The printer IDs (comma-separated for multiple)

  Exemple d'appel

  {"name": "resume_print", "arguments": {"printer_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• revive_queue_item≈ 155 tokens

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

  Paramètres, retour & exemple (6)

  Paramètres

  • group · integer · optionnel
  • amount · integer · optionnel
  • position · string · optionnel · top | bottom
  • priority · string · optionnel · normal | low
  • queue_item_id · integer · requis
  • position_index · integer · optionnel

  Exemple d'appel

  {"name": "revive_queue_item", "arguments": {"queue_item_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• save_queue_group≈ 78 tokens

  Create a new queue group or update an existing one.

  Paramètres, retour & exemple (0)

  Exemple d'appel

  {"name": "save_queue_group", "arguments": {}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• send_back_for_revision≈ 120 tokens

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

  Paramètres, retour & exemple (2)

  Paramètres

  • comment · string · optionnel
  • queue_item_id · integer · requis

  Exemple d'appel

  {"name": "send_back_for_revision", "arguments": {"queue_item_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• send_gcode≈ 341 tokens

  Send G-code commands to a printer

  Paramètres, retour & exemple (5)

  Paramètres

  • gcode · array · optionnel
    Array of G-code commands to send. Either gcode, macro, or snippet_id is required.
  • macro · string · optionnel · is_start | is_end | is_cancel | is_pause | is_resume | move_axis | change_print_speed | change_flow_rate
    Predefined macro name to execute. Either gcode, macro, or snippet_id is required.
  • printer_id · integer · requis
    The printer IDs (comma-separated for multiple)
  • snippet_id · integer · optionnel
    ID of a gcode snippet to send. Either gcode, macro, or snippet_id is required.
  • macro_context · array · optionnel
    Optional context data for macro execution.

  Exemple d'appel

  {"name": "send_gcode", "arguments": {"printer_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• set_custom_field_values≈ 259 tokens

  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.

  Paramètres, retour & exemple (4)

  Paramètres

  • values · array · requis
  • category · string · requis · project | project_item | project_variant | print | user | printer | filament | maintenance_job
  • entityIds · array · requis
  • subCategory · string · optionnel · project_edit | project_slice | project_release | manufacturing_input | print_queue | print_job | user_file | user_file_printable

  Exemple d'appel

  {"name": "set_custom_field_values", "arguments": {"values": [], "category": "project", "entityIds": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• set_file_printers≈ 153 tokens

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

  Paramètres, retour & exemple (4)

  Paramètres

  • items · array · requis
  • groups · array · optionnel
  • models · array · optionnel
  • printers · array · optionnel

  Exemple d'appel

  {"name": "set_file_printers", "arguments": {"items": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• set_printer_fans≈ 176 tokens

  Control the printer cooling fans

  Paramètres, retour & exemple (3)

  Paramètres

  • speed · integer · requis
    Fan speed from 0 (off) to 255 (full speed). Use 0 to turn fans off.
  • printer_id · integer · requis
    The printer IDs (comma-separated for multiple)
  • snippet_id · integer · optionnel
    ID of a gcode snippet to send. Either gcode, macro, or snippet_id is required.

  Exemple d'appel

  {"name": "set_printer_fans", "arguments": {"speed": 1, "printer_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• set_printer_motors≈ 185 tokens

  Enable or disable the printer stepper motors

  Paramètres, retour & exemple (3)

  Paramètres

  • enabled · string · requis · on | off
    Motor state: "on" to enable motors (lock axes), "off" to disable (allow manual movement)
  • printer_id · integer · requis
    The printer IDs (comma-separated for multiple)
  • snippet_id · integer · optionnel
    ID of a gcode snippet to send. Either gcode, macro, or snippet_id is required.

  Exemple d'appel

  {"name": "set_printer_motors", "arguments": {"enabled": "on", "printer_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• set_printer_temperatures≈ 381 tokens

  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.

  Paramètres, retour & exemple (5)

  Paramètres

  • bed · integer · optionnel
    Target heated bed temperature in degrees Celsius. 0 turns the bed heater off. Values above the printer model maximum are clamped. At least one of tool, bed or chamber is required.
  • tool · integer · optionnel
    Target nozzle temperature in degrees Celsius. 0 turns the hotend off. Values above the printer model maximum are clamped. At least one of tool, bed or chamber is required.
  • chamber · integer · optionnel
    Target chamber temperature in degrees Celsius. 0 turns the chamber heater off. Skipped for printers without an actively heated chamber. At least one of tool, bed or chamber is required.
  • printer_id · integer · requis
    The printer IDs (comma-separated for multiple)
  • tool_index · integer · optionnel
    Zero-based tool index for multi-tool printers. Requires tool to be set. Defaults to 0.

  Exemple d'appel

  {"name": "set_printer_temperatures", "arguments": {"printer_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• skip_maintenance_task≈ 105 tokens

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

  Paramètres, retour & exemple (1)

  Paramètres

  • task_id · integer · requis

  Exemple d'appel

  {"name": "skip_maintenance_task", "arguments": {"task_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• start_maintenance_job≈ 136 tokens

  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 the safe direction: it takes a printer OUT of rotation.

  Paramètres, retour & exemple (1)

  Paramètres

  • job_id · integer · requis

  Exemple d'appel

  {"name": "start_maintenance_job", "arguments": {"job_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• unarchive_print_job≈ 93 tokens

  Restore an archived print job.

  Paramètres, retour & exemple (1)

  Paramètres

  • jobs · array · requis

  Exemple d'appel

  {"name": "unarchive_print_job", "arguments": {"jobs": []}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• unassign_filament≈ 150 tokens

  Remove a filament spool from its printer assignment.

  Paramètres, retour & exemple (3)

  Paramètres

  • source · string · optionnel · changer | tag | filamentpage | viewspool | startprint | slicer | codescanner | slot_action
  • filament_id · integer · requis
    The filament ID
  • location_id · integer · optionnel

  Exemple d'appel

  {"name": "unassign_filament", "arguments": {"filament_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• uncomplete_maintenance_task≈ 102 tokens

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

  Paramètres, retour & exemple (1)

  Paramètres

  • task_id · integer · requis

  Exemple d'appel

  {"name": "uncomplete_maintenance_task", "arguments": {"task_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• unskip_maintenance_task≈ 94 tokens

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

  Paramètres, retour & exemple (1)

  Paramètres

  • task_id · integer · requis

  Exemple d'appel

  {"name": "unskip_maintenance_task", "arguments": {"task_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_file≈ 153 tokens

  Update file metadata such as name and GCODE analysis.

  Paramètres, retour & exemple (7)

  Paramètres

  • name · string · optionnel
  • item_id · string · requis
  • analysis · array · optionnel
  • printers · string · optionnel
  • printer_groups · string · optionnel
  • printer_models · string · optionnel
  • remove_thumbnail · boolean · optionnel

  Exemple d'appel

  {"name": "update_file", "arguments": {"item_id": "texte"}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_queue_comment≈ 109 tokens

  Edit an approval comment you authored.

  Paramètres, retour & exemple (2)

  Paramètres

  • comment · string · requis
  • item_id · integer · requis

  Exemple d'appel

  {"name": "update_queue_comment", "arguments": {"comment": "texte", "item_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

• update_queue_item≈ 272 tokens

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

  Paramètres, retour & exemple (16)

  Paramètres

  • note · string · optionnel
  • time · integer · optionnel
  • amount · integer · optionnel
  • paused · boolean · optionnel
  • printed · integer · optionnel
  • deadline · string · optionnel
  • infinite · boolean · optionnel
  • priority · string · optionnel · normal | low
  • log_print · boolean · optionnel
  • for_groups · string · optionnel
  • for_models · string · optionnel
  • persistent · boolean · optionnel
  • for_printers · string · optionnel
  • queue_item_id · integer · requis
  • material_usage · number · optionnel
  • max_concurrent_printers · integer · optionnel

  Exemple d'appel

  {"name": "update_queue_item", "arguments": {"queue_item_id": 1}}

  Exemple de retour

  {"content": [{"type": "text", "text": "…"}]}

C'est votre serveur ?

Revendiquez-le sur l'espace créateur (preuve GitHub, domaine ou npm) pour afficher le badge « propriétaire vérifié » et lancer un pentest comportemental à la demande afin d'obtenir le badge « Vérifié ».

Créer un compte / revendiquer →

Source

https://simplyprint.io/api/mcp