create_geometry

Build CAD (STL, and exact STEP where supported) for a cooling or flow design from a template or design document.

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

REST: POST /v1/geometries.

Arguments

Field

Type / accepted values

Required

Default

Constraints / meaning

project_id

string (uuid) or null

No

null

workflow_name

string or null

No

null

minLength: 1; maxLength: 200

design_brief_artifact_id

string (uuid) or null

No

null

Immutable owned design brief used to derive this candidate; retained in job lineage

template_id

string or null

No

null

minLength: 1; maxLength: 120; Registered template; mutually exclusive with document

document

map of JsonValue or null

No

null

Use the live schema and the applicable workflow guide for semantics.

parameters

map of JsonValue

No

Omitted

outputs

array of "step" / "stl" / "design"

No

Omitted

minItems: 1; maxItems: 3

method

"exact" / "auto"

No

"exact"

Exact STEP by default. For purpose=meshing, auto permits checked faceted STEP for implicit volumes; artifacts record the actual representation.

purpose

"export" / "meshing"

No

"export"

Meshing requires explicit volume output_names; heatmaps, boundary patches and display helpers are rejected by the geometry engine.

resolution

integer

No

64

minimum: 24; maximum: 160

deflection_mm

number

No

0.01

maximum: 1; exclusiveMinimum: 0

output_names

array of string or null

No

null

minItems: 1; maxItems: 128

named_stl

boolean

No

false

Also export each selected document body as a separate named STL, alongside the combined surface, for mesh wall patches.

bounds_m

array [array [number, number, number], array [number, number, number]] or null

No

null

minItems: 2; maxItems: 2

idempotency_key

string

Yes

Omitted

minLength: 1; maxLength: 128; pattern: "^[A-Za-z0-9_.:-]+$"; Use a fresh unique key for each newly requested job, even with identical inputs or a matching completed job. Reuse unchanged only for retries/resuming that same intended job. Never replace it to retry an uncertain submission.

notify_url

string or null

No

null

maxLength: 2048; Optional public HTTPS URL that receives a signed notification when the job finishes, so you need not poll.

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": "create_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.