PrintPal

Start an AI 3D generation (uses credits)

generate_3d_model

DestructiveIdempotent

Step 2 of AI 3D generation. Starts the job priced by prepare_3d_generation on the user's connected PrintPal account and spends the quoted credits. Call only after the user has agreed to the cost shown by prepare_3d_generation, passing its quote_token and the approved credit amount. Pass a stable idempotency_key and reuse it when retrying after a timeout: a retry returns the original job and is never charged twice. A new generation needs a new quote. Returns a generation_uid; the model is not finished yet, so poll check_3d_generation.

Input Schema

Name	Required	Description
`format`	No	Optional; must match the quote.
`prompt`	No	Optional; must match the quote.
`quality`	No	Optional; must match the quote.
`quote_token`	Yes	quote_token from prepare_3d_generation.
`idempotency_key`	No	Unique id for this generation request, reused on retries. Defaults to one derived from the quote.
`approved_credits`	Yes	The credit cost the user approved.

Output Schema

Name	Required	Description	Default
`phase`	No
`prompt`	No
`status`	Yes
`credits`	No
`download`	No
`replayed`	No
`settings`	No
`next_step`	Yes
`created_at`	No
`completed_at`	No
`billing_policy`	No
`download_error`	No
`generation_uid`	No
`elapsed_seconds`	No
`poll_after_seconds`	No
`reference_image_url`	No
`estimated_time_seconds`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed11 schema fields changedNov 1, 2026

addedInput schema / properties / approved_credits

Added value: +{
+  "description": "The credit cost the user approved.",
+  "minimum": 1,
+  "type": "integer"
+}

removedInput schema / properties / format / default
```
Removed value: -"glb"
```
addedInput schema / properties / format / description
```
Added value: +"Optional; must match the quote."
```

addedInput schema / properties / idempotency_key

Added value: +{
+  "description": "Unique id for this generation request, reused on retries. Defaults to one derived from the quote.",
+  "maxLength": 160,
+  "minLength": 8,
+  "type": "string"
+}

removedInput schema / properties / image_url

Removed value: -{
-  "description": "Optional public PNG/JPEG/WebP URL for image-to-3D (API-key mode only).",
-  "type": "string"
-}

changedInput schema / properties / prompt / description

Previous value: -"What to generate, e.g. \"low-poly fox figurine, sitting\"."New value: +"Optional; must match the quote."

removedInput schema / properties / quality / default
```
Removed value: -"default"
```

changedInput schema / properties / quality / description

Previous value: -"default/high/ultra for text or image; super*/superplus* tiers are image-only high-res."New value: +"Optional; must match the quote."

addedInput schema / properties / quote_token

Added value: +{
+  "description": "quote_token from prepare_3d_generation.",
+  "type": "string"
+}

changedInput schema / required

Previous value: -[
-  "prompt"
-]New value: +[
+  "quote_token",
+  "approved_credits"
+]

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "properties": {
+    "billing_policy": {
+      "type": "string"
+    },
+    "completed_at": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "created_at": {
+      "type": "string"
+    },
+    "credits": {
+      "properties": {
+        "amount": {
+          "type": "integer"
+        },
+        "note": {
+          "type": "string"
+        },
+        "remaining": {
+          "type": "integer"
+        },
+        "state": {
+          "enum": [
+            "reserved",
+            "charged",
+            "restored",
+            "refunded",
+            "unknown"
+          ],
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "download": {
+      "properties": {
+        "expires_in_seconds": {
+          "type": "integer"
+        },
+        "file_name": {
+          "type": "string"
+        },
+        "format": {
+          "type": "string"
+        },
+        "note": {
+          "type": "string"
+        },
+        "url": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "download_error": {
+      "type": "string"
+    },
+    "elapsed_seconds": {
+      "type": "integer"
+    },
+    "estimated_time_seconds": {
+      "type": "integer"
+    },
+    "generation_uid": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "next_step": {
+      "type": "string"
+    },
+    "phase": {
+      "type": "string"
+    },
+    "poll_after_seconds": {
+      "type": "integer"
+    },
+    "prompt": {
+      "type": "string"
+    },
+    "reference_image_url": {
+      "type": "string"
+    },
+    "replayed": {
+      "type": "boolean"
+    },
+    "settings": {
+      "properties": {
+        "delivered_contents": {
+          "type": "string"
+        },
+        "delivered_format": {
+          "type": "string"
+        },
+        "format": {
+          "type": "string"
+        },
+        "input": {
+          "enum": [
+            "text",
+            "image"
+          ],
+          "type": "string"
+        },
+        "quality": {
+          "type": "string"
+        },
+        "resolution": {
+          "type": "string"
+        },
+        "texture": {
+          "type": "boolean"
+        }
+      },
+      "type": "object"
+    },
+    "status": {
+      "enum": [
+        "starting",
+        "processing",
+        "completed",
+        "failed",
+        "stalled"
+      ],
+      "type": "string"
+    }
+  },
+  "required": [
+    "status",
+    "next_step"
+  ],
+  "type": "object"
+}

First observedOct 16, 2026

TDQS

A4.9/5.0

Behavior5/5

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

Annotations already mark this as destructive, idempotent, and not read-only, but the description adds critical behavior: it spends quoted credits, retrying with the same idempotency_key returns the original job and never charges twice, and the job is asynchronous. These are meaningful disclosures beyond the annotations.

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 front-loaded with the step and action, then covers prerequisites, idempotent retry behavior, and the next polling step. Every sentence carries operational value with no wasted text.

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

Completeness5/5

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

For a credit-spending asynchronous mutation, the description covers the required quote/approval flow, safe retry behavior, and the follow-up polling tool. Since an output schema exists, return-value details need not be expanded further, and the critical call-preconditions are complete.

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

Parameters4/5

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

Schema coverage is 100%, so the baseline is 3. The description still adds useful semantics by tying quote_token and approved_credits to the prepare/approval flow and by explaining the retry meaning of idempotency_key; however, the format/prompt/quality quote-matching details are already present in the schema, so it does not fully exceed the schema.

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 names a specific action and resource: it starts an AI 3D generation job as step 2 and spends quoted credits. It clearly distinguishes prepare_3d_generation, check_3d_generation, and this tool, so an agent can identify the action without opening the schema.

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

Usage Guidelines5/5

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

It gives explicit prerequisites: call only after the user agrees to the cost from prepare_3d_generation, pass that quote_token and approved_credits, use a new quote for a new generation, and poll check_3d_generation afterward. Alternatives and conditions are named directly.

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

All PrintPal 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.

Resources

Need Help?