Is Blender's MCP addon socket reachable right now?

Launch Blender (optionally opening blend_file) and wait until the addon socket answers.

No-op if it is already up. Finds blender.exe in Program Files or via $BLENDER_EXE.

Quit Blender. Refuses when the file has unsaved changes unless force=True (which kills it).

Summary of the open Blender scene (objects, counts, active camera).

Transform, dimensions, materials and mesh stats for one object.

Run Python inside Blender (bpy available). The reply is the code's stdout: use print().

Executes arbitrary code in the user's Blender session. Keep edits reproducible: record meaningful changes in your build scripts, not only in the live scene.

Screenshot of the Blender 3D viewport (needs the Blender UI open). Returns an image.

Render evenly spaced turntable views of all visible meshes; returns the images. View 0 = front (-Y).

mode: material (scene materials + temporary offset key light of strength light), solid (Workbench, fast), wireframe (Cycles on CPU), normal (world-space), mask (alpha silhouette). solid and wireframe skip the GPU guard. The scene is restored. Refuses to render while ComfyUI is running a job or VRAM is low, unless ignore_gpu_guard=True.

Render explicit camera views: views=[{"az": degrees, "el": degrees}, ...] (az 0 = front/-Y, +az toward +X, el = elevation). objects limits the framed/rendered meshes; ortho=True gives an orthographic camera. focus={"center": [x, y, z], "radius": r} frames that world-space region (e.g. the head of a full body). Modes as in blender_turntable. Returns the images.

Render through the scene's OWN active camera and lights (shot rendering), one image per frame. mode: beauty | mask (needs objects: only they are drawn, white, silhouette in alpha) | normal. hide hides objects for this render (e.g. actors -> clean background plate). Returns the images.

Import a GLB/glTF/FBX into the open scene. Returns new objects, triangle count and dimensions (x,y,z in m).

Export to a .glb. With objects, only those; otherwise the whole scene.

Open a .blend (replaces the current scene; unsaved changes are lost).

Save the current file, or save as path when given.

Remove all objects (orphan data purged). keep: object types to keep, e.g. ["CAMERA", "LIGHT"].

Run the asset validator (dims within tol of height_m, tri budget, NaN, zero-area faces, non-manifold, PBR maps). With asset_json also cross-checks the sidecar. Needs ASSET_VALIDATOR_PY (see README).

Bones (name, parent, head/tail in rest pose) of an armature and the meshes bound to it.

Set local Euler rotations (degrees) on pose bones: rotations={"bone": [x, y, z]}. reset=True clears other bones first. Use blender_reset_pose afterwards to go back to rest.

Pose by direction, no bone-axis knowledge needed: aim={"RightArm": [1, 0, 0.2], "Spine": [0, 0, 1]} points each bone's limb (its head to the head of its continuing child, not the bone tail) along that WORLD direction, parents first. Returns the residual angle per bone in degrees. Prefer this over blender_set_pose for authoring poses.

Keyframe the current pose of the armature at frame (all bones, plus the object's location/rotation). Workflow for a clip: blender_timeline(frame=f) -> blender_pose_aim(...) -> blender_key_pose(frame=f), repeat.

Set the frame range / fps and/or jump to a frame (which evaluates existing keyframes).

Return all pose bones of the armature to the rest pose.

Deformation metrics of the CURRENT pose vs rest: face-area ratio percentiles, fraction of faces stretched >2x or squashed <0.4x, volume ratio (volume loss = candy-wrapper joints), and the number of vertices with zero skin weight.

Range-of-motion test: for each pose apply it, measure deformation and render. Returns a JSON report followed by one image per pose; the rig is reset to rest afterwards.

poses={"name": {"bone": [x, y, z]}} in degrees. Default is a Mixamo-named table whose rotation axes are NOT calibrated: check the images and pass your own poses if they look wrong.

Coarse likeness check: silhouette IoU between an orthographic render of the model (from azimuth/ elevation) and a reference image (alpha, or plain background). Both are cropped to their bounding boxes, so position/scale are ignored; aspect_ratio_diff reports proportion mismatch. Returns JSON and an overlay image (red = reference only, green = render only, yellow = both).