Skip to main content
Glama

Blender MCP Master


Better decisions. Better meshes.

Blender MCP Master helps AI agents plan, model, inspect, and validate Blender assets using task-specific instructions, scripts, and evidence-based quality checks.

Important: This skill does not control Blender by itself. Live editing needs a separate Blender-control MCP server and Blender addon. The optional MCP resource server here is read-only.

Blender MCP Master 2.0: seven reusable specialist modules, executable host-adapter orchestration, independent QA handoffs, hashed evidence receipts and default dry-run. A concrete Codex CLI worker handles read-only reviews; the bundled native bpy host supplies checkpoints, scene probes, writer leases and dispatch of explicitly inspected production callbacks. Execution contract · Implementation and Agency Agents references · Validation record. See the 2.0 release notes for migration and the scope of verified behavior.

Define

Build

Inspect

Deliver

Establish style, purpose, proportions, and constraints.

Block out primary forms, then refine in reversible stages.

Verify actual mesh data and visual references.

Disclose measured results and what remains unverified.

Get started

1. Install the stable skill

Download v2.0.0 · Installable ZIP

Get SHA256SUMS.txt from the same release, verify the hash, extract the ZIP and copy its inner blender-mcp-master folder to your agent's skills directory. Full Windows and agent setup instructions.

With a current Skills CLI, pin the same release tag:

npx skills add God-601/blender-mcp-master@v2.0.0 --skill blender-mcp-master -g

2. Set up Blender control separately

Connect a compatible Blender-control MCP and its addon; discover the actual tool names and Blender version. Start in a scratch or backed-up scene. The skill supplies guidance, not a live Blender connection.

Start the optional read-only MCP resource server from the stable GitHub tag:

npx -y "github:God-601/blender-mcp-master#v2.0.0"

Configure Blender scene control separately.

The skill adapts its design questions to the brief, plans modeling by task, and checks evaluated geometry, scene preservation, UVs, materials and game-asset budgets. The quality toolkit includes conservative component-fit and containment diagnostics, PNG silhouette measurements, PBR channel inspection, and evidence-backed specialist review reports.

Verified in CI: Blender bpy regression suites, a real Cycles texture-bake fixture, and Blender-authored GLB import in Godot 4.4.1. User-reported Roblox Studio acceptance: Sofa V3 LOD meshes and PBR maps were inspected and the user approved the visible result. This does not certify universal Roblox/Unity compatibility or artistic quality.

See the v2.0.0 release notes, game export guidance, and the v1.5–1.9 milestone status.

Related MCP server: blender-unified

Workflow

USER BRIEF + REFERENCE
          |
          v
  BLENDER MCP MASTER  [Agent Skill]
  Clarify -> Plan -> Blockout -> Refine -> Verify
          |                              ^
          v                              |
  BLENDER-CONTROL MCP ------------------+
          |
       Blender scene

The agent must inspect before it claims success. Geometry checks, screenshots, and target-format checks answer different questions; missing evidence is NOT VERIFIED, not a pass.

Focus

What changes

Scene safety

Explicit targets, owned collections, backup-first changes

Modeling quality

Proportion checks before unnecessary micro-detail

Technical validity

Evaluated topology, modifiers, UVs, materials, and budgets

Visual validation

Real viewport views before judging appearance

Delivery

PASS / ISSUE / N/A / NOT VERIFIED plus known limitations

Supported workflows include hard-surface props, organic modeling, stylized and low-poly assets, architecture, environments, characters, UV/baking, materials, and game-ready exports. Available features depend on the actual Blender installation and connected MCP tools.

Documentation

Resource

Purpose

Quickstart

Installation, Windows paths, checksums, and MCP setup

SKILL.md

Main instruction entrypoint for agents

Official Blender documentation

Curated modeling, modifiers, UV, Geometry Nodes, Python API, export references

Evidence-first workflow

Stage gates, independent review, defect diagnosis, and stop conditions

Modeling standards

Production requirements and quality evidence

Production recipes

Concrete modeling examples

Skill comparisons

Reference patterns, including Superpowers

Roadmap v2.0

Production architecture, staged acceptance gates and remaining validation

v1.5–v1.9 milestones

Candidate capabilities and open acceptance gates

Roblox Studio inspection

Read-only MeshPart/PBR/LOD inspection procedure

Godot GLB import

Executable import probe, scope and limitations

Agent efficiency

Tool-first, bounded reads and progressive context loading

3D model optimization

Evaluated triangle, material, texture and Geometry Nodes guidance

Paired token benchmark

Reproducible with/without skill comparison protocol

python -m unittest discover -s tests -v

Some tests require a compatible bpy runtime. Passing tests is not proof of artistic quality or live MCP and downstream export compatibility.

Milestones v1.5–1.9 · Roadmap v2.0 and pre-release audit · Quality checklist · Changelog · Contributing


Português

Uma skill para agentes de IA modelarem no Blender com método e evidências. Ajuda a planejar, modelar, verificar topologia, UVs, materiais PBR e preparar assets para jogos. Ela orienta o agente; não instala nem substitui o Blender-control MCP.

Inclui verificações técnicas e exemplos reais de baking e importação no Godot. Um sofá com três LODs e mapas PBR foi aprovado pelo usuário em uma campanha anterior no Roblox Studio.

A 2.0 reúne módulos especializados, executor por adaptador do cliente, um escritor por vez, QA independente e recibos com SHA256. Tarefas simples ficam com o coordenador. O adaptador deve fornecer as ferramentas reais do Blender; a ponte de revisão Codex é somente leitura. Contrato e uso · Evidências e pendências.

Notas da v2.0.0 · Roadmap 2.0 · Guia Roblox Studio

Available Tools

8 tools
get_blender_mcp_setupB
Read-only

Explain how this skill/resource server relates to a separate MCP server that controls a live Blender session.

Inputs: no named parameters.

get_blender_referenceA
Read-only

Read one bundled modeling reference guide by exact filename.

Inputs: name (required).

get_blender_reference_excerptA
Read-only

Read only a bounded line window from a reference. Returns continuation line; use before requesting full text.

Inputs: name (required), startLine (required), maxLines.

get_blender_reference_outlineA
Read-only

List only section headings and their line numbers from one guide. Low-context alternative to reading the full document.

Inputs: name (required).

get_blender_scriptA
Read-only

Return one reusable Blender Python script by exact filename. Review its configuration and safety notes before execution.

Inputs: name (required).

get_blender_skillB
Read-only

Return the Blender MCP Master agent skill instructions (SKILL.md).

Inputs: no named parameters.

list_blender_resourcesA
Read-only

List the skill reference guides and reusable Blender Python scripts bundled with this package.

Inputs: no named parameters.

plan_blender_workflowC
Read-only

Recommend minimal on-demand guides and unanswered design topics without touching Blender.

Inputs: category (required), known, needs, delegated, +2 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A3.5/5.0

    Scored across 8 tools

    Disambiguation4/5

    Each tool has a distinct role: skill instructions, resource listing, reference reading, outline, excerpt, script retrieval, setup explanation, and workflow planning. The three reference-reading tools (get_blender_reference, get_blender_reference_outline, get_blender_reference_excerpt) operate on the same documents at different granularities, which could cause some misselection, but the descriptions clearly delineate low-context vs. bounded-window vs. full-read use cases.

    Naming Consistency5/5

    All tools follow a uniform snake_case verb_noun pattern scoped by the domain (get_blender_*, list_blender_*, plan_blender_workflow). No mixed conventions or abbreviation drift, making intent predictable from the name alone.

    Tool Count5/5

    Eight tools is well-scoped for a read-only skill/resource server with no redundancy. Every tool maps to a distinct access pattern (metadata, full read, outline, excerpt, script, setup, planning) and none feels padded.

    Completeness4/5

    The read-only resource surface is largely complete: discovery, granular reading, scripts, setup context, and planning are all covered. The main gap is a search/lookup tool to find which reference covers a topic without first listing files; otherwise no dead ends for the stated purpose.

    Maintenance

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      C
      maintenance
      Serves skill-defined JSON-in/JSON-out scripts as callable tools over MCP stdio, driven by a portable skill-runtime.json manifest that supplies each tool's title, description, and input schema. Exposes commands to validate, list, and run skills, so hosts can discover and invoke agent skills without custom per-skill glue code.
      8 npm
      MIT
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables MCP-compatible clients to control Blender for modeling, materials, animation, physics, rendering, scene inspection, documentation search, and asset/generation service integration. It exposes a stdio endpoint with many Blender operations for creating and editing 3D content.
      AGPL 3.0
    • A
      license
      A
      quality
      B
      maintenance
      Enables MCP hosts to list and render bundled prompt templates and fetch assistant blueprints for ChatGPT, Claude, Gemini, Grok, or portable Agent Skill format. Operates locally over stdio with read-only tools and no network, shell, account, or file-write access.
      3
      46 PyPI
      1
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables AI agents to drive a live Blender session over stdio, inspecting the scene graph, searching and calling operators, reading and writing RNA properties, rendering viewable images, and checkpointing or restoring the file across a multi-turn conversation. It also exposes gallery and scene-reset helpers so the agent can check its own work and start over cleanly.
      19
      GPL 3.0