Provides tools for interacting with Autodesk 3ds Max, enabling AI agents to create and manipulate objects, materials, modifiers, and animations, inspect scene state and plugin classes, manage layers and groups, and capture viewport images.
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., "@3dsmax-mcp create a teapot in the viewport and apply a glossy red material to it"
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.
This is a personal fork of cl0nazepamm/3dsmax-mcp by clone / m3org, released under the MIT License. All credit for the server, the native bridge, and the tool set belongs to the upstream author. This fork (sinushawa/MAX_MCP) tracks upstream and adds a per-module tool filter with an in-Max settings window, a local MAXScript reference index exposed as a
search_maxscript_docstool, a harvested V-Ray 7 reference, and an installer fix for running instances of 3ds Max. Fork-specific notes live in CLAUDE.md; everything below is the upstream README. Report upstream issues to the upstream project.
Connect AI agents to Autodesk 3ds Max through the Model Context Protocol.
Automate everything!
Current release: 1.6.6 — Astra Special Release — see CHANGELOG.md.
160 MCP tools — For scene reads, modeling, materials, modifiers, controllers, viewport capture, procedural graphs, and plugin workflows.
Native Bridge — only 2023-2027 versions.
Introspection — discover arbitrary Max classes for all kinds of automation and scripting purposes.
Bundled agent skill — There is a bundled maxscript documentation if you want to create your own tools.
Related MCP server: 3dsmax-mcp
Autodesk 3ds Max 2023–2027
git clone https://github.com/sinushawa/MAX_MCP.git # fork; upstream: https://github.com/cl0nazepamm/3dsmax-mcp
cd 3dsmax-mcp
uv sync
uv run python install.pyChoose the MCP tool profile when prompted. Full is the default for maximum client compatibility and performance. Progressive exposes three discovery tools and loads exact operational schemas only when needed, which can substantially reduce context use for local or smaller models.
Restart 3ds Max, then connect your MCP client. The installer registers the server where it can; see Advanced configuration for manual client setup.
Update an existing install:
git pull
uv sync
uv run python install.pyTool | Description |
| Ping the MCP bridge when diagnosing connection errors |
| Bundle bridge status, capabilities, scene summary, and selection in one call |
| Max version, renderers, installed plugins, and class counts |
Tool | Description |
| Unified reads: |
| Resolve names, handles, or hierarchy paths to canonical, cross-checked NodeRefs |
| Scan scene-graph hygiene and apply explicit safe naming repairs; never analyzes meshes |
| Preflight and atomically apply up to 256 mechanical node edits in one native undo step |
| Recursive child tree for an object |
| All instances sharing the same base object |
| Reference graph via dependents / dependent nodes |
Tool | Description |
| Create geometry with spatial placement feedback |
| Delete objects by name |
| Compact properties for one object |
| Set a single object property |
| Move, rotate, and/or scale by offset |
| Pivot, bbox, local axes, and world matrix for rigging and placement |
| Copy, instance, or reference clones |
| Parent or unparent objects |
| Change the current selection |
| Show, hide, freeze, or unfreeze |
| Rename many objects in one call |
Tool | Description |
| Add a modifier to an object |
| Remove a modifier by name |
| Enable/disable with viewport/render granularity |
| Set a modifier parameter on one or many objects |
| Collapse the stack |
| De-instance a shared modifier |
| Compatibility alias for |
Tool | Description |
| Named curves, rounded profiles, sweeps and quad lofts with controls saved in the scene |
| Inspect, visually target and edit spline knots and handles with stale-token protection |
| Build editable polygon cages from explicit vertices and faces |
| Read cage geometry, label components and map image positions to edit targets |
| Undoable vertex, edge and face edits that preserve the modifier stack |
| Matched-section quad lofts with persistent numeric parameters |
| Check mesh boundaries, winding, degeneracy and connected components |
| Apply, inspect, retune, rename, or extract Boolean modifier operands; supports inline repeated cutters |
| Create, read, and edit spline shapes from explicit world-space points and knots |
| Read, move, set, or conform Editable Poly vertices in world space |
Tool | Description |
| List materials assigned in the scene |
| Inspect |
| Save temporary/scratch material libraries to |
| Compact slot/property readback for a material |
| Semantic material graph, wired slots, texture manifest, health checks |
| Preview/apply structure-preserving material clone and texture remap |
| Create a material and assign it to objects |
| Set one property on an object's material |
| Set multiple material properties at once |
| Create or assign a Multi/Sub-Object slot |
| Create a texture map (stored as a MAXScript global) |
| Edit a texture map global |
| Build a fully wired PBR material from texture files |
| Wrap any render + export materials in Shell Material (dual pipeline) |
| Write OSL to disk and compile an OSLMap |
| Swap one material for another on all users |
| Batch material replacement |
| Fill Material Editor palette slots from a texture folder |
| Batch-import meshes from a folder with auto PBR assignment |
Tool | Description |
| Deep exploratory object summary |
| Deep property dump (`target="object" |
| API surface for OSLMap and shader classes |
| Full reference dependency walk |
| Analyze class usage patterns in the live scene |
| ParamBlock2 reference relationships between classes |
| Live event watcher for interactive sessions |
| Per-selection isolated viewport captures |
| Inspect or clean up callbacks and timers running on Max's main/UI thread |
Tool | Description |
| Find plugin-related classes and entry points |
| Enumerate registered SDK classes |
| List classes for a plugin or superclass family |
| Runtime class scan + showClass reflection |
| Creation notes for a plugin class |
| Live instance inspection with plugin context |
| Structured manifest (classes, workflows, gotchas) |
| Rebuild manifest from live runtime |
| Full C++ SDK API surface for a class |
| Deep SDK introspection with live values |
MCP resources: resource://3dsmax-mcp/plugins/{name}/manifest|guide|recipes|gotchas
Tool | Description |
| Create and assign a controller to a sub-anim track |
| Inspect one controller track |
| Track View-style controller hierarchy |
| Edit script text or controller properties |
| Add a target to script/expression/constraint controllers |
| Timeline control; bounded delete/move/scale, bake/resample, tangent normalization, pose matching, and loops |
Tool | Description |
| Discover wireable sub-anims on an object |
| Connect parameters with a wire expression |
| List existing wire connections |
| Remove a wire |
Tool | Description |
| Create, delete, list, and configure layers; move/select objects |
| Create, ungroup, open, close, attach, detach groups |
| Named selection sets |
| Hold, fetch, reset, save, scene info |
| Undo the last 3ds Max scene operation |
Tool | Description |
| Independent floating agent view, visual targeting and V-Ray preview controls |
| Position and frame the agent or user viewport |
| Capture the agent or user viewport as an image |
| Capture several views into one image, with agent-view restoration |
| Capture visible desktop pixels or crop to the V-Ray frame buffer |
| Render the current view |
| Arm/poll completion signals, request cancellation or capture a progressive render before cancelling |
.max filesTool | Description |
| Read metadata and object names without loading |
| Selective merge with duplicate handling |
| Scan a folder for objects matching a pattern |
| Parallel metadata from many |
Tool | Description |
| List atmospheric and render effects |
| Enable or disable an effect by index |
| Remove an effect by index |
| State Sets with camera assignments |
| Camera-assigned State Sets sorted by frame |
Tool | Description |
| Search the live version-specific operator catalog |
| List installed Data Channel presets |
| Append operators to a Data Channel modifier stack |
| Read the active stack in visible processing order |
| Edit one visible operator with rollback on failure |
| Delete, enable, disable, or safely reorder operators |
| Load a preset into the stack |
| Add executable MAXScript with explicit authorization |
Tool | Description |
| Compiler, temporary workspace, templates, samples, and safety state |
| List temporary, installed, or bundled sample graphs |
| Normalize graph metadata, nodes, connections, and parameters |
| Search live typed operators and offline compound references |
| Fork a read-only source into the temporary workspace |
| Patch, compile, verify, checkpoint, and roll back transactionally |
| Validate and compile one temporary graph with diagnostics |
| Create, inspect, and remove a disposable generated instance |
| Resolve the exact generated modifier class descriptor |
| Compile and apply a typed MCG modifier safely |
| Verify graph identity and inspect a live MCG modifier |
| Retarget one supported scalar node parameter |
| Restore an opaque checkpoint with hash protection |
| Remove one graph family or the temporary MCG workspace |
| Explicitly refresh Max's global MCG operator depot |
Tool | Description |
| Available operator names for this install |
| Create tyFlow with events and operators |
| Presets: rain, snow, fountain, burst, debris |
| Deep flow/event/operator readback |
| Probe and cache the installed tyFlow operator surface by tyFlow version |
| Query the cached tyFlow operator manifest without touching Max |
| Read events, operators, properties, ledger edges, and wiring staleness |
| Apply a batch of tyFlow graph operations as one verified transaction |
| Connect or retarget a test/Send Out operator to an event |
| Disconnect an operator output and remove its ledger edge |
| Reconcile recorded graph wiring after external or visual edits |
| Count particles per event at probe frames with temporary instrumentation |
| Open and capture the tyFlow editor for visual wire inspection |
| Edit operator properties |
| Configure Shape operator |
| Object-level PhysX settings |
| Collision operator + collider list |
| Add an event |
| Wire Send Out destinations |
| Remove operator or event |
| Particle count at a frame |
| Particle data rows |
| Reset one or all tyFlow sims |
Work in progress — the Forest Pack and RailClone integrations below are early-stage and may be incomplete or change between releases. Everything listed above is stable.
Tool | Description |
| Create a Forest Pack scatter with surfaces and source geometry |
Tool | Description |
| Read style-editor bases, segments, and parameters |
Tool | Description |
| Run MAXScript when no dedicated tool exists (respects safe mode) |
| Call any registered tool from inside Max (testing) |
The installer builds an agent skill from skills/3dsmax-mcp-dev/SKILL.md with tool-choice rules, material pipeline notes, and MAXScript reference files. Rebuild manually with python scripts/build_skill.py — see Advanced configuration.
Advanced configuration — architecture, safe mode, tool profiles, native builds
CHANGELOG.md — release history
This server cannot be deployed
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
Build editable 3D scenes, direct characters and cameras, and export AI video references with MCP.
A comprehensive Model Context Protocol (MCP) server that enables AI assistants to control Unreal E…
OCR, transcription, file extraction, and image generation for AI agents via MCP.