Stereograph
Connects an MCP client to Blender (live or as a background process) for scene inspection, editing, workspace navigation, screenshots, rendering, documentation lookup, and trusted Python execution, plus read-only evaluated-geometry queries, contact and containment checks, and frame sampling.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Stereograph render a screenshot of the current viewport in my open Blender scene"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Stereograph connects an MCP client to Blender for scene inspection, documentation lookup, workspace navigation, screenshots, rendering, spatial inspection, motion contact review, rig inspection, clothing and armour review, and bounded elbow, knee and cloth edits. It can open a specified file in background Blender for inspection, rendering, and trusted Python execution. Start with the connection guide and Blender Lab compatibility matrix.
Roadmap
Milestone | Deliverable |
0.1 · Connection and execution | Connect a local MCP client to live and background Blender. Verify version reporting, structured errors, timeouts and recovery on disposable scenes. |
0.2 · Blender Lab parity | Qualify the standard tool set against Blender Lab MCP 1.0.3. Record the live and headless support for each tool. |
0.3 · Comparative qualification | Run both servers against the same fixtures and compare correctness, reliability, latency and recovery. |
0.4 · Spatial inspection | Add read-only evaluated-geometry queries, contact and containment checks, frame sampling, and matched viewport evidence. |
0.5 · Rig-aware pose editing | Preview, verify, and apply an FK elbow edit with a planted hand and native Blender Undo. |
0.6 · Contact and motion review | Check phase-specific contact across an animation, inspect exact witnesses, and compare revisions. |
0.7 · Rig inspection and repair | Check rest joints, skin weights and sampled motion, and repair knee tracking with a planted foot. |
0.8 · Clothing and armour fit | Inspect layered garment dependencies, seams and local strain. Preview and apply a bounded, undoable cloth corrective. |
GitHub milestones · Tool parity checklist · Architecture and acceptance gates · Benchmark method · Spatial inspection guide · Elbow editing guide · Motion review guide · Rig inspection guide
Related MCP server: Bonsai MCP
Development and releases
The server and Blender add-on are independently written. Blender Lab is the behavioural reference for the standard tool set, and Blender supplies native scene evaluation, geometry, animation and rendering.
Contributing · Changelog · Release process · GitHub releases
Maintained by Ion Cascade, the team behind Conductor for Apple Logic Pro. Attribution · MIT licence
Available Tools
42 toolsapply_cloth_correctiveB
Recheck and apply a still-current live corrective with native Blender Undo.
Inputs: candidate_id (required), expected_session (required), timeout. Returns: object
apply_elbow_editB
Apply a verified live preview as an undoable Action variant at its original frame.
Inputs: candidate_id (required), expected_session (required), timeout. Returns: object
apply_knee_repairB
Apply a still-current preview in an undoable Action variant after rechecking its constraints.
Inputs: candidate_id (required), expected_session (required), timeout. Returns: object
blender_healthBRead-only
Read Blender's live session ID, file, scene, version and Python availability.
Inputs: timeout. Returns: object
cancel_cloth_correctiveC
Discard a live cloth corrective preview.
Inputs: candidate_id (required), expected_session (required). Returns: object
cancel_elbow_editA
Discard an unused live preview without editing the pose or the Action.
Inputs: candidate_id (required), expected_session (required). Returns: object
cancel_knee_repairC
Discard a live knee preview.
Inputs: candidate_id (required), expected_session (required). Returns: object
compare_motion_reviewsCRead-only
Compare two motion review data reports from the same profile.
The delivered comparison counts only matching rule and frame samples as verified. Replay missing sample times with extra_frames. Drop evidence from the input if needed.
Inputs: after (required), before (required). Returns: object
execute_blender_codeBDestructive
Run trusted Python on Blender's main thread for the session confirmed by blender_health.
Inputs: code (required), expected_session (required), timeout. Returns: object
execute_blender_code_for_cliBDestructive
Run trusted Python in a fresh background Blender process on the specified blend file.
Inputs: code (required), blend_file (required), timeout. Returns: object
get_blendfile_summary_datablocksARead-only
Summarize datablock counts, scene, workspace and render engine.
Inputs: no named parameters. Returns: object
get_blendfile_summary_datablocks_for_cliARead-only
Summarize datablock counts, scene, workspace and render engine. Open blend_file in background Blender.
Inputs: blend_file (required). Returns: object
get_blendfile_summary_missing_filesBRead-only
Find missing external file references used by the blend file.
Inputs: no named parameters. Returns: object
get_blendfile_summary_missing_files_for_cliBRead-only
Find missing external file references used by the blend file. Open blend_file in background Blender.
Inputs: blend_file (required). Returns: object
get_blendfile_summary_of_linked_librariesARead-only
List the file's direct and indirect Blender library dependencies.
Inputs: no named parameters. Returns: object
get_blendfile_summary_of_linked_libraries_for_cliBRead-only
List the file's direct and indirect Blender library dependencies. Open blend_file in background Blender.
Inputs: blend_file (required). Returns: object
get_blendfile_summary_path_infoARead-only
Report save status, path, size, age and numbered backups for the blend file.
Inputs: no named parameters. Returns: object
get_blendfile_summary_path_info_for_cliBRead-only
Report save status, path, size, age and numbered backups for the blend file. Open blend_file in background Blender.
Inputs: blend_file (required). Returns: object
get_blendfile_summary_usage_guessBRead-only
Estimate Blender workflows from evidence in the blend file.
Inputs: no named parameters. Returns: object
get_blendfile_summary_usage_guess_for_cliCRead-only
Estimate Blender workflows from evidence in the blend file. Open blend_file in background Blender.
Inputs: blend_file (required). Returns: object
get_object_detail_summaryBRead-only
Inspect an object by exact name, including transforms, materials and visibility.
Inputs: name (required). Returns: object
get_objects_summaryARead-only
Report the active view layer, object selection and recursive collection hierarchy.
Inputs: no named parameters. Returns: object
get_python_api_docsCRead-only
Find a Python API identifier or discover qualified identifiers with a trailing wildcard.
Inputs: identifier (required), index. Returns: object
get_screenshot_of_area_as_imageBRead-only
Capture the largest editor of the requested Blender area UI type as a PNG.
Inputs: area_ui_type (required), size_limit_in_bytes.
get_screenshot_of_window_as_imageARead-only
Capture the active Blender window as a PNG, with an optional byte limit.
Inputs: size_limit_in_bytes.
get_screenshot_of_window_as_jsonBRead-only
Describe the active Blender window, editor layout and selection.
Inputs: no named parameters. Returns: object
inspect_clothing_fitBRead-only
Review evaluated garment layers, dependency stacks, seams, attachments and local edge strain.
Optionally include a motion contact profile. Matched front and side evidence uses the same projection and scale in both panels. The operation restores the original frame.
Inputs: profile (required), views, frames, timeout, +1 more. Returns: object
inspect_rigARead-only
Inspect resolved bone axes, controls, authored weights and sampled motion using a version 1 profile.
Request front and side evidence at a sampled frame. Link an existing motion review report from the same scene for attached geometry findings. The operation restores the original frame.
Inputs: profile (required), views, frames, timeout, +3 more. Returns: object
inspect_spatial_pairsARead-only
Measure evaluated mesh pairs in world space, optionally over frames and with witness diagrams.
Use current-frame live inspection by default or open a specified blend file in background Blender. Supply frames or frame_range (start, end, step) for subframes. Distances and tolerance are in Blender units. Request front, side, top or isometric SVG evidence at one sampled frame. The query restores the original frame.
Inputs: pairs (required), views, frames, timeout, +4 more. Returns: object
jump_to_motion_witnessBIdempotent
Jump to an evidence bookmark from the current live Blender scene and frame the witness.
Inputs: bookmark (required), view. Returns: object
jump_to_tab_by_nameC
Activate the workspace with the given name.
Inputs: name (required). Returns: object
jump_to_tab_by_space_typeC
Activate a workspace with the requested main editor, creating one if allowed.
Inputs: space_type (required), allow_edits. Returns: object
jump_to_view3d_object_by_nameB
Frame the named object in the current 3D viewport, revealing it if allowed.
Inputs: name (required), allow_edits. Returns: object
jump_to_view3d_object_data_by_nameC
Frame the object that uses a datablock with the given name.
Inputs: name (required), allow_edits. Returns: object
preview_cloth_correctiveBRead-only
Stage a local, pose-dependent displacement and check clearance, trim and deformation.
Requires an authored mask and protected vertex groups. A feasible live preview returns a one-use candidate ID. A file preview returns assessment only. Neither saves the file.
Inputs: profile (required), views, timeout, blend_file, +1 more. Returns: object
preview_elbow_editARead-only
Preview an FK elbow move while preserving the planted hand's pose.
Pass a v1 rig profile and the current session ID for a live candidate. Headless previews are available with blend_file. Supply a signed swivel or world elbow target, or omit both to improve wrist alignment within the profile's limit. The preview stages the intended keys and checks the surrounding motion before restoring the original Action.
Inputs: profile (required), frame, views, timeout, +4 more. Returns: object
preview_knee_repairARead-only
Preview a two-bone IK pole edit with planted-foot, segment length and mesh clearance checks.
The default target tracks the profile's forward direction. Alternatively supply a signed angle or world knee target. Live preview is bound to the current session and frame. Use a longer deadline up to 600 seconds for expensive scene evaluation.
Inputs: profile (required), frame, views, timeout, +4 more. Returns: object
render_thumbnail_to_pathCDestructive
Render a small image from the active camera to output_path.
Inputs: output_path (required), timeout, blend_file. Returns: object
render_viewport_to_pathCDestructive
Render from the active camera to output_path using the scene's render settings.
Inputs: output_path (required), timeout, blend_file. Returns: object
review_motion_contactsARead-only
Check phase-specific contact rules across an animation and restore the starting frame.
Supply a version 1 profile with named surfaces and rule intervals. Optional extra_frames replay sample times from a previous review. Request two views for matched evidence at representative samples. Use match_evidence to reuse prior frames and framing. Use blend_file for an isolated background review.
Inputs: profile (required), views, timeout, blend_file, +3 more. Returns: object
search_api_docsCRead-only
Find matching passages in the configured Blender Python API documentation.
Inputs: query (required), index, context, max_results. Returns: object
search_manual_docsCRead-only
Find matching passages in the configured Blender manual.
Inputs: query (required), index, context, max_results. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 42 tools
Most tools target distinct Blender inspection or correction workflows, but the many live-vs-_for_cli variants and parallel preview/apply/cancel families create near-duplicate boundaries. An agent must read descriptions carefully to avoid confusing summary tools such as linked libraries, datablocks, path info or usage guess, especially across live and headless modes.
Names are overwhelmingly snake_case with predictable verb_object patterns, and the _for_cli suffix is applied systematically. Minor deviations exist, such as blender_health and a few very long descriptive names, but there is no chaotic mixing of conventions.
At 42 tools, the surface is substantially above the 3-15 sweet spot and feels heavy. Much of the bloat comes from duplicated live/_for_cli pairs and parallel preview/apply/cancel triples, though the broad Blender automation scope partly justifies some of the breadth.
The set covers file summaries, object and scene inspection, documentation search, screenshots, navigation, rendering, rig/motion/cloth review and corrective-edit workflows. Minor gaps remain, such as explicit save/undo or general object-editing tools, but execute_blender_code can bridge many of them.
Maintenance
Related MCP Connectors
MCP server to assist with JxBrowser development.
Start and manage Reason cloud coding agents, projects and sessions from any MCP client.
MCP server for progressive tool usage at any scale (see https://klavis.ai)
Global CAD/BIM, industrial engineering (FEM, CFD) and property tools via one MCP endpoint.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceConnects MCP-compatible clients to a live Blender scene for AI-assisted 3D workflows, enabling inspection and controlled operations on objects, materials, cameras, lights, render settings, animation, UVs, Geometry Nodes, imports, exports, and Python execution.1MIT
- AlicenseAqualityDmaintenanceConnects MCP clients to a local Blender + Bonsai (BlenderBIM) session for scene inspection, IFC project querying, viewport screenshots, and executing Python code in Blender.815MIT
- FlicenseNot gradedqualityCmaintenanceEnables remote control of Blender through MCP, allowing code execution, scene manipulation, rendering, and file transfer in a containerized environment.1-
- AlicenseAqualityCmaintenanceEnables AI clients to control a running Blender instance through the Model Context Protocol, allowing scene inspection, object creation and editing, rendering, and execution of Blender Python. It works locally via a WebSocket bridge between the MCP server and a Blender add-on.15MIT