SimplyPrint: 3D Print Farm Management

list_print_jobs

Read-onlyIdempotent

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

Input Schema

TableJSON Schema

Name	Required	Description
`page`	Yes	Page number (1-based)
`limit`	No	Cap on results per page (1-100). Alias for page_size.
`search`	No	Filename / UID / custom-field substring search
`compact`	No	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`	No	Sort by this field. Default: started date desc (newest first).
`sort_id`	No
`sources`	No
`end_date`	No	Latest start (ISO-8601)
`sort_dir`	No	Sort direction; default desc.
`spool_id`	No	Only jobs that used this filament spool
`user_ids`	No	Only jobs started by these users (requires VIEW_ALL_PRINT_HISTORY)
`page_size`	Yes	Items per page (1-100)
`queue_job`	No
`start_date`	No	Earliest start (ISO-8601)
`printer_ids`	No	Only jobs from these printer ids
`machine_types`	No
`printer_types`	No
`printer_groups`	No	Only jobs from printers in these groups
`archived_status`	No	null (default): hide archived; archived: only archived; both: include archived
`accepted_statuses`	No	Filter by job status. Multiple values OR-matched.

Schema Changelog

Changes observed during successful MCP inspections.

Changed2 schema fields changedAug 19, 2026

addedInput schema / properties / machine_types

Added value: +{
+  "items": {
+    "maxLength": 32,
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / sources

Added value: +{
+  "items": {
+    "enum": [
+      "0",
+      "1",
+      "2"
+    ],
+    "type": "integer"
+  },
+  "type": "array"
+}

Changed1 schema field changedJun 23, 2026
- addedInput schema / properties / queue_job
```
Added value: +{
+  "minimum": 1,
+  "type": "integer"
+}
```

Changed17 schema fields changedApr 25, 2026

addedInput schema / properties / accepted_statuses / description

Added value: +"Filter by job status. Multiple values OR-matched."

addedInput schema / properties / archived_status / description

Added value: +"null (default): hide archived; archived: only archived; both: include archived"

addedInput schema / properties / compact

Added value: +{
+  "default": true,
+  "description": "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.",
+  "type": "boolean"
+}

addedInput schema / properties / end_date / description
```
Added value: +"Latest start (ISO-8601)"
```

addedInput schema / properties / limit

Added value: +{
+  "description": "Cap on results per page (1-100). Alias for page_size.",
+  "type": "integer"
+}

addedInput schema / properties / page / description
```
Added value: +"Page number (1-based)"
```
addedInput schema / properties / page_size / description
```
Added value: +"Items per page (1-100)"
```
addedInput schema / properties / printer_groups / description
```
Added value: +"Only jobs from printers in these groups"
```
addedInput schema / properties / printer_ids / description
```
Added value: +"Only jobs from these printer ids"
```

addedInput schema / properties / search / description

Added value: +"Filename / UID / custom-field substring search"

removedInput schema / properties / search / maxLength
```
Removed value: -100
```

addedInput schema / properties / sort_by

Added value: +{
+  "description": "Sort by this field. Default: started date desc (newest first).",
+  "enum": [
+    "filename",
+    "dates",
+    "status",
+    "cost"
+  ],
+  "type": "string"
+}

addedInput schema / properties / sort_dir / description
```
Added value: +"Sort direction; default desc."
```

addedInput schema / properties / spool_id / description

Added value: +"Only jobs that used this filament spool"

removedInput schema / properties / spool_id / minimum
```
Removed value: -1
```
addedInput schema / properties / start_date / description
```
Added value: +"Earliest start (ISO-8601)"
```

addedInput schema / properties / user_ids / description

Added value: +"Only jobs started by these users (requires VIEW_ALL_PRINT_HISTORY)"

First observedApr 23, 2026

TDQS

A3.8/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The description adds behavioral detail beyond the read-only/idempotent annotations by mentioning compact mode default and which fields are omitted. This is useful extra transparency, though it does not cover all response behaviors.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is concise at two sentences, front-loading the core action. It contains no filler and directly states the tool's primary function and a notable default behavior.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool's complexity (20 parameters), the description provides a high-level overview of capabilities (pagination, filters, sort) but does not enumerate filter types or return structure. The schema supplies details, so the description is minimally sufficient but could be more complete for a complex tool.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description does not reference any specific parameters. With 75% schema coverage, the baseline is not high, and the description fails to add meaning to the many parameters. It only generically mentions pagination, filters, and sort without elaborating on schema details.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool lists past print jobs, distinguishing it from singleton retrieval (get_print_job) and queue listing (list_queue). The verb 'list' and object 'print jobs' are specific.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines3/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description implies usage by stating the action, but it does not explicitly mention when to use this tool over alternatives or provide exclusion criteria. It lacks guidance on when not to use it, though the name and purpose are self-explanatory.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All SimplyPrint: 3D Print Farm Management tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

list_print_jobs

Input Schema

Schema Changelog

TDQS

Glama MCP Gateway

Resources