inspect_mesh_geometry

Inspect owned geometry without a mesh job or preview download; reuses saved results.

Scope: meshes:write. Catalogue annotation: Read. Additional ownership and role checks may apply.

REST: GET /v1/artifacts/{artifact_id}/mesh-profile.

Arguments

Field

Type / accepted values

Required

Default

Constraints / meaning

artifact_id

string (uuid)

Yes

Omitted

detail

"components" / "bounds"

No

"components"

Use bounds for unstructured setup dimensions; verified geometry-export bounds can be reused without reimporting CAD. Components requests assessed identities for structured selection. Bounds never establish mesh readiness.

input_unit

"auto" / "mm" / "cm" / "m" / "in" or null

No

null

Normally omitted or auto: retain declared/embedded units, otherwise infer from measured STL bounds and engineering context. Supply explicit units only when known.

engineering_context

string or null

No

null

maxLength: 1000; Supplied engineering context for automatic STL units, e.g. a full-size passenger car. Do not infer it from a filename.

expected_length_mm

number or null

No

null

maximum: 1000000000.0; exclusiveMinimum: 0; Known approximate longest physical dimension in millimetres; do not invent one.

Calling the tool

Use tools/call with this tool’s exact name and an arguments object matching the fields above. Get the complete live schema before supplying advanced controls:

{
  "name": "get_tool_schema",
  "arguments": {
    "name": "inspect_mesh_geometry",
    "include_definitions": false
  }
}

Result and continuation

Inspect isError and structuredContent. Keep returned job, operation and artifact IDs. A pending operation_id is followed with get_operation; a compute job is followed with get_job. A wait timeout does not cancel work. Follow returned polling intervals and retain the same idempotency key when reconciling the same submission.

See agent workflow, jobs and operations, uploads, results and error recovery for the applicable lifecycle. MCP annotations describe tool behaviour; they are not blanket permission to run paid work or change account state.