create_mesh

Mesh a design with GD Structured Meshing or GD Hex-core Meshing.

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

REST: POST /v1/meshes.

Arguments

Field

Type / accepted values

Required

Default

Constraints / meaning

project_id

string (uuid) or null

No

null

surface_artifact_id

string

Yes

Omitted

minLength: 1; maxLength: 128; pattern: "^[A-Za-z0-9_-]+$"

reviewed_job_id

string (uuid) or null

No

null

Explicitly requested new attempt after reviewing this completed mesh job, including quality or resource failures. Use a fresh idempotency key; this records lineage and never restarts the prior execution.

engine

"structured" / "openfoam" / "octree_prism"

Yes

Omitted

structured = Cartesian; octree_prism = octree/polyhedral with prism layers; openfoam = legacy engine identifier. Prefer configured octree_prism for generic unstructured requests; preserve explicit methods. Choose delivered file formats separately with export_formats.

export_formats

array of "cgns" / "gd_cgns" / "fluent" / "openfoam"

No

["cgns"]

minItems: 1; maxItems: 4; Delivered mesh formats, in preference order. Default cgns is Standard CGNS (NGON/NFACE) for ParaView/Luminary. gd_cgns is GD CGNS for Fluxcore/Studio; fluent is polyhedral .msh for Fluent/STAR-CCM+; openfoam is a polyMesh archive for OpenFOAM/SimScale/Fidelity. Select formats independently of the meshing engine. The first format is the primary download. GD CGNS is also retained internally for simulation and viewing. Preserve an explicit user choice; do not ask for a format when none was specified.

target_cells

integer

No

1000000

minimum: 1000; maximum: 20000000

structured

MCP_create_mesh_StructuredOptions or null

No

null

openfoam

MCP_create_mesh_OpenFoamOptions or null

No

null

octree_prism

MCP_create_mesh_OctreePrismOptions or null

No

null

decision_context

MCP_create_mesh_DecisionContext

No

Omitted

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_mesh",
    "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.