Check the local connection and supported bridge version without changing the project.

Inspect objects, triangle counts, materials, layers, assets, current selection, and project path.

List material node types with socket and button schemas, and installed export presets. Query this before building node graphs.

Create a new project. Save the current project before discarding it.

Open an existing .arm project. Save the current project first.

Save the project to an absolute .arm path, optionally packing imported assets. Existing files require overwrite=true.

Import a UV-mapped OBJ or supported Blender mesh. Replacement can clear the current layers; use append mode to preserve geometry.

Import an image into the project's texture assets. Returns the updated asset list.

Resize the project's texture maps. Larger maps increase GPU memory use.

Select a mesh by the zero-based index returned by get_state.

Rename or show/hide a mesh object.

Create and select a named PBR material.

Select a material by its stable ID.

Delete a material. The final material cannot be deleted.

Set constant PBR channel values, disconnecting existing links to those channels. Color uses RGBA values in the ArmorPaint material UI.

Read a material's nodes, socket values, buttons, and connections. material_id=-1 uses the current material.

Add a material node using a type returned by list_node_types. Returns the graph including the new node ID.

Disconnect the incoming link to a material node input socket.

Import an ArmorPaint .arm material library into the current project.

Remove a material node and its links. The PBR output node is protected.

Connect an output socket to an input socket, replacing any previous connection to that input.

Set a node input, output, or button value. The numeric array must have the length reported by get_material_graph.

Create a paint layer, material fill, mask, or group. Masks require a parent layer ID. UV modes: 0=UV map, 1=triplanar, 2=projection.

Bake a mesh map to PNG using ArmorPaint. Types: 0=curvature, 1=tangent normal, 2=object normal, 3=height, 4=derivative, 5=position, 6=UV, 7=material ID, 8=object ID, 9=vertex color, 10=AO, 11=lightmap, 12=bent normal, 13=thickness. Types 1/3/4 require a high-poly object index; 10–13 require ray tracing. Use a regular paint layer. Import the exported image for persistent reuse.

Enable or disable individual PBR channels on a paint or fill layer.

Select a layer by stable ID.

Edit a layer. object_mask=0 affects all objects; index+1 restricts it to one object. Opacity ranges from zero to one.

Duplicate, delete, merge, reorder, or convert a layer; apply or invert masks. Save a checkpoint before merging or deleting.

Replace a paint layer's pixels with uniform color and packed PBR values. RGBA components range from zero to one.

Paint the selected material over an entire paint layer, respecting object masks.

Paint one continuous stroke. Screen points use normalized viewport coordinates; world points use XYZ and are projected through the current camera. Hidden surfaces require another camera view.

Import a grayscale image as a mask for a paint or fill layer. White reveals the layer; black hides it.

Orbit the camera by yaw/pitch radians, move forward by zoom units, or reset its view. projection: 0=perspective, 1=orthographic.

Set viewport channel: 0=lit, 1=base color, 2=normal, 3=AO, 4=roughness, 5=metallic, 6=opacity, 7=height, 8=emission, 10=UV, 14=mask, 15=path traced.

Capture the rendered 3D viewport as a PNG and return it as an MCP image for visual inspection.

Export one layer's base color/mask, normal, or packed occlusion-roughness-metallic texture to a PNG file.

Export the visible layer stack as PNG PBR maps using an installed preset. Get exact preset names from list_node_types.

Export the current mesh to an OBJ file.

Export a material as an ArmorPaint material file.

Undo the most recent operation recorded by ArmorPaint history. Not every operation is covered; checkpoints protect whole workflows.

Redo the most recently undone operation.