Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
MAX_MCP_KEYNoShared key; setting this environment variable implies key_enabled is true.
MAX_MCP_HOSTNoListener bind address.127.0.0.1
MAX_MCP_PORTNoListener TCP port.30025
MAX_MCP_CONFIGNoOverride path for the max-mcp config.json file.
MAX_MCP_AI_UNDONoWhether the max_undo tool may run.true
MAX_MCP_PUMP_MSNoMain-thread pump interval in milliseconds.50
MAX_MCP_TIMEOUTNoSeconds a call may wait for 3ds Max.60
MAX_MCP_AUTOSTARTNoStart the listener with 3ds Max (requires the loader).true
MAX_MCP_HTTP_HOSTNoStreamable-HTTP bind host.127.0.0.1
MAX_MCP_HTTP_PORTNoStreamable-HTTP bind port.30026
MAX_MCP_HISTORY_MAX_MBNohistory.jsonl size in MB before rotation.5
MAX_MCP_CHECKPOINT_MODENoCheckpoint mode: off, changing, or all.off
MAX_MCP_CHECKPOINT_MAX_MBNoMaximum total size in MB for checkpoint copies.2048
MAX_MCP_CHECKPOINT_MAX_COUNTNoMaximum number of checkpoint copies retained.10

Instructions

Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.

This server publishes no instructions, or was last inspected before Glama recorded them.

Capabilities

Features and capabilities supported by this server

Protocol revision2025-11-25

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
max_infoA

Check the connection and return Max version, open scene path, dirty flag, units, object/selection counts, renderer and listener status.

max_selectionB

List the currently selected objects (name, class, layer, position; with detail=True also bbox, transform, parent, material, user properties).

max_query_objectsB

Find scene objects. name_pattern is a MAXScript wildcard ('Wall_*', 'door', case-insensitive); class_name matches classOf (e.g. 'Editable_Poly', 'Box'); layer matches the layer name. detail=True adds bbox, transform, material, user properties.

max_layersA

List all layers with hidden/frozen/current flags and object counts.

max_set_layer_hiddenA

Hide (hidden=True) or show (hidden=False) a layer by name. Undoable.

max_viewport_captureA

Grab the active viewport to a PNG file and return its path and size. path defaults to %TEMP%/max-mcp/capture_.png. max_size limits the longer edge (0 = keep the viewport resolution).

max_run_maxscriptA

Execute MAXScript inside Max and return the value of the last expression. (format/print output goes to Max's Listener window; return values instead.) undo=True wraps the code in an undo record.

max_run_pythonB

Execute Python (Max's own 3.11 with pymxs) inside Max. rt (pymxs.runtime) and pymxs are predefined. A single expression returns its value; for multi-line code assign to result. print() output is returned too.

max_historyA

Read the bridge's command history (time, client, tool, summary, duration, ok/error, objects added/removed, selection, undo_state). undo_state is 'on_stack' (max_undo can target it), 'undone' or 'gone'. full=True includes complete args and output.

max_undoA

Undo the bridge's OWN scene changes: either the last steps undo records or everything down to and including history entry to_history_id. Only records labelled 'MCP: #' are undone; if a user's manual step sits in between the call is refused and names it (the user can revert past it from the settings window). Fails when the target has left the undo stack or when AI undo is disabled in the settings window.

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A3.7/5.0

Scored across 10 tools

Disambiguation5/5

Each tool targets a distinct resource or action: scene info, layers, selection, object querying, layer visibility, viewport capture, MAXScript execution, Python execution, history, and undo. The two execution tools are clearly separated by language, and query vs. selection tools are distinguished by scene-wide filtering vs. current selection. No pair appears to do the same thing.

Naming Consistency4/5

All names share the max_ prefix and use snake_case, which makes the set predictable. However, some tools are noun-based (max_layers, max_info, max_selection, max_history) while others are verb-based (max_query_objects, max_set_layer_hidden, max_run_maxscript), so the pattern is not fully uniform.

Tool Count5/5

Ten tools is a well-scoped set for a 3ds Max bridge: it covers introspection, selection/query, layer visibility, viewport capture, scripting escape hatches, history, and undo. Each tool has a clear role, and the count avoids both thinness and bloat.

Completeness4/5

The surface covers core bridge operations well, including scene introspection, object discovery, viewport capture, arbitrary MAXScript/Python execution, command history, and undo. Dedicated tools for common lifecycle actions such as scene save/open, render/export, or direct object creation/transformation are absent, though the scripting tools provide workarounds.

Maintenance

ActivityMaintained
ResponsivenessNo issues