Skip to content
Back to search

3dsmax-mcp

3ds Max MCP server

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Checked today

Check it deeper on your machine

It has changed since its scan on 11 Nov 2026.

As a Claude Code plugin, install it and then ask Claude Code:

/plugin marketplace add keithmackay/mackayi/plugin install scanskillsafety@mackayiDo a deep scan of https://github.com/cl0nazepamm/3dsmax-mcp with scanskillsafety

Or from a terminal, clone it and run it:

git clone https://github.com/keithmackay/scanskillsafety-skill ~/.claude/skills/scanskillsafetynode ~/.claude/skills/scanskillsafety/cli.cjs --deep 'https://github.com/cl0nazepamm/3dsmax-mcp'

It checks the exact commit: every file, its packages against OSV (api.osv.dev), how it compares with this page's scan (findsafeskills.com receives the repository's address), and, if you agree, Claude reading every file with your own Claude subscription. It never runs the code.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/cl0nazepamm--3dsmax-mcp/badge.svg)](/listings/cl0nazepamm--3dsmax-mcp)

HTML

<a href="/listings/cl0nazepamm--3dsmax-mcp"><img src="/api/listings/cl0nazepamm--3dsmax-mcp/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Close 3ds Max and fully exit your AI clients. 2. Run `3dsmax-mcp-1.7.2-Setup.exe` and select your clients. 3. Open 3ds Max and restart your AI client.

The installer includes Python, dependencies, native bridges and agent skills. To update, close Max and your clients, then run the new installer.

<details> <summary>Install from source</summary>

Requires [Python 3.12+](https://www.python.org/), [uv](https://docs.astral.sh/uv/) and Git. Close Max and your AI clients before installing.

git clone https://github.com/cl0nazepamm/3dsmax-mcp.git
cd 3dsmax-mcp
uv sync
uv run python install.py

Use the default **Full** tool profile. To update, run `git pull`, `uv sync`, then `uv run python install.py` again.

</details>

See [Advanced configuration](docs/ADVANCED.md) for manual client setup and tool profiles.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 408 lines

View this file on GitHub (read at the repository's current version: the scan did not record which commit it read)

This file has changed since it was scanned, so this is not exactly the text that was scanned, and no line is marked. The findings are listed with the safety scan above.

  1. # 3dsmax-mcp
  2. <p align="left">
  3. <picture>
  4. <source media="(prefers-color-scheme: dark)" srcset="./images/logo-white.png">
  5. <img src="./images/logo.png" alt="3dsmax-mcp logo" width="600">
  6. </picture>
  7. </p>
  8. Connect AI agents to Autodesk 3ds Max through the [Model Context Protocol](https://modelcontextprotocol.io).
  9. Automate everything!
  10. **Current release: 1.7.8** — see [CHANGELOG.md](docs/CHANGELOG.md).
  11. ## Features
  12. - **162 MCP tools** — For scene reads, modeling, materials, modifiers, controllers, viewport capture, procedural graphs, and plugin workflows.
  13. - **Native Bridge** — only 2023-2027 versions.
  14. - **Introspection** — discover arbitrary Max classes for all kinds of automation and scripting purposes.
  15. - **Bundled agent skill** — There is a bundled maxscript documentation if you want to create your own tools.
  16. - **FStorm materials and lights** — `FStorm`/`FStormPBR` texture import, palette laydown and smart import; create and edit plane/disc/sphere lights and suns with native solar controls.
  17. ## Requirements
  18. - Windows and Autodesk **3ds Max 2023–2027**
  19. - An MCP client, such as Claude Desktop, Codex or Cursor
  20. ## Quick start
  21. 1. Close 3ds Max and fully exit your AI clients.
  22. 2. Run `3dsmax-mcp-1.7.8-Setup.exe` and select your clients.
  23. 3. Open 3ds Max and restart your AI client.
  24. The installer includes Python, dependencies, native bridges and agent skills.
  25. To update, close Max and your clients, then run the new installer.
  26. <details>
  27. <summary>Install from source</summary>
  28. Requires [Python 3.12+](https://www.python.org/), [uv](https://docs.astral.sh/uv/) and Git.
  29. Close Max and your AI clients before installing.
  30. ```powershell
  31. git clone https://github.com/cl0nazepamm/3dsmax-mcp.git
  32. cd 3dsmax-mcp
  33. uv sync
  34. uv run python install.py
  35. ```
  36. Use the default **Full** tool profile. To update, run `git pull`, `uv sync`, then
  37. `uv run python install.py` again.
  38. </details>
  39. See [Advanced configuration](docs/ADVANCED.md) for manual client setup and tool profiles.
  40. ## Some ideas for you
  41. <details>
  42. <summary>Explore modeling, materials, and workflow ideas</summary>
  43. ### Modeling
  44. **Build editable meshes from a reference**<br>
  45. Create polygon cages, sweeps, and lofts, then refine their components and check topology.<br>
  46. Tools: `create_mesh`, `curve_model`, `loft_mesh`, `mesh_edit`, `geometry_qa`, `contact_check`
  47. ### Materials
  48. **Turn texture folders into a palette**<br>
  49. Preview textures or build PBR sets in the Material Editor, with filters and library overflow.<br>
  50. Tool: `palette_laydown`
  51. **Save your material scratchpad**<br>
  52. Back up Material Editor slots and the current material library to reusable `.mat` files.<br>
  53. Tools: `get_material_library`, `backup_material_library`
  54. **Create custom materials and textures**<br>
  55. Wire PBR texture sets, tune material properties, or write procedural OSL textures.<br>
  56. Tools: `create_material_from_textures`, `assign_material`, `set_material_properties`, `create_texture_map`, `write_osl_shader`
  57. **Make material variants**<br>
  58. Clone a material graph, remap its textures, and replace materials across the scene.<br>
  59. Tools: `inspect_material_network`, `replicate_material`, `batch_replace_materials`
  60. ### Asset workflows
  61. **Browse an asset library in your scene**<br>
  62. Batch-import a folder into a grid, filter LODs, and assign matching PBR textures.<br>
  63. Tool: `smart_import`
  64. **Reuse objects from old scenes**<br>
  65. Search `.max` files, inspect their contents, and merge just the objects you need.<br>
  66. Tools: `search_max_files`, `batch_file_info`, `inspect_max_file`, `merge_from_file`
  67. **Move assets between applications**<br>
  68. Import mesh, CAD, USD, and glTF assets through installed importers. Export through MAXScript and installed exporters, with separate render/export materials where needed.<br>
  69. Tools: `smart_import`, `execute_maxscript`, `create_shell_material`, `manage_scene`
  70. ### Custom tools
  71. **Build your own tools**<br>
  72. Automate repetitive work with MAXScript, or build procedural geometry and modifiers with Max Creation Graph (MCG). Explore installed classes through introspection and build, compile, and test graphs with the `mcg_*` tools.
  73. </details>
  74. ## Tools
  75. <details>
  76. <summary>Browse the full tool catalog</summary>
  77. ### Bridge & session
  78. | Tool | Description |
  79. |------|-------------|
  80. | `get_bridge_status` | Bridge health: whether Max is responsive, busy or hung and what holds its main thread; answers while Max is hung |
  81. | `get_session_context` | Bundle bridge status, capabilities, scene summary, and selection in one call |
  82. | `get_plugin_capabilities` | Max version, renderers, installed plugins, and class counts |
  83. ### Scene state & transactions
  84. | Tool | Description |
  85. |------|-------------|
  86. | `query_scene` | Unified reads: `overview`, `filter`, `class`, `property`, `selection`, `delta` |
  87. | `resolve_node_refs` | Resolve names, handles, or hierarchy paths to canonical, cross-checked NodeRefs |
  88. | `scene_qa` | Scan scene-graph hygiene and apply explicit safe naming repairs; never analyzes meshes |
  89. | `scene_patch` | Preflight and atomically apply up to 256 mechanical node edits in one native undo step |
  90. | `get_hierarchy` | Recursive child tree for an object |
  91. | `get_instances` | All instances sharing the same base object |
  92. | `get_dependencies` | Reference graph via dependents / dependent nodes |
  93. ### Objects
  94. | Tool | Description |
  95. |------|-------------|
  96. | `create_object` | Create geometry with spatial placement feedback |
  97. | `delete_objects` | Delete objects by name |
  98. | `get_object_properties` | Compact properties for one object |
  99. | `set_object_property` | Set a single object property |
  100. | `transform_object` | Move, rotate, and/or scale by offset |
  101. | `analyze_node_orientation` | Pivot, bbox, local axes, and world matrix for rigging and placement |
  102. | `clone_objects` | Copy, instance, or reference clones |
  103. | `set_parent` | Parent or unparent objects |
  104. | `select_objects` | Change the current selection |
  105. | `set_visibility` | Show, hide, freeze, or unfreeze |
  106. | `batch_rename_objects` | Rename many objects in one call |
  107. ### Modifiers
  108. | Tool | Description |
  109. |------|-------------|
  110. | `add_modifier` | Add a modifier to an object |
  111. | `remove_modifier` | Remove a modifier by name |
  112. | `set_modifier_state` | Enable/disable with viewport/render granularity |
  113. | `set_modifier_property` | Set a modifier parameter on one or many objects |
  114. | `collapse_modifier_stack` | Collapse the stack |
  115. | `make_modifier_unique` | De-instance a shared modifier |
  116. ### Modeling
  117. | Tool | Description |
  118. |------|-------------|
  119. | `curve_model` | Named curves, rounded profiles, sweeps and quad lofts with controls saved in the scene |
  120. | `inspect_curve` / `edit_curve` | Inspect, visually target and edit spline knots and handles with stale-token protection |
  121. | `create_mesh` | Build editable polygon cages from explicit vertices and faces |
  122. | `inspect_mesh` / `pick_component` | Read cage geometry, label components and map image positions to edit targets |
  123. | `mesh_edit` | Undoable vertex, edge and face edits that preserve the modifier stack |
  124. | `loft_mesh` | Matched-section quad lofts with persistent numeric parameters |
  125. | `geometry_qa` | Check mesh boundaries, winding, degeneracy and connected components |
  126. | `contact_check` | Find parts that pass through each other, touch, or float just short of contact |
  127. | `boolean_operation` | Apply, inspect, retune, rename, or extract Boolean modifier operands; supports inline repeated cutters |
  128. | `draw_spline` | Create, read, and edit spline shapes from explicit world-space points and knots |
  129. | `edit_vertices` | Read, move, set, or conform Editable Poly vertices in world space |
  130. ### Materials & textures
  131. | Tool | Description |
  132. |------|-------------|
  133. | `get_materials` | List materials assigned in the scene |
  134. | `get_material_library` | Inspect `currentMaterialLibrary` and Material Editor scratch slots |
  135. | `backup_material_library` | Save temporary/scratch material libraries to `.mat` files |
  136. | `get_material_slots` | Compact slot/property readback for a material |
  137. | `inspect_material_network` | Semantic material graph, wired slots, texture manifest, health checks |
  138. | `material_roles` | Texture sources per material slot, including shared maps, composites and submaterials; advisory filename mismatches and missing files; flags maps whose file path can't be read |
  139. | `replicate_material` | Preview/apply structure-preserving material clone and texture remap |
  140. | `assign_material` | Create a material and assign it to objects |
  141. | `set_material_property` | Set one property on an object's material |
  142. | `set_material_properties` | Set multiple material properties at once |
  143. | `set_sub_material` | Create or assign a Multi/Sub-Object slot |
  144. | `create_texture_map` | Create a texture map (stored as a MAXScript global) |
  145. | `set_texture_map_properties` | Edit a texture map global |
  146. | `create_material_from_textures` | Build a fully wired PBR material from texture files |
  147. | `create_shell_material` | Wrap any render + export materials in Shell Material (dual pipeline) |
  148. | `write_osl_shader` | Write OSL to disk and compile an OSLMap |
  149. | `replace_material` | Put a source material wherever a target is used, on objects and in sub-material slots; the source can come from a slot, the Material Editor or the material library |
  150. | `batch_replace_materials` | Batch material replacement |
  151. | `palette_laydown` | Fill Material Editor palette slots from a texture folder |
  152. | `smart_import` | Batch-import meshes from a folder with auto PBR assignment |
  153. | `cosmos_search` | Find compatible Cosmos models, materials and HDRIs |
  154. | `cosmos_download` | Download a Cosmos asset without importing it |
  155. | `cosmos_import` | Import a Cosmos asset through Corona or V-Ray |
  156. ### Inspection
  157. | Tool | Description |
  158. |------|-------------|
  159. | `inspect_object` | Deep exploratory object summary |
  160. | `inspect_properties` | Deep property dump (`target="object"|"modifier"|"baseobject"|"material"`) |
  161. | `introspect_osl` | API surface for OSLMap and shader classes |
  162. | `walk_references` | Full reference dependency walk |
  163. | `learn_scene_patterns` | Analyze class usage patterns in the live scene |
  164. | `map_class_relationships` | ParamBlock2 reference relationships between classes |
  165. | `watch_scene` | Live event watcher for interactive sessions |
  166. | `isolate_and_capture_selected` | Per-selection isolated viewport captures |
  167. | `main_thread` | Inspect or clean up callbacks and timers running on Max's main/UI thread |
  168. | `max_dialogs` | Read any dialog blocking Max (Win32 or Qt) and press a chosen button, even while a tool call waits on it, on Max's main thread |
  169. ### Plugins & introspection
  170. | Tool | Description |
  171. |------|-------------|
  172. | `discover_plugin_surface` | Find plugin-related classes and entry points |
  173. | `discover_plugin_classes` | Enumerate registered SDK classes |
  174. | `list_plugin_classes` | List classes for a plugin or superclass family |
  175. | `inspect_plugin_class` | SDK schema v2: bounded metadata, exact bindings and enum sources; legacy reflection retained |
  176. | `inspect_plugin_constructor` | Creation notes for a plugin class |
  177. | `inspect_plugin_instance` | SDK schema v2: live values, linked maps and guarded edit tokens |
  178. | `plugin_patch` | Atomic typed PB2 edits with readback and stale/shared/animation guards |
  179. | `get_plugin_manifest` | Structured manifest (classes, workflows, gotchas), rebuilt from the live runtime on each call |
  180. | `introspect_class` | SDK parameter descriptors and published interface metadata |
  181. | `introspect_instance` | Deep SDK introspection with live values |
  182. MCP resources: `resource://3dsmax-mcp/plugins/{name}/manifest|guide|recipes|gotchas`
  183. ### Lighting
  184. | Tool | Description |
  185. |------|-------------|
  186. | `lighting_capabilities` | Installed renderer routes, emitter shapes, units and color policy |
  187. | `create_lights` | Semantic lights and environment graphs in one verified native transaction |
  188. | `inspect_lights` | Decode actual light settings and linked emission maps |
  189. | `edit_lights` | Guarded color, output, size, enable and shadow edits |
  190. Providers cover Corona, V-Ray, Octane and native photometric emitters. Query capabilities
  191. for the current renderer: shapes, units and environment routes differ. HDRI maps
  192. and existing procedural skies use the provider's dome or environment binding.
  193. ### Controllers & animation
  194. | Tool | Description |
  195. |------|-------------|
  196. | `assign_controller` | Create and assign a controller to a sub-anim track |
  197. | `script_controller` | Inspect, validate and apply scripts with typed inputs, frame checks and rollback |
  198. | `inspect_controller` | Inspect one controller track |
  199. | `inspect_track_view` | Track View-style controller hierarchy |
  200. | `set_controller_props` | Edit script text or controller properties |
  201. | `add_controller_target` | Add a target to script/expression/constraint controllers |
  202. | `keyframe_tracks` | Timeline control; bounded delete/move/scale, bake/resample, tangent normalization, pose matching, and loops |
  203. ### Parameter wiring
  204. | Tool | Description |
  205. |------|-------------|
  206. | `list_wireable_params` | Discover wireable sub-anims on an object |
  207. | `wire_params` | Connect parameters with a wire expression |
  208. | `get_wired_params` | List existing wire connections |
  209. | `unwire_params` | Remove a wire |
  210. ### Organization
  211. | Tool | Description |
  212. |------|-------------|
  213. | `manage_layers` | Create, delete, list, and configure layers; move/select objects |
  214. | `manage_groups` | Create, ungroup, open, close, attach, detach groups |
  215. | `manage_selection_sets` | Named selection sets |
  216. | `manage_scene` | Hold, fetch, reset, save, scene info |
  217. | `undo_last` | Undo the last 3ds Max scene operation |
  218. ### Viewport & render
  219. | Tool | Description |
  220. |------|-------------|
  221. | `agent_viewport` | Independent floating agent view, visual targeting and V-Ray preview controls |
  222. | `set_viewport` | Position and frame the agent or user viewport |
  223. | `capture_viewport` | Capture the agent or user viewport as an image |
  224. | `capture_multi_view` | Capture several views into one image, with agent-view restoration |
  225. | `capture_screen` | Capture visible desktop pixels or crop to the V-Ray frame buffer |
  226. | `render_scene` | Render the current view |
  227. | `render_automations` | Arm/poll completion signals, request cancellation or capture a progressive render before cancelling |
  228. ### External `.max` files
  229. | Tool | Description |
  230. |------|-------------|
  231. | `inspect_max_file` | Read metadata and object names without loading |
  232. | `merge_from_file` | Selective merge with duplicate handling |
  233. | `search_max_files` | Scan a folder for objects matching a pattern |
  234. | `batch_file_info` | Parallel metadata from many `.max` files |
  235. ### Effects & state sets
  236. | Tool | Description |
  237. |------|-------------|
  238. | `get_effects` | List atmospheric and render effects |
  239. | `toggle_effect` | Enable or disable an effect by index |
  240. | `delete_effect` | Remove an effect by index |
  241. | `get_state_sets` | State Sets with camera assignments |
  242. | `get_camera_sequence` | Camera-assigned State Sets sorted by frame |
  243. ### Data Channel
  244. | Tool | Description |
  245. |------|-------------|
  246. | `list_dc_operators` | Search the live version-specific operator catalog |
  247. | `list_dc_presets` | List installed Data Channel presets |
  248. | `add_data_channel` | Append operators to a Data Channel modifier stack |
  249. | `inspect_data_channel` | Read the active stack in visible processing order |
  250. | `set_data_channel_operator` | Edit one visible operator with rollback on failure |
  251. | `manage_data_channel_stack` | Delete, enable, disable, or safely reorder operators |
  252. | `load_dc_preset` | Load a preset into the stack |
  253. | `add_dc_script_operator` | Add executable MAXScript with explicit authorization |
  254. ### Max Creation Graph
  255. | Tool | Description |
  256. |------|-------------|
  257. | `mcg_get_context` | Compiler, temporary workspace, templates, samples, and safety state |
  258. | `mcg_list_graphs` | List temporary, installed, or bundled sample graphs |
  259. | `mcg_inspect_graph` | Normalize graph metadata, nodes, connections, and parameters |
  260. | `mcg_search_operators` | Search live typed operators and offline compound references |
  261. | `mcg_create_graph` | Fork a read-only source into the temporary workspace |
  262. | `mcg_apply_patch` | Patch, compile, verify, checkpoint, and roll back transactionally |
  263. | `mcg_compile_graph` | Validate and compile one temporary graph with diagnostics |
  264. | `mcg_test_tool` | Create, inspect, and remove a disposable generated instance |
  265. | `mcg_resolve_class` | Resolve the exact generated modifier class descriptor |
  266. | `mcg_apply_modifier` | Compile and apply a typed MCG modifier safely |
  267. | `mcg_inspect_instance` | Verify graph identity and inspect a live MCG modifier |
  268. | `mcg_set_node_parameter` | Retarget one supported scalar node parameter |
  269. | `mcg_restore_checkpoint` | Restore an opaque checkpoint with hash protection |
  270. | `mcg_cleanup_workspace` | Remove one graph family or the temporary MCG workspace |
  271. | `mcg_reload_operators` | Explicitly refresh Max's global MCG operator depot |
  272. ### tyFlow
  273. | Tool | Description |
  274. |------|-------------|
  275. | `create_tyflow` | Create tyFlow with an event and operators, or a preset: rain, snow, fountain, burst, debris |
  276. | `get_tyflow_info` | Deep flow/event/operator readback |
  277. | `harvest_tyflow_manifest` | Probe and cache the installed tyFlow operator surface by tyFlow version |
  278. | `list_tyflow_operators` | Query the cached manifest, including per-type availability, without touching Max |
  279. | `get_tyflow_graph` | Read events, operators, properties, ledger edges, and wiring staleness |
  280. | `tyflow_apply_patch` | Apply a batch of tyFlow graph operations as one verified transaction |
  281. | `connect_tyflow_operator` | Connect or retarget a test/Send Out operator to an event, optionally creating the Send Out |
  282. | `disconnect_tyflow_operator` | Disconnect an operator output and remove its ledger edge |
  283. | `set_tyflow_wiring_ledger` | Reconcile recorded graph wiring after external or visual edits |
  284. | `tyflow_event_census` | Count particles per event at probe frames with temporary instrumentation |
  285. | `capture_tyflow_editor` | Open and capture the tyFlow editor for visual wire inspection |
  286. | `modify_tyflow_operator` | Edit operator properties |
  287. | `set_tyflow_shape` | Configure Shape operator |
  288. | `set_tyflow_physx` | Object-level PhysX settings |
  289. | `add_tyflow_collision` | Collision operator + collider list |
  290. | `add_tyflow_event` | Add an event |
  291. | `remove_tyflow_element` | Remove operator or event |
  292. | `get_tyflow_particle_count` | Particle count at a frame |
  293. | `get_tyflow_particles` | Particle data rows |
  294. | `reset_tyflow_simulation` | Reset one or all tyFlow sims |
  295. ### RailClone (1.7.2)
  296. | Tool | Description |
  297. |------|-------------|
  298. | `get_railclone_style` | Read complete style XML and edit token (RailClone 7.3.5+) |
  299. | `set_railclone_style` | Replace style XML with guarded, undoable adoption |
  300. | `get_railclone_output` | Read generated segments, transforms, bounds, and tags |
  301. ### Forest Pack (WIP)
  302. > **Work in progress** — the Forest Pack integration is early-stage and may be incomplete or change between releases.
  303. | Tool | Description |
  304. |------|-------------|
  305. | `scatter_forest_pack` | Create a Forest Pack scatter with surfaces and source geometry |
  306. ### Scripting & diagnostics
  307. | Tool | Description |
  308. |------|-------------|
  309. | `execute_maxscript` | Run MAXScript when no dedicated tool exists (respects safe mode); scripts that reset, open, fetch or quit keep the save prompt |
  310. | `execute_python` | Run Python with captured output, JSON results, tracebacks and undo rollback (requires safe mode off) |
  311. | `invoke_tool` | Call any registered tool from inside Max (testing) |
  312. | `capture_hang_diagnostics` | Capture native thread stacks of a hung Max from the OS, without contacting it |
  313. </details>
  314. ---
  315. ## Skill & reference
  316. 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](docs/ADVANCED.md#agent-skill).
  317. ## Further reading
  318. - **[Contributing](CONTRIBUTING.md)** — development, validation, and pull requests
  319. - **[Advanced configuration](docs/ADVANCED.md)** — architecture, safe mode, tool profiles, native builds
  320. - **[CHANGELOG.md](docs/CHANGELOG.md)** — release history
  321. - **[LICENSE](LICENSE)**

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.