MD MCP Plugin
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| MD_MCP_HOST | No | Host for the loopback endpoint; set if the loopback endpoint differs from the default 127.0.0.1. | |
| MD_MCP_PORT | No | Port for the loopback endpoint; set if the loopback endpoint differs from the default 7421. | |
| MD_MCP_DATA_DIR | No | Writable data directory; give every client of the same listener the same value so that they share the write journal. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| md_connectB | Connect to the configured local MD listener and read the active project. No window/input operation. |
| md_sceneB | Read current project identity, paper UUIDs/input topology, quality and scene_token. No fixture loading. |
| md_project_openC | Open an existing .zprj via explicit non-dialog API options. Replacing a nonempty scene requires replace_current. Never saves/overwrites the input file. |
| md_project_save_copyA | Save current state to a new absolute .zprj filename; existing outputs are rejected. Saving can change the active project path. |
| md_selected_patternsC | Read selected pattern UUIDs using native per-index flags and corroborating selected names. |
| md_select_patternB | Select exactly the current UUID's pattern, clearing previous selection through the SDK. Does not select a particular handle/line or change geometry; no OS input/window activation. |
| md_recover_curve_operationA | Reload the same saved project after a known-complete curve input batch left a partial target. Discards its unsaved project changes. Requires unchanged native readback, closed input, the saved-file SHA and ownership of the unresolved lease. Keeps the original failure receipt; never repeats the curve write. |
| md_recover_cut_operationA | Reload the same saved project after a completed Cut with partial verification. This discards the project's unsaved changes. The input batch, current readback and saved source SHA must match the original receipt. The original result is retained. |
| md_operation_statusC | Read/reconcile a durable request without repeating the mutation. Timeout never means cancelled. |
| md_reconcile_property_operationC | Observe a known-returned Simulation Properties command after its diagnostic read failed. Requires a complete current page and unchanged original native/runtime scope. Keeps the original outcome and never triggers the command again. |
| md_reconcile_world_cameraC | Observe the current camera after the original fixed-view request returned without verified readback. The original view and scene identify the observation. The original UNKNOWN result is retained. |
| md_property_contentsB | Read controls on the currently visible Property Editor page using current owner paths. No page switching or setting writes; numeric UI values do not establish solver/native vertex ownership. |
| md_capabilitiesA | Read packaged capability declarations. Does not prove runtime support or successful live validation. |
| md_transform_probeC | Read actual transform symbols/docs and optional current UUID index. Does not call a setter, load/save a project, or infer a world contract from symbol presence. The default native world writer is unavailable. |
| md_translate_pattern_worldA | Translate one current pattern by [dx, dy, dz] in WORLD millimetres. delta_mm has exactly three finite numbers. Executes once only when a native world backend is configured; verifies every target vertex and unchanged non-target geometry/invariants. Never uses arrangement offsets, project import/export, simulation, or automatic restoration. |
| md_rotate_pattern_worldA | Right-hand rotate a whole pattern around an explicit WORLD axis/pivot. axis_world is a nonzero three-number direction, normalized internally. angle_degrees is finite and in [-360, 360]; pivot_world_mm is an explicit three-number WORLD point in mm, never an inferred centroid. For the ring route, capture the selected pattern with include_mesh and supply that request ID, physical PNG ROI and three calibrated logical viewport points. Omit ring_color for blue/Z. Red/X and green/Y require a color-qualified path from the current frame. The positions profile verifies the same vertex tolerance and preservation of UV, topology and other groups. It also reports the separate normal error. For a calibrated enlarged red path, supply gizmo_scale_steps=2 and expanded_ring_support_sha256 from the qualified enlarged frame. Enable include_assigned_topstitch to refresh one bound Texture Topstitch and verify both groups against the same requested matrix. |
| curve_runtime_capabilitiesB | Read actual API symbols and the trusted writer's availability; never edits geometry. |
| curve_handlesB | Read cubic Bezier curves and handle refs from the current pattern UUID; XY is 2D mm. References include their owner and fresh topology/geometry fingerprints. Re-read after any scene change. Unsupported spline encodings are reported without conversion. |
| set_curve_handle_xyA | Set one independently editable outer Bezier handle to absolute 2D XY in mm. Select its pattern with md_select_pattern, set Edit Curve Point mode, and Fit Selected. Use a fresh scene_token and handle_ref from curve_handles and a unique request_id. The operation measures the current input mapping and verifies the native target, fixed endpoints, opposite handles and other 2D semantics before reporting success. |
| cloth_probe_runtimeC | Inspect cloth and Rest API signatures for the current MD runtime. |
| cloth_read_scene_positionsA | Diagnostic scene-wide XYZ getter: native units/order unverified, no editable owner/vertex references. Returns a bounded sample and count/hash. |
| cloth_get_positionsC | Read current world XYZ in mm and optionally issue scene-, topology-, and pose-bound OBJ vertex references. Use vertex_indices to select compact OBJ rows, or [] for topology metadata. References identify exported vertices. |
| cloth_set_positionsC | Request absolute world XYZ in mm. The explicit meshbox_plane method uses one current OBJ vertex reference and a displacement in the current 3D camera plane. Select its pattern UUID in MovePattern/World and frame it for calibration. The method requires a uniquely resolved 2D outline and verifies the complete scene OBJ after writing. |
| cloth_recover_positionsC | Restore the original mode after a verified MeshBox entry failed before selection. Supply the original unresolved Cloth position request and its current scene token. Recovery never repeats the vertex edit and the failed frame bridge remains quarantined. |
| cloth_reconcile_rest_archiveC | Observe the original closed native Rest action with a fresh archive and complete current OBJ. Retains its original outcome and releases its lease only after the same scene and owner have been independently observed. Sends no second Rest button action. |
| cloth_rest_shapeB | Update Rest from current 3D state or reset the reference for one selected UUID. The native_archive method requires MD 2026.1.237 minimized with stopped simulation, the existing hidden Rest host in Selected Patterns mode, and one current pattern selected. It checks serialized Rest coordinates against the current ordered OBJ. |
| cloth_vertex_context_inspectC | Observe current Cloth vertex mode, Qt items and SDK pattern selection. Returns native vertex identity as unavailable and has zero input effects. |
| cut_probe_runtimeC | Read actual SDK symbol signatures only. Presence never proves native Cut works. |
| cut_inspectC | Resolve a current UUID and inspect topology-bound shape/line references and distinct child/ordinal namespaces. Read-only. |
| cut_along_internal_shapeB | Cut once along an existing whole internal shape, never create a line or retry indices. Use refs from cut_inspect. Coordinates/tolerances are 2D mm. Default 3D/Rest/UV preservation is unsupported; explicitly false requests only native 2D partition evidence. Cut & Sew also reports unverified seam readback. |
| cut_qt_runtime_capabilitiesB | Read trusted provider configuration only; never selects or cuts. |
| cut_qt_inspectB | Read shape/line references and fresh PointInfo geometry binding for the current paper. Pass the returned shape_uuid and line_uuids with the scene token and topology fingerprint to prepare. export_shape_id and export_line_ids are diagnostic. |
| cut_qt_prepare_line_selectionB | Use an installed core-owned semantic selector for one current whole native internal line. Live-verified profiles are an anchored straight line with an existing seam, and an anchored single cubic segment. Supply one line from cut_qt_inspect. The packaged atomic provider prepares a frame candidate without changing selection. A legacy installed selection provider may select the line during preparation. Returns a single-use selection_ref after fresh native, PointInfo and frame checks. |
| cut_qt_execute_selectedB | Consume one core-generated ref, revalidate, trigger selected Cut at most once and read native after. The default also checks before/after exported 3D surface samples, area, orientation and non-target groups. Set require_surface_preservation=false for the native 2D partition check alone. The result identifies the exact verification scope. |
| canvas_runtime_capabilitiesB | Inspect trusted native configuration and loaded Qt module identity; never loads the bridge. |
| canvas_viewsA | Read current MD 2D/3D Qt views and fresh scene-bound references; does not move or activate MD. Returns view_ref, view_fingerprint, viewport logical size, DPR, transforms, scroll, checked tool actions and scene_token. Scene coordinates are Qt units; they are not model millimetres or world XYZ. Does not capture an image or certify hidden camera state. |
| canvas_gestureA | Send ONE complete left-button click/drag to a freshly read current 2D/3D view. Points are viewport LOGICAL pixels, independent of DPR: click=[start]; drag=[start, intermediate...,end], at most 32 points. Uses the current tool without selecting modes. Modifiers affect these synthetic events only. MD must already be inactive/background; no window restore, activation or OS input is used. Native preflight validates dynamic bounds, references and mappings before any events. Release/cleanup is in this same RPC. SUCCEEDED proves the closed event batch and public view readback only; selection hits, geometry, handles and XYZ require separate domain readback. Partial/unknown dispatches need root recovery; do not retry with a new request_id. Budget is cooperative between events, not a native callback timeout. Requires the scene_token returned by canvas_views. |
| mesh_probe_runtimeC | Read fixed OBJ API/option metadata; performs no export or model modification. |
| mesh_read_patternB | Diagnostic UUID-filter request. Current SDK can ignore patternList despite typed readback: returns UNSUPPORTED plus actual unbound export/group diagnostics, no UUID mesh or vertex refs. Use mesh_read_scene or an explicit OBJ-label mesh_read_group. |
| mesh_read_sceneB | Fresh scene-wide garment OBJ export in world mm. Use summary_only to compare the canonical digest of positions, UVs, normals, face indices, and labels without returning arrays. The full OBJ remains available at its verified asset path. Vertex references require the full snapshot. |
| mesh_read_groupB | Read one exact OBJ group label from a fresh scene export. Compacts vertices/UV/normals and preserves complete bidirectional export index maps and source face indices. Multi-group selected faces are rejected. Group refs are NOT pattern UUID, solver vertex, or native setter refs; other groups including topstitch are excluded by exact label. |
| scene_adapter_bezier_drag_unsnappedC | Fixed four-phase Bezier batch with only Snap to Pattern/Smart Guide temporarily off. The two unique current-owner actions are triggered only when needed, then restored by original state after paired Release (including failure cleanup). No arbitrary QAction/setting/key. Does not prove semantic hit or mm precision. |
| scene_adapter_zoom_in_atB | One fixed NoMod scene hover then a version-pinned viewport wheel. Requires fresh current 2D refs and Edit Curve Point mode. No OS wheel, focus, configurable delta, loop or automatic retry. Dispatch is not proof of actual zoom, pivot, magnification or native preservation; track/read back independently. |
| scene_adapter_zoom_out_atB | Apply one fixed outward wheel in Edit Curve Point mode on the current 2D viewport. Uses the pinned adapter with no OS input or foreground activation. Read a fresh frame to verify the zoom. |
| scene_adapter_fit_selectedB | Fit the current 2D view to exactly one SDK-selected pattern through its fixed native action. No OS input or window activation; model coordinates are unchanged. |
| scene_adapter_fit_allC | Run the fixed 2D Zoom Extents All action in the current background viewport. Read a fresh frame to verify which pieces are visible. No shortcut or physical input. |
| scene_adapter_runtime_capabilitiesC | Read trusted configuration state without loading native code. |
| scene_adapter_inspect_2dA | Read current 2D view/tool refs, public metadata and zoom/fit/frame action declarations. No method/action is invoked. This does not establish native-mm mappings or handler callability. |
| scene_adapter_capture_2dC | Paint the current 2D viewport once, then resolve its owned framebuffer to PNG. No caller path, window restore, focus or event pump. Normal Qt/MD paint cache effects are allowed. Owned GL objects/context/bindings require cleanup; full GL purity and semantic scene content remain unproved. Root independently checks actual native preservation. |
| scene_adapter_bezier_dragC | One fixed 2D NoMod hover/press, Alt move/release batch in current Edit Curve Point mode. This is a viewport primitive: native handle ownership, mm targets and preservation must be established independently. No arbitrary modifiers/events, OS input, focus or project changes. |
| scene_adapter_set_toolC | Set exactly one of three fixed current-owner 2D tool actions, or verify already-current. At most one QAction trigger; no arbitrary name, input or implicit model write verification. |
| scene_adapter_cut_selectedB | Trigger only actionCutPattern2D once in Edit Pattern mode with one fresh public Qt selection. This proves action return only, never native line identity or a correct partition. Domain selection and native after-readback are caller/core obligations; partial/unknown is not retried. |
| rest_adapter_inspect_host_controlsC | Catalog existing standard Qt controls under the current Override host, including hidden controls. |
| world_gizmo_scale_inspectC | Read the two fixed Gizmo Scale actions in the current view without triggering them. |
| world_gizmo_scale_prove_roundtripC | Measure and restore two Gizmo Scale increments for the current selected pattern UUID. |
| world_gizmo_scale_recover_pairC | Observe the held native scale phase and restore its verified pending inverses in the original view. |
| world_adapter_probe_runtimeB | Read adapter configuration/blocked status. No DLL loading or MD API call. |
| md_reconcile_world_rotationB | Observe a held closed rotation with fresh geometry and assignment readbacks. Releases only the original matching lease. The original mutation outcome remains recorded and no further drag, offset setter or project reload runs. Check md_operation_status first when the original call timed out. |
| world_adapter_inspect_3dB | Read the current 3D viewport, Qt mapping, gizmo state, fixed Grid Properties action and candidate method signatures. Qt scene units are not world mm. |
| world_adapter_read_cameraC | Read current CMT and CPT camera data tied to the same live 3D viewport and scene. |
| world_adapter_set_canonical_viewC | Set Front, Left or Quarter and verify the camera basis. Optionally fit the garment using the same background 3D view. |
| world_adapter_select_patternC | Select one fresh UUID using SDK SelectPatternViaIndex(index, keepPreviousSelection=False), then verify all index getters and exact unique name. Selection only, no geometry/OS input. This bool does not choose 3D. Inspect current 3D view after selection before a pixel-based primitive. |
| world_adapter_read_group_bindingC | Read current SDK UUID/unique-name to exact OBJ group-label bijection, covering every current paper name with exclusive disjoint groups. Additional groups stay unclassified/protected. This proves labels only, not native mesh ownership or setter indices; exports once, no input or DLL required. |
| world_adapter_inspect_topstitch_assignmentsC | Read current SDK Topstitch assignments and corroborate exact OBJ group labels. |
| world_adapter_arrow_stepC | Send one screen-relative Qt arrow press/release and read both complete scene exports. An optional 4x4 world-mm translation matrix is checked after dispatch. Read result.matrix_acceptance for the comparison. The matrix does not select a direction or step size. Position tolerance is at most .002 mm. Pass canonical_view to verify the world axes immediately before input. |
| world_adapter_gizmo_dragB | Send the fixed five-event drag in current viewport logical pixels, total path <=128px. Supply points from the current selected target and view. An optional world-mm 4x4 matrix checks the resulting exports in matrix_acceptance. The drag path alone has no calibrated world axis, pivot or angle. |
| world_frame_captureB | Capture the current background 3D viewport and bind the PNG to its camera and scene. Pass a pattern UUID to require it as the only selected piece. With include_mesh, verify simulation is off and compare two world OBJ exports. |
| world_frame_observe_ringsC | Read ring contour candidates in a verified frame. ROI uses physical PNG pixels. |
| world_frame_calibrate_outlineC | Fit the selected outline against its retained world OBJ and validate separate edges. |
| world_grid_step_inspectB | Read the current 3D arrow step in mm, restoring the original property page before returning. Acquires the mutation journal because the Grid Properties page may need to open temporarily. |
| world_grid_step_translate_axisA | Move the current selected pattern along one axis using a temporary Grid step. Select the current pattern in Front for X/Y or Left for Z. Uses signed millimetres with one decimal place, reads the moved OBJ, and verifies restoration of the original Grid field and property page. The exported groups must bind uniquely. Other panels and their accessories are protected. The optional position profile independently verifies XYZ and bounds each target OBJ normal component to one six-decimal quantum. A failed matrix check can include a measured move and a restored Grid. |
| world_grid_step_recover_axisC | Restore the original Grid field for an eligible same-process request without moving geometry. |
| world_numeric_probe_inspectC | Read existing Translate 3D instances, including hidden ones, and their Qt numeric controls and method declarations. |
| rest_dock_identity_inspectB | Read fixed property candidates including hidden identities, ancestor docks/stacks and action associations. No hidden numeric traversal, action/slot/toggle, simulation, logger changes or panel creation. |
| rest_visible_contents_inspectC | Read the actual visible QWidget/PropertyEditorContents branch, pruning all hidden widget pages. |
| rest_open_simulation_propertiesB | Trigger only the existing enabled/noncheckable Simulation Properties action once. Keeps MD minimized; reads the resulting page and verifies current native 2D/runtime scope. No simulation, menus, arbitrary action, show/raise/activate, Rest write or old-page restore. Handler faults/modal behavior cannot be contained; unknown is not retried. |
| rest_set_pinching_overrideA | Set only the currently visible Pinching Simulation Override checkbox and read it back. Native batch keeps MD minimized. No simulation/brush/Update Rest/Reset Rest action. A changed value causes exactly one public checkbox click; a matching value causes none. Restore with the returned original_ui_value when this independent trial is finished. Unknown results must never be replayed automatically. |
| rest_simulation_context_inspectB | Read fixed SimStop/Drape/Brush actions, their associated buttons, real meta declarations and fixed SDK docs. Does not trigger actions, invoke slots or SDK getters, start/stop simulation or create dialogs. QAction checked states remain observations; they are not independently verified solver running state. |
| rest_initialize_hostA | Initialize the native Rest host in a fresh, minimized MD process. Open a disposable saved .zprj copy and enable Pinching Simulation Override through the existing Rest tools first. Supply the SHA-256 of that copy. Simulation may change in-memory cloth positions. The tool never saves the project. Poll md_operation_status with the same request ID until settled, then restore the original Override value and reopen the working project. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 79 tools
Multiple families target the same underlying actions with subtly different semantics that an agent will struggle to separate: canvas_gesture vs scene_adapter_bezier_drag vs world_adapter_gizmo_drag vs world_adapter_arrow_step are all synthetic input primitives, and cloth_get_positions vs cloth_read_scene_positions vs mesh_read_scene all read vertex data. Several recovery/reconcile tools (md_recover_curve_operation, md_recover_cut_operation, cloth_recover_positions, world_gizmo_scale_recover_pair, md_reconcile_*) overlap heavily with each other and with md_operation_status. Descriptions are dense but help only marginally in deciding which near-duplicate to pick.
Everything is snake_case, but the prefix scheme is fragmented: world_adapter_, world_, scene_adapter_, rest_, rest_adapter_, md_, cloth_, cut_, cut_qt_, mesh_, canvas_. Verb placement also varies (world_adapter_inspect_3d and scene_adapter_inspect_2d put the verb first, while mesh_probe_runtime and cloth_probe_runtime put it last). Still readable, but not a predictable pattern across 79 tools.
79 tools for one MD plugin surface is far past the point where each tool earns its place. Large clusters of probe/runtime-capabilities, recover, and reconcile variants exist per sub-domain, which bloats the catalog beyond practical selection.
Coverage is broad across project lifecycle (connect/open/save copy), scene inspection, selection, mesh/vertex read-write, curve handle edit, cut, rest, and camera work, with explicit recovery paths. However it is lopsided: heavy on diagnostics and single-purpose primitives, while basic operations like pattern/curve creation or deletion and general undo/restore are absent.