Skip to content

v0.2.0 — the pure MCP

Choose a tag to compare

@Qervas Qervas released this 27 Jul 03:21
· 5 commits to main since this release

An agentic Blender MCP: 291 tools across 47 domains, plus eyes so an agent can look at
what it just did instead of driving blind.

This release deliberately does less than v0.1.0.

What changed

v0.1.0 shipped an opinionated finisher — triangle budgets per asset class, readiness
gates, a retopo recipe. That code still exists in the repo and still runs under
scripts/, but it is not in this release, because it is not good enough to stand
behind: the reducer hits budget on simple props and cannot take a dense character there
without wrecking it. A tool that fails on the hard case makes the whole MCP look broken
when the Blender surface underneath is fine.

So the MCP no longer decides anything for you. modifiers.add with a DECIMATE modifier
does exactly what it does in Blender; how far to take it is the agent's call.

Removed from the shipped surface (13 tools):

  • feedback.quality, feedback.readiness, feedback.critique, feedback.preservation,
    feedback.capture_intake, io.profile_validate, asset_class.list,
    asset_class.describe, object.retopo, object.lod_create,
    object.collision_hulls_create, object.collision_proxy_create — held back, still in
    the repo under benchmark.
  • lattice.convert_to_meshgone for good. Blender cannot do it: the operator
    returns FINISHED and leaves the object a LATTICE; to_mesh() raises "Object does
    not have geometry data"
    .

Kept: the eyes. feedback.capture, silhouette, topology, uv, wire_shaded,
turntable, lookdev, orientation — they look at the mesh and report, without judging.

Verified, not assumed

Every one of the 291 tools was exercised against a live Blender 5.1.2 — including the
destructive ones, tested against backups. Zero crashes, zero missing commands, zero broken
tools. Full evidence: docs/reports/tool-audit-2026-07-26.md.

Install

  • MCP server (Apache-2.0, never imports bpy): pip install niua_blender_mcp-0.2.0-py3-none-any.whl
  • Blender add-on (GPL-3.0-or-later): install niua_mcp_bridge-0.2.0.zip through
    Preferences → Add-ons → Install…

Two processes, two licences — the boundary is the socket between them. See LICENSING.md.

execute_python is off by default; enable it per session in the N-panel.