Stereograph
<p align="center">
<img src="docs/assets/stereograph-banner.svg" alt="Ion Cascade Stereograph. Spatial inspection and editing for Blender." width="1280" />
</p>
<p align="center">
<strong>An independent MCP server and Blender add-on.</strong>
</p>
<p align="center">
<a href="https://github.com/ion-cascade/stereograph/releases/latest"><img src="https://img.shields.io/github/v/release/ion-cascade/stereograph?label=latest%20release&color=116d72" alt="Latest Stereograph release" /></a>
</p>
<p align="center">
<a href="https://github.com/ion-cascade/stereograph/releases/latest">Download latest release</a> ·
<a href="docs/connection.md">Set up</a> ·
<a href="docs/motion-review.md">Motion review</a> ·
<a href="docs/rig-inspection.md">Rig inspection</a> ·
<a href="docs/clothing-fit.md">Clothing fit</a>
</p>
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](docs/connection.md) and [Blender Lab compatibility matrix](docs/parity.md).
## 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](https://github.com/ion-cascade/stereograph/milestones) · [Tool parity checklist](docs/parity.md) · [Architecture and acceptance gates](docs/roadmap.md) · [Benchmark method](docs/benchmarking.md) · [Spatial inspection guide](docs/spatial-inspection.md) · [Elbow editing guide](docs/elbow-editing.md) · [Motion review guide](docs/motion-review.md) · [Rig inspection guide](docs/rig-inspection.md)
## 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](CONTRIBUTING.md) · [Changelog](CHANGELOG.md) · [Release process](docs/releases.md) · [GitHub releases](https://github.com/ion-cascade/stereograph/releases)
Maintained by Ion Cascade, the team behind [Conductor for Apple Logic Pro](https://github.com/ion-cascade/conductor). [Attribution](NOTICE.md) · [MIT licence](LICENSE)
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.