Implicit geometry and CAD through API/MCP¶
All modelling operations use the central engineering service. Use Implicit Modelling to learn the concepts and design operations for exact routes.
Discover, edit and evaluate¶
Use
get_design_operation_schemawithout a name to list operations.Call the
cataloguedesign operation to discover supported feature operations and typed inputs.Retrieve a template or compose a self-contained
gd.design/v1document.Validate the document, apply typed edits with the expected revision, and inspect the returned candidate.
Evaluate outputs, manufacturing constraints, sections and simulation regions as needed.
Use
create_geometry(document=...)to produce durable engineering artifacts. For a registered template, usetemplate_idinstead; the sources are mutually exclusive.
{"name":"call_design_operation","arguments":{"name":"catalogue"}}
{"name":"get_design_operation_schema","arguments":{"name":"edit"}}
Stateless design operations return proposed documents/results; they do not save a Studio revision. Publishing a shared authoring draft and accepting it in Studio are separate steps. See agent authoring.
Durable geometry jobs¶
POST /v1/geometry/validate validates the request without a geometry job. POST /v1/geometries submits it with an Idempotency-Key. MCP uses validate_geometry and create_geometry, with idempotency_key in the tool arguments.
For new custom documents, default outputs are STL and design JSON. Documents must be self-contained; arbitrary executable code and external asset references are not accepted by this durable path. Keep the resulting design artifact and geometry surface IDs for lineage.
Select physical outputs¶
For meshing, explicitly select volume output_names. Heat-load footprints, construction helpers and boundary-only objects are not material volumes. Keep solid and fluid volumes named and separate where the CHT workflow requires them.
For graph volumes requiring a meshing STEP assembly, request purpose="meshing", method="auto" and explicit outputs. The service can retain exact bodies where supported and use checked faceted solids for eligible implicit volumes. Read the artifact’s exactness and export report; this is not a universal exact-CAD conversion.
named_stl=true requires a document, selected output names and STL output. It creates combined and per-body surfaces useful for named mesh boundaries. Use the returned artifact metadata, not guessed filenames, to associate bodies.
Templates and parameter studies¶
list_templates and get_template return availability, parameter ranges, choices, units, output names and exact-export support. A template’s existence does not qualify every parameter combination. Validate each variant and inspect its output geometry. Templates and feature operations are different catalogues.
Reconstruct uploaded CAD¶
Use reconstruct_cad on an owned STEP or supported 3MF artifact, then follow get_operation. Inspect the resulting parameter scope, fidelity, retained geometry and permitted edit ranges. edit_reconstructed_cad uses the reconstruction identity and expected parent checksum.
External clients with their own credentials use explicit measured feature/parameter operations. Hosted natural-language composition has application-specific availability. Do not promise recovery of the source CAD’s original feature history or silently replace an imported part with an approximate template.