Verify the MD listener is reachable. Returns whatever the listener echoes back.

Stop the MD listener and release its timer and TCP connections.

Execute reviewed Python; import API modules and assign result. Look up docs/runtime first. Static guard is not a sandbox; modal-risk calls require explicit override. Raw code can change the scene and access embedded Python filesystem/process capabilities. Not a sandbox. MD_MCP_ALLOW_RAW_PYTHON=0 refuses this tool. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

Classify visible calls as safe, potentially modal, unsafe or unknown without execution. Does not mutate the MD scene.

Project, MD/Python version, pattern and fabric counts. Does not mutate the MD scene.

Runtime, MCP commit/version, documentation timestamp and connection health. Does not mutate the MD scene.

List runtime symbols; inspect_md_api reads signatures safely without trial calls. Does not mutate the MD scene.

Runtime availability, callable/type/signature, docstring and pybind overloads without invoking functions. Does not mutate the MD scene.

Search local official MD docs with BM25; return signatures and sources. Does not mutate the MD scene. Requires local index: md-mcp update-docs. Documentation can lag the runtime.

Exact API/type documentation, overloads, parameter meanings, returns and source. Does not mutate the MD scene. Requires local index: md-mcp update-docs. Documentation can lag the runtime.

Search official Pattern, Simulation, Animation and Substance scenarios. Does not mutate the MD scene. Requires local index: md-mcp update-docs. Documentation can lag the runtime.

Read one official scenario; adapt paths and review mutations before execution. Does not mutate the MD scene. Requires local index: md-mcp update-docs. Documentation can lag the runtime.

Structured patterns with runtime indices, geometry, fabrics, placement and sewing groups. Does not mutate the MD scene.

Inspect geometry and line indices before edits; ambiguous mappings are flagged. Does not mutate the MD scene.

Point coordinates in mm and IDs; curve point mutation mapping is unverified. Does not mutate the MD scene.

Create [x_mm,y_mm,type] vertices: 0=straight,2=spline,3=Bezier. Verify resulting pattern. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

Prefer point_ref for verified outer endpoints, including curved boundaries. Legacy numeric form supports straight polygons. Re-read after STALE_REFERENCE. x/y are 2D millimetres; obtain point_ref from get_pattern_topology. Geometry changes invalidate the old refs. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

Inspect, delete and verify count change. Remaining indices may shift. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

Sewing groups, pattern/edge references, directions and raw properties. Does not mutate the MD scene.

Read a sewing group; partial-edge/internal-shape line indices may be unresolved. Does not mutate the MD scene.

Prefer side_a/side_b edge refs for whole straight/curved/internal edges; optional ranges must be 0..1. Explicit boolean directions required. Legacy indices support straight outer edges. Only full-edge ranges [0,1] are supported; partial/free sewing is unverified. Obtain both refs from fresh topology. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

All object-browser fabrics plus current-colorway used count. Does not mutate the MD scene.

Assign and verify. Legacy face is colorway option, NOT surface face: 1=current,2=all unlinked,3=all linked. Prefer assign_option. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

Read actual pattern fabric assignment. Does not mutate the MD scene.

Read avatar count, names and runtime properties. Does not mutate the MD scene.

Read active project and runtime state. Does not mutate the MD scene.

Simulate steps (=frames) and verify synchronous success; does not claim convergence. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

Native quality, pattern and mesh counts; physical convergence/collision judgments are not exposed. Does not mutate the MD scene.

Save a new ZPRJ checkpoint and verify file. Existing outputs are protected. Requires a new absolute output path. ZPRJ save may change the active project path. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

Save ZPRJ with explicit path; API bool controls thumbnail creation. Requires a new absolute output path. ZPRJ save may change the active project path. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

Export OBJ with explicit options, scale, axes and object selection; verify output. Requires a new absolute path; inspect runtime ExportOBJOption fields before choosing options. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

Export FBX with explicit runtime options; verify output. Requires a new absolute path; inspect runtime ExportFBXOption fields before choosing options. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

Prefer .zprj plus explicit ImportZPRJOption (including bAppend). Legacy generic import requires modal-risk acknowledgement. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

Import .zpac using explicit ImportExportOption including bAdd; verify count. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

Import verified OBJ avatar using explicit scale/axes/type=0; AVT still needs modal acknowledgement. Use an existing absolute path and explicit scale/axis options. OBJ ImportObjectType=0 is verified; FBX/AVT avatar imports are unverified. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

UUID + native point/line enumeration + geometry snapshot refs. Read again after STALE_REFERENCE; ambiguous mappings are never guessed. Select by UUID, unique name or freshly inspected index. Prefer returned stable refs for edits; curve controls are not movable native endpoints. Does not mutate the MD scene.

Read durable MD completion receipt and output evidence; returns SUCCEEDED/FAILED/UNKNOWN and never retries. Pass the operation_id from the original call. FAILED can include partial effects; UNKNOWN needs scene/output inspection. Does not mutate the MD scene.

Save a unique ZPRJ checkpoint. Retain latest 20; older than 7 days are cleaned on creation. May affect the current project path depending on MD API behavior. Keep durable project saves outside this auto-cleaned cache. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

Replace active scene with a verified checkpoint and invalidate all topology refs. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

On-demand garment OBJ positions and index-based displacement if connectivity/UUIDs match; never judges convergence. Writes an OBJ measurement in user cache. Compare to previous_snapshot_id only if topology matches; no persistent vertex IDs or collision/convergence guarantee. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

Read/set verified arrangement X/Y/offset parameters. Not absolute world translation or Euler rotation. Controls Marvelous Designer arrangement parameters, NOT a verified world-space transform. Omit arrangement_offsets to read; otherwise supply three integers. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.

Read/set FRONT/BACK/SIDE RGBA (0..1). Setting BACK/SIDE unlinks material/color from FRONT. Verified MD 2026.0.315. Omit rgba to read. This face enum is distinct from fabric assignment colorway options. May change scene or write files. Verify resulting state. A timed-out operation is UNKNOWN: reconcile_operation before any retry.