Report whether a compatible Blender MCP session is running and summarize it.

Reuse a compatible Blender MCP session or launch the configured Blender with the version-matched session add-on. This tool never opens a project.

Commit an active transaction, optionally save the current project, and quit Blender on the next main-thread tick.

Read the current Blender project path, dirty state, generation, transaction, and most recent lifecycle operation without requiring a 3D viewport.

Commit the active transaction and save the current project, optionally using an absolute Save As path. Existing targets are overwritten.

Open an existing absolute .blend path on the next main-thread tick. By default the current transaction is committed and dirty current project is saved.

Reload the current saved .blend file on the next main-thread tick. Unsaved changes are discarded unless save_current is true.

Check the authenticated Blender connection, versions, and UI heartbeat.

Read the active Blender mode, selection, scene, and available viewports.

Store the current user context in Blender and return a session-local token.

Restore a previously captured session-local Blender context snapshot.

Return bounded scene objects, collections, materials, images, world, active camera, and render summaries with session-local identities.

Inspect one exact Blender object without changing user context.

Return a bounded evaluated mesh summary without exposing raw vertex or face arrays.

List bounded object-local visibility, modifier, shape-key, and material-slot targets with session identities for safe preview writes.

Inspect one exact material slot and list bounded node input identities, values, ranges, links, drivers, and write eligibility.

Inspect one exact Blender image data-block, including absolute path, identity, dimensions, color space, users, and packed state.

Temporarily frame an object from a semantic view, capture the 3D editor, and restore the user's context.

Resolve a normalized image coordinate against the evaluated Blender geometry represented by a prior viewport capture.

Capture one to three consistent semantic views with before/after context and object evidence.

Capture a baseline and one to three absolute candidates for one inspected LookDev property, rolling every candidate back before returning evidence.

Begin the single reversible preview transaction for this Blender instance.

Create one uniquely named bounded primitive, empty, camera, or light in an exact collection inside the active structural transaction.

Duplicate one exact object with linked or independent object data and a unique new name inside the active structural transaction.

Unlink one exact unselected object now, restore it on rollback, or remove the object data-block when the structural transaction commits.

Atomically apply typed transform, visibility, Light, and Camera settings to one exact object inside the active transaction.

Set one or more local object scale axes to absolute values inside the active transaction.

Set absolute object viewport and/or render visibility flags inside the active transaction.

Set absolute viewport and/or render enable flags for one exact modifier inside the active transaction.

Set one exact non-Basis, non-driven mesh shape key to an absolute value inside the active transaction.

Set one exact unlinked, undriven scalar/vector/color material input inside the active transaction. Shared materials require explicit confirmation.

Create a uniquely named canonical Principled PBR material with bounded semantic surface values inside the active structural transaction.

Append, replace, or clear one exact material slot on inspected object data. Shared data requires its exact user count and explicit permission.

Load or reuse an image from an arbitrary absolute local path with a bounded color-space policy inside the active structural transaction.

Bind one exact local image through generated semantic mapping nodes to a Principled PBR channel. Existing links require an exact replacement guard.

Clear the exact inspected incoming link set from one Principled semantic channel and restore it if the structural transaction rolls back.

Create or modify the current World background and an optional exact local environment image inside the active structural transaction.

Set one exact Camera object as the active scene camera inside the structural transaction and restore the previous camera on rollback.

Render one exact Camera with temporary bounded Eevee Next settings, return PNG evidence, and restore all camera and render settings.

Render one exact Camera with bounded Eevee Next settings and overwrite an absolute PNG or EXR output path whose parent already exists.

End a transaction while retaining its changes in the current Blender session. This never saves the blend file.

Restore transaction property deltas and the captured user context.