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.6 — 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.

Requirements

• Python 3.10+
• uv
• 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.py

Restart 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.py

Tools

Bridge & session

Tool	Description
get_bridge_status	Ping the MCP bridge when diagnosing connection errors
get_session_context	Bundle bridge status, capabilities, scene summary, and selection in one call
get_plugin_capabilities	Max version, renderers, installed plugins, and class counts

Scene query

Tool	Description
query_scene	Unified reads: overview, filter, class, property, selection, delta
get_hierarchy	Recursive child tree for an object
get_instances	All instances sharing the same base object
get_dependencies	Reference graph via dependents / dependent nodes

Objects

Tool	Description
create_object	Create geometry with spatial placement feedback
delete_objects	Delete objects by name
get_object_properties	Compact properties for one object
set_object_property	Set a single object property
transform_object	Move, rotate, and/or scale by offset
analyze_node_orientation	Pivot, bbox, local axes, and world matrix for rigging and placement
clone_objects	Copy, instance, or reference clones
set_parent	Parent or unparent objects
select_objects	Change the current selection
set_visibility	Show, hide, freeze, or unfreeze
batch_rename_objects	Rename many objects in one call

Modifiers

Tool	Description
add_modifier	Add a modifier to an object
remove_modifier	Remove a modifier by name
set_modifier_state	Enable/disable with viewport/render granularity
set_modifier_property	Set a modifier parameter on one or many objects
collapse_modifier_stack	Collapse the stack
make_modifier_unique	De-instance a shared modifier

Materials & textures

Tool	Description
get_materials	List materials assigned in the scene
get_material_slots	Compact slot/property readback for a material
inspect_material_network	Semantic material graph, wired slots, texture manifest, health checks
replicate_material	Preview/apply structure-preserving material clone and texture remap
assign_material	Create a material and assign it to objects
set_material_property	Set one property on an object's material
set_material_properties	Set multiple ma

... View full README on GitHub