reconstruct_cad

Create a durable parametric reconstruction of an owned STEP or 3MF artifact, measured against the uploaded geometry.

Scope: geometry:write. Catalogue annotation: Writes / prepares / submits work. Additional ownership and role checks may apply.

REST: POST /v1/artifacts/{artifact_id}/cad-reconstruction.

Arguments

Field

Type / accepted values

Required

Default

Constraints / meaning

parameters

map of number or integer

No

Omitted

tolerance_mm

number

No

0.02

minimum: 0.001; maximum: 1

parent_reconstruction_id

string (uuid) or null

No

null

expected_parent_sha256

string or null

No

null

pattern: "^[a-f0-9]{64}$"

composition_mode

"hosted" / "native_features"

No

"hosted"

brief

string

No

""

maxLength: 10000

context_artifact_ids

array of string (uuid)

No

Omitted

maxItems: 8; Owned project design-source artifacts containing supplier/manufacturing text, heat maps or reference images. Raw CAD is not sent to the hosted model.

artifact_id

string (uuid)

Yes

Omitted

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": "reconstruct_cad",
    "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.