BlenderMCP Pro

BlenderMCP Pro turns Blender into a native Model Context Protocol (MCP) server. It runs a local HTTP server directly inside the Blender process, exposes 75 tools covering scene, mesh, material, UV, armature, shader node, geometry node, and export operations, and lets any MCP-compatible AI client — Claude Desktop, Claude.ai, Cursor, Windsurf, or your own tooling — drive Blender through natural language, with full tool-call visibility and undo support.

It also ships a self-contained AI chat panel inside the N-panel, so you can talk to Claude, Gemini, Groq, GPT-4o-mini, or a fully offline local model without leaving Blender or connecting an external client at all.

Requirements

• Blender 5.0 or newer (BlenderMCP Pro will not load on Blender 4.x)
• Windows, macOS, or Linux
• An API key for at least one AI provider (Claude, Gemini, Groq, or OpenAI), or a local Ollama install — needed for the chat panel and AI features. The raw MCP server itself works with any external MCP client and needs no key.

What It Does

• Native MCP server — an HTTP server on 127.0.0.1:7842 speaking the MCP protocol, running as a background thread inside Blender itself. No external bridge process, no separate Python environment.
• 75 tools across 14 categories — scene, mesh, material, UV, export, render, pipeline/validation, lighting, object, Python execution, asset library, armature/rigging, shader nodes, and geometry nodes. See the Tool Reference for the full list.
• Built-in AI chat panel — a full agentic chat interface in the N-panel with tool use, session history, and a choice of five AI providers.
• Multi-client connector — one-click configuration for Claude Desktop, Cursor, and Windsurf, plus a Cloudflare/ngrok tunnel option for connecting Claude.ai directly to your local Blender instance.
• Meshy AI integration — generate 3D meshes from text or reference images directly inside Blender via the Meshy API.
• AI Render Critic — sends a viewport or final render to your AI provider with vision support and gets back a structured critique (lighting, composition, materials, technical issues).
• Voice input — dictate chat messages using a local Whisper transcription pass, no cloud speech API involved.
• Auto-discovered addon tools — on startup, BlenderMCP Pro scans your other installed addons for safe, well-described operators and exposes up to 50 of them as additional MCP tools automatically, with dangerous built-in operators explicitly blocked.
• Quadify Bridge handshake — if Quadify Bridge is installed, BlenderMCP Pro automatically detects it on 127.0.0.1:7843 and merges its retopology/mesh-conditioning tools into the same tool list, so your AI client can call Quadify operations too.

Installation

Download blendermcp_pro.zip from your Superhive purchase. In Blender, go to Edit → Preferences → Extensions → Install from Disk, select the zip, and enable BlenderMCP Pro. A new MCP Pro tab appears in the 3D Viewport N-panel — press N to open it if it isn't visible.

Quick Start

1. Open the MCP Pro tab in the N-panel and click Start Server. The server binds to 127.0.0.1:7842 by default.
2. Pick an AI client from the dropdown — Claude Desktop, Cursor, Windsurf, Claude.ai (web), or Manual — and click Connect. See Connecting AI Clients for details on each option.
3. Alternatively, skip the external client entirely and open the Chat tab to talk to Blender through the built-in AI panel — set your provider and API key first in Preferences.
4. Every tool call the AI makes is logged live in the "Recent Tool Calls" list on the main panel, with timing and success/failure status, so you always know exactly what changed in your scene.

Free vs. Pro

BlenderMCP Pro runs in a free tier if no license key is entered: the MCP server starts and only the 7 Scene tools (list/select/create/delete/rename objects, set transforms) are exposed. Entering a valid Superhive license key unlocks all 75 tools across every category. See Licensing for the full breakdown.