MD MCP Plugin
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@MD MCP Plugin Check capabilities, connect, and summarize the current Marvelous Designer scene."
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
MD MCP Plugin
A local stdio MCP server for AI clients working with Marvelous Designer. It uses a loopback listener in MD and returns structured receipts for inspection, editing, verification, and recovery.
Requirements
Python 3.11 or later for the MCP server.
Windows x64 for the native adapters. The live validation target is Marvelous Designer 2026.1.237 with Qt 6.10.3.
An authenticated MD session with a compatible listener on
127.0.0.1:7421. The current listener protocol ispingandexecute_pythonfrom MarvelousDesigner-MCP.
The existing listener can execute Python inside MD. Keep it on loopback and connect trusted local clients.
The source distribution includes the adapter manifests and Windows build recipes. To use a native tool, build and stage the matching bridges using those instructions. The runtime checks each bridge hash before loading. The source package starts and exposes its MCP tool schemas independently of those bridge files.
Related MCP server: Cascadeur MCP
Start the MCP server
Install the source package into a Python environment, then run the module as a stdio MCP server:
python -m pip install .
python -m md_mcp_pluginUse that Python executable as the MCP client command with -m md_mcp_plugin as its arguments. Set MD_MCP_HOST and MD_MCP_PORT if the loopback endpoint differs. Give every client of the same listener the same writable MD_MCP_DATA_DIR so that they share the write journal.
Use from an AI client
Call
md_capabilitiesandmd_connect. Read the scene before editing and work in a copy until the operation is verified.Resolve the current pattern UUID and the operation-specific references. Supply the current scene token and a unique request ID with each write.
Inspect the result for the requested geometric verification. If a call times out, query
md_operation_statusfor that request before retrying.
Use mesh_read_scene(summary_only=True) to compare the digest of complete OBJ geometry without transferring the full array payload. The summary retains the hashed OBJ asset path. Request the full snapshot when vertex references are needed.
The validated routes cover an individual Bézier control handle with fixed endpoints, straight and single-segment curved native cuts, single cloth vertex XYZ, stopped-simulation Selected Patterns Rest Update/Reset, and calibrated world-space placement. Rotation requires a current ring plan. Rest requires the matching native controls to be available. The decimal Grid operation verifies the selected current UUID and full OBJ. Its broader project scope is covered by offline tests and requires live qualification. md_capabilities reports the tested scope and current adapter constraints. Automatic MD Personal sign-in from a fresh desktop session remains unverified.
Initialize Rest after starting MD
Open a saved disposable
.zprjcopy throughmd_project_openand keep MD minimized. Userest_adapter_inspect_host_controlsto check whether a Rest host is already initialized.For an uninitialized host, use
rest_open_simulation_propertiesandrest_set_pinching_overrideto enable Pinching Simulation Override. Keep the original checkbox value from the setting receipt.Call
rest_initialize_hostwith the current scene token, saved copy SHA-256, and a fresh request ID. Pollmd_operation_statusfor the same request ID until it settles. The plugin starts and stops the simulation once, then verifies that Select/Move is restored and the simulation pinching tools are disabled. The background toolbar refresh is bound to the supported MD 2026.1.237 executable. In-memory vertex positions on the copy can change.After
SUCCEEDED, restore the original checkbox value, reopen your working project, and verify the hidden host withrest_adapter_inspect_host_controls. For anUNKNOWNresult, usemd_operation_statuson the original request to check for a later receipt. The shared mutation journal stays locked while the outcome is unresolved.
Run the offline tests
With the package and its Python dependencies installed, run python -m unittest discover -s tests. The tests use synthetic scenes and isolated temporary files. They do not connect to MD.
License
Available Tools
79 toolscanvas_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.
Inputs: view (required), action (required), points (required), view_ref (required), +5 more.
canvas_runtime_capabilitiesB
Inspect trusted native configuration and loaded Qt module identity; never loads the bridge.
Inputs: no named parameters.
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.
Inputs: view, budget_ms.
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.
Inputs: pattern_uuid (required), scene_token, vertex_indices, include_vertex_refs, +1 more.
cloth_probe_runtimeC
Inspect cloth and Rest API signatures for the current MD runtime.
Inputs: scene_token.
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.
Inputs: scene_token, sample_count.
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.
Inputs: request_id (required), scene_token (required), blocked_request_id (required).
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.
Inputs: request_id (required), scene_token (required), blocked_request_id (required).
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.
Inputs: action (required), scene_token (required), pattern_uuid (required), method, +1 more.
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.
Inputs: targets (required), scene_token (required), pattern_uuid (required), method, +2 more.
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.
Inputs: scene_token (required).
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.
Inputs: pattern_uuid (required), scene_token.
curve_runtime_capabilitiesB
Read actual API symbols and the trusted writer's availability; never edits geometry.
Inputs: no named parameters.
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.
Inputs: shape_uuid (required), scene_token (required), pattern_uuid (required), topology_fingerprint (required), +4 more.
cut_inspectC
Resolve a current UUID and inspect topology-bound shape/line references and distinct child/ordinal namespaces. Read-only.
Inputs: pattern_uuid (required), scene_token.
cut_probe_runtimeC
Read actual SDK symbol signatures only. Presence never proves native Cut works.
Inputs: scene_token.
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.
Inputs: request_id (required), scene_token (required), selection_ref (required), require_surface_preservation.
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.
Inputs: pattern_uuid (required), scene_token.
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.
Inputs: line_uuid (required), request_id (required), shape_uuid (required), scene_token (required), +2 more.
cut_qt_runtime_capabilitiesB
Read trusted provider configuration only; never selects or cuts.
Inputs: no named parameters.
md_capabilitiesA
Read packaged capability declarations. Does not prove runtime support or successful live validation.
Inputs: no named parameters.
md_connectB
Connect to the configured local MD listener and read the active project. No window/input operation.
Inputs: no named parameters.
md_operation_statusC
Read/reconcile a durable request without repeating the mutation. Timeout never means cancelled.
Inputs: request_id (required).
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.
Inputs: path (required), request_id (required), scene_token (required), replace_current.
md_project_save_copyA
Save current state to a new absolute .zprj filename; existing outputs are rejected. Saving can change the active project path.
Inputs: path (required), request_id (required), scene_token (required).
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.
Inputs: scene_token (required), budget_ms.
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.
Inputs: request_id (required), scene_token (required), blocked_request_id (required).
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.
Inputs: request_id (required), scene_token (required), blocked_request_id (required).
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.
Inputs: request_id (required), scene_token (required), blocked_request_id (required).
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.
Inputs: request_id (required), scene_token (required), blocked_request_id (required), expected_source_sha256 (required).
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.
Inputs: request_id (required), scene_token (required), blocked_request_id (required), expected_source_sha256 (required).
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.
Inputs: axis_world (required), pattern_uuid (required), angle_degrees (required), pivot_world_mm (required), +6 more.
md_sceneB
Read current project identity, paper UUIDs/input topology, quality and scene_token. No fixture loading.
Inputs: no named parameters.
md_selected_patternsC
Read selected pattern UUIDs using native per-index flags and corroborating selected names.
Inputs: scene_token.
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.
Inputs: request_id (required), scene_token (required), pattern_uuid (required), refresh_selection.
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.
Inputs: pattern_uuid.
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.
Inputs: delta_mm (required), pattern_uuid (required), request_id, scene_token, +1 more.
mesh_probe_runtimeC
Read fixed OBJ API/option metadata; performs no export or model modification.
Inputs: scene_token.
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.
Inputs: group_name (required), scene_token, vertex_indices.
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.
Inputs: pattern_uuid (required), scene_token, vertex_indices.
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.
Inputs: scene_token, summary_only, vertex_indices.
rest_adapter_inspect_host_controlsC
Catalog existing standard Qt controls under the current Override host, including hidden controls.
Inputs: scene_token (required), budget_ms.
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.
Inputs: scene_token (required), budget_ms.
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.
Inputs: request_id (required), scene_token (required), scratch_project_sha256 (required).
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.
Inputs: request_id (required), scene_token (required), budget_ms.
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.
Inputs: enabled (required), request_id (required), scene_token (required), budget_ms.
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.
Inputs: scene_token (required), budget_ms.
rest_visible_contents_inspectC
Read the actual visible QWidget/PropertyEditorContents branch, pruning all hidden widget pages.
Inputs: scene_token (required), budget_ms.
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.
Inputs: end (required), start (required), view_ref (required), request_id (required), +3 more.
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.
Inputs: end (required), start (required), view_ref (required), request_id (required), +3 more.
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.
Inputs: view_ref (required), scene_token (required), view_fingerprint (required), budget_ms.
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.
Inputs: view_ref (required), request_id (required), scene_token (required), view_fingerprint (required), +2 more.
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.
Inputs: view_ref (required), request_id (required), scene_token (required), view_fingerprint (required), +1 more.
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.
Inputs: view_ref (required), request_id (required), scene_token (required), view_fingerprint (required), +1 more.
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.
Inputs: budget_ms.
scene_adapter_runtime_capabilitiesC
Read trusted configuration state without loading native code.
Inputs: no named parameters.
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.
Inputs: tool (required), view_ref (required), request_id (required), scene_token (required), +2 more.
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.
Inputs: point (required), view_ref (required), request_id (required), scene_token (required), +2 more.
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.
Inputs: point (required), view_ref (required), request_id (required), scene_token (required), +2 more.
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.
Inputs: x_mm (required), y_mm (required), handle_ref (required), scene_token (required), +3 more.
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.
Inputs: view_ref (required), direction (required), group_name (required), scene_token (required), +7 more.
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.
Inputs: end (required), start (required), purpose (required), view_ref (required), +9 more.
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.
Inputs: budget_ms, scene_token.
world_adapter_inspect_topstitch_assignmentsC
Read current SDK Topstitch assignments and corroborate exact OBJ group labels.
Inputs: scene_token (required).
world_adapter_probe_runtimeB
Read adapter configuration/blocked status. No DLL loading or MD API call.
Inputs: no named parameters.
world_adapter_read_cameraC
Read current CMT and CPT camera data tied to the same live 3D viewport and scene.
Inputs: scene_token (required).
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.
Inputs: group_name (required), scene_token (required), pattern_uuid (required).
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.
Inputs: scene_token (required), pattern_uuid (required), request_id.
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.
Inputs: view (required), request_id (required), scene_token (required), fit_garment.
world_frame_calibrate_outlineC
Fit the selected outline against its retained world OBJ and validate separate edges.
Inputs: scene_token (required), focal_seed_px (required), frame_request_id (required).
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.
Inputs: request_id (required), scene_token (required), include_mesh, pattern_uuid.
world_frame_observe_ringsC
Read ring contour candidates in a verified frame. ROI uses physical PNG pixels.
Inputs: scene_token (required), frame_request_id (required), roi_px.
world_gizmo_scale_inspectC
Read the two fixed Gizmo Scale actions in the current view without triggering them.
Inputs: scene_token (required).
world_gizmo_scale_prove_roundtripC
Measure and restore two Gizmo Scale increments for the current selected pattern UUID.
Inputs: roi_px (required), request_id (required), scene_token (required), pattern_uuid (required), +1 more.
world_gizmo_scale_recover_pairC
Observe the held native scale phase and restore its verified pending inverses in the original view.
Inputs: request_id (required), scene_token (required), blocked_request_id (required).
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.
Inputs: request_id (required), scene_token (required).
world_grid_step_recover_axisC
Restore the original Grid field for an eligible same-process request without moving geometry.
Inputs: request_id (required), scene_token (required), blocked_request_id (required).
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.
Inputs: axis (required), request_id (required), distance_mm (required), scene_token (required), +2 more.
world_numeric_probe_inspectC
Read existing Translate 3D instances, including hidden ones, and their Qt numeric controls and method declarations.
Inputs: scene_token (required), budget_ms.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
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.
Maintenance
Related MCP Connectors
Nifty's MCP server — exposes tasks, projects, messages, and files as tools for AI agents.
Remote MCP server exposing your Node Command fleet (files, shell, processes, browser) to AI hosts.
Blender-as-a-service for agents: search 3D assets, run Blender Python, or brief the studio agent.
Remote MCP server for AI.TV creators — delegate account operations to your AI agent over MCP.
Related MCP Servers
- FlicenseNot gradedqualityCmaintenanceEnables AI assistants to control and query Blender scenes through local MCP, allowing operations like retrieving scene information with objects and materials.-
- AlicenseAqualityCmaintenanceEnables AI clients to control Cascadeur locally for scene and rig inspection, body and finger animation, keyframes, physics actions, camera control, PNG previews, and FBX import/export via stdio MCP.3610MIT
- AlicenseBqualityCmaintenanceConnects MCP-compatible AI agents to a local 3D garment design application through its Python API, enabling scene inspection, pattern and sewing operations, fabric/material management, simulation, mesh measurement, checkpoints, import/export, documentation search, and raw Python execution.42MIT
- AlicenseNot gradedqualityBmaintenanceEnables compatible AI clients to connect locally to inspect conversion reports, select meshes, provide bone maps, and assist with Blender/Unity repairs for avatar preparation and VRChat handoff.MIT