Skip to main content
Glama

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 tools
apply_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_healthB
Read-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_reviewsC
Read-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_codeB
Destructive

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_cliB
Destructive

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_datablocksA
Read-only

Summarize datablock counts, scene, workspace and render engine.

Inputs: no named parameters. Returns: object

get_blendfile_summary_datablocks_for_cliA
Read-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_filesB
Read-only

Find missing external file references used by the blend file.

Inputs: no named parameters. Returns: object

get_blendfile_summary_missing_files_for_cliB
Read-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_librariesA
Read-only

List the file's direct and indirect Blender library dependencies.

Inputs: no named parameters. Returns: object

get_blendfile_summary_of_linked_libraries_for_cliB
Read-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_infoA
Read-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_cliB
Read-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_guessB
Read-only

Estimate Blender workflows from evidence in the blend file.

Inputs: no named parameters. Returns: object

get_blendfile_summary_usage_guess_for_cliC
Read-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_summaryB
Read-only

Inspect an object by exact name, including transforms, materials and visibility.

Inputs: name (required). Returns: object

get_objects_summaryA
Read-only

Report the active view layer, object selection and recursive collection hierarchy.

Inputs: no named parameters. Returns: object

get_python_api_docsC
Read-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_imageB
Read-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_imageA
Read-only

Capture the active Blender window as a PNG, with an optional byte limit.

Inputs: size_limit_in_bytes.

get_screenshot_of_window_as_jsonB
Read-only

Describe the active Blender window, editor layout and selection.

Inputs: no named parameters. Returns: object

inspect_clothing_fitB
Read-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_rigA
Read-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_pairsA
Read-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_witnessB
Idempotent

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_correctiveB
Read-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_editA
Read-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_repairA
Read-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_pathC
Destructive

Render a small image from the active camera to output_path.

Inputs: output_path (required), timeout, blend_file. Returns: object

render_viewport_to_pathC
Destructive

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_contactsA
Read-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_docsC
Read-only

Find matching passages in the configured Blender Python API documentation.

Inputs: query (required), index, context, max_results. Returns: object

search_manual_docsC
Read-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

    B3/5.0

    Scored across 42 tools

    Disambiguation3/5

    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.

    Naming Consistency4/5

    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.

    Tool Count2/5

    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.

    Completeness4/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Connects 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.
      1
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      Connects MCP clients to a local Blender + Bonsai (BlenderBIM) session for scene inspection, IFC project querying, viewport screenshots, and executing Python code in Blender.
      8
      15
      MIT
    • F
      license
      Not graded
      quality
      C
      maintenance
      Enables remote control of Blender through MCP, allowing code execution, scene manipulation, rendering, and file transfer in a containerized environment.
      1
      -
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      15
      MIT