3dsmax-mcp
Provides tools to interact with Autodesk 3ds Max for scene management, object creation, materials, modifiers, animation, viewport capture, and plugin introspection via natural language.
Click on "Install 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-mcpcreate a teapot at the origin"
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.
3dsmax-mcp
Connect AI agents to Autodesk 3ds Max through the Model Context Protocol. Ask in natural language; the agent creates objects, builds materials, inspects plugins with dedicated MCP tools instead of MAXScript/Python feedback loops. Built-in installer works with Cursor, Claude, Codex and Gemini.
Current release: 1.0.5 — see CHANGELOG.md.
Features
115 MCP tools — (79 in core profile) for scene reads, materials, modifiers, controllers, viewport capture, 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: lightfast-mcp
Requirements
Autodesk 3ds Max 2023–2027
Quick start
git clone https://github.com/cl0nazepamm/3dsmax-mcp.git
cd 3dsmax-mcp
uv sync
uv run python install.pyRestart 3ds Max, then connect your MCP client. The installer registers the server where it can; see Advanced configuration for manual client setup.
I personally use Cursor and Codex.
Update an existing install:
git pull
uv sync
uv run python install.pyTools
Bridge & session
Tool | 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 |
Scene query
Tool | Description |
| Unified reads: |
| Recursive child tree for an object |
| All instances sharing the same base object |
| Reference graph via dependents / dependent nodes |
Objects
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 |
Modifiers
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 |
Materials & textures
Tool | Description |
| List materials assigned in the scene |
| 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 |
Inspection
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 |
Plugins & introspection
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
Controllers & animation
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 |
Parameter wiring
Tool | Description |
| Discover wireable sub-anims on an object |
| Connect parameters with a wire expression |
| List existing wire connections |
| Remove a wire |
Organization
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 |
Viewport & render
Tool | Description |
| Capture the active viewport as an image |
| Front/right/back/top grid stitched into one image |
| Fullscreen capture (explicit opt-in) |
| Render the current view |
External .max files
Tool | 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 |
Effects & state sets
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 |
Work in progress — the plugin and layout integrations below (Data Channel, tyFlow, Forest Pack, RailClone, Floor plan) are early-stage and may be incomplete or change between releases. Everything listed above is stable.
Data Channel (WIP)
Tool | Description |
| Append operators to a Data Channel modifier stack |
| Read the operator graph |
| Set properties on one operator |
| Add a MAXScript operator |
| List available presets |
| Load a preset into the stack |
tyFlow (WIP)
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 |
| 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 |
Forest Pack (WIP)
Tool | Description |
| Create a Forest Pack scatter with surfaces and source geometry |
RailClone (WIP)
Tool | Description |
| Read style-editor bases, segments, and parameters |
Floor plan (WIP)
Tool | Description |
| Generate a 2D floor plan from grid-based room definitions |
Standalone chat (WIP)
Experimental in-Max chat — see Advanced configuration — Standalone chat. Prefer external MCP for production use.
Tool | Description |
| Send a message to the in-Max chat and wait for the reply |
| Chat window status and model info |
| Reload config without restarting Max |
| Clear conversation history |
Scripting & diagnostics
Tool | Description |
| Run MAXScript when no dedicated tool exists (respects safe mode) |
| Call any registered tool from inside Max (testing) |
| Run live smoke cases against the bridge |
Skill & reference
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.
Further reading
Advanced configuration — architecture, safe mode, tool profiles, native builds, standalone chat (WIP)
CHANGELOG.md — release history
This server cannot be installed
Maintenance
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/cl0nazepamm/3dsmax-mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server