MCP_plan_mesh_StructuredOptions

Generated from the central API contract. Availability and permissions are checked by the connected service.

Field

Type / accepted values

Required

Default

Constraints / meaning

flow_region

MCP_plan_mesh_FlowRegion

Yes

Omitted

workflow

"external" / "internal" / "cht" / "solid" or null

No

null

input_unit

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

No

null

Derive from artifact metadata; required for uploads without declared units.

mesh_type

"stair_step" / "cut_cell"

No

"stair_step"

Ask about surface fidelity; stair_step is the disclosed default. Neither option extrudes prism layers.

preset

"local" / "custom"

No

"local"

Use local for approximate target-cell sizing or custom for explicit spacing. Legacy laptop presets are not supported by the geometry-independent mesher.

cell_count_tolerance

number

No

0.3

minimum: 0.01; maximum: 0.5; Fractional target cell-count tolerance: default 0.30 means ±30%. A 2-million-cell target allows 1.4–2.6 million, subject to quality and hard limits. Leave omitted unless the user requests a different tolerance; a target count alone does not imply ±5%.

max_target_iterations

integer

No

3

minimum: 1; maximum: 5

retry_policy

"review" / "automatic"

No

"review"

Review stops before another full target-count attempt; automatic allows the explicitly authorized bounded max_target_iterations budget, within the credential’s retry allowance.

retry_authorization_reason

string or null

No

null

minLength: 1; maxLength: 1000; Explicit user or authorized-agent delegation for bounded automatic mesh retries; required for retry_policy=automatic.

base_cell_mm

array [number, number, number] or null

No

null

minItems: 3; maxItems: 3

ambient_cell_mm

number or null

No

null

exclusiveMinimum: 0

ambient_pad_mm

number or null

No

null

minimum: 0

local_bulk_cell_mm

array [number, number, number] or null

No

null

minItems: 3; maxItems: 3

local_critical_cell_mm

array [number, number, number] or null

No

null

minItems: 3; maxItems: 3

local_critical_padding_mm

array [number, number, number] or null

No

null

minItems: 3; maxItems: 3

cad_surface_cell_mm

number or null

No

null

exclusiveMinimum: 0

cad_surface_tolerance_mm

number or null

No

null

exclusiveMinimum: 0; Sampled wall deviation tolerance for external cut-cell CAD; not a universal validity guarantee.

cad_surface_max_passes

integer

No

3

minimum: 1; maximum: 4

cad_cells_across_thickness

integer

No

2

minimum: 2; maximum: 12

cad_refinement_padding_cells

integer

No

2

minimum: 2; maximum: 6

cad_max_refinement_levels

integer

No

8

minimum: 1; maximum: 8

cut_cell_min_volume_fraction

number

No

0.01

minimum: 0; maximum: 0.25

fluid_refinement_windows

array of RefinementWindow

No

Omitted

maxItems: 64

balance_fluid_volume_ratio

number or null

No

null

exclusiveMinimum: 1

enforce_two_to_one

boolean

No

true

max_transition_angle_deg

number

No

60.0

maximum: 90; exclusiveMinimum: 0

max_transition_angle_face_fraction

number

No

0.015

minimum: 0; maximum: 1

max_neighbour_volume_ratio

number

No

20.0

exclusiveMinimum: 1

max_aspect_ratio

number

No

100.0

exclusiveMinimum: 1

max_balance_rounds

integer

No

32

minimum: 1; maximum: 4096

rans_quality_face_fraction

number

No

0.005

minimum: 0; maximum: 1

Omission and explicit null are different. Defaults shown are schema defaults; validators may resolve conditional defaults or reject incompatible combinations. See the workflow guide and validate the complete request before submission.