blockbench-mcp
Provides full programmatic control of Blockbench for 3D modeling via a plugin bridge: create and edit cubes, groups and meshes, apply transforms, arrays and mirroring, author procedural textures and UVs, build animations with keyframes, manage projects and plugins, run Blockbench actions, and export models to formats such as bbmodel, java_block, bedrock, gltf, obj, fbx, stl, collada and skin. Also supports rendering review contact sheets and screenshots of the model from multiple angles, validation, and executing arbitrary JavaScript inside Blockbench for anything the built-in tools don't cover.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@blockbench-mcp create a low-poly wooden crate, texture it with planks, and review it"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
blockbench-mcp
An MCP server that gives an AI agent full programmatic control of Blockbench: 3D modeling, procedural textures, UV, animation, codecs/export, files, plugin management — and arbitrary JavaScript inside Blockbench when the built-in tools aren't enough.
Transport: agent ←(stdio/JSON-RPC)→ this server ←(localhost WebSocket)→ a plugin inside Blockbench. Zero dependencies: just Node.js and Blockbench itself.
┌────────────┐ stdio / MCP ┌──────────────────┐ WebSocket ┌─────────────────────┐
│ MCP client│ ───────────────► │ blockbench-mcp │ ◄──────────── │ Blockbench + plugin │
│ (opencode, │ ◄─────────────── │ (this project) │ 127.0.0.1 │ Blockbench MCP Bridge│
│ Claude…) │ JSON-RPC │ port + token │ connection.json │
└────────────┘ └──────────────────┘ └─────────────────────┘Requirements
Node.js ≥ 18 (tested on 22).
Blockbench Desktop ≥ 4.9 (tested on 5.2.1). The web build won't work — the plugin uses the desktop app's file layer and Node modules.
Related MCP server: Blockbench MCP
Quick start
From the project folder:
node install.js --registerThis will:
Copy the plugin
blockbench_mcp.jsinto Blockbench's plugins folder.Add it to
StateMemory.installed_plugins(Blockbench does not auto-scan the folder) and load it immediately.If Blockbench isn't running (or is running without a debug port), relaunch it with
--remote-debugging-portand inject the plugin over CDP.
Prefer doing it by hand? Copy
plugin/build/blockbench_mcp.jsinto the Blockbench plugins folder and drag the file into the Blockbench window once, confirming the install.--forcelets the installer restart a running Blockbench (unsaved changes would be lost).
Then register the server with your client:
node install.js opencode # or cursor / claude / windsurf / vscode / gemini / cline
node install.js --all # all of them
node install.js --print-config # show configs without writing anythingCheck everything is in place:
node install.js --statusOpen (or restart) your MCP client and ask the agent to call bb_status — it
should return the Blockbench version and a project summary.
The agent's workflow (baked into the server instructions)
bb_status— learn the format, mode and contents.bb_new_project/bb_open_model— create or open a project.Build:
bb_add_cube,bb_add_group,bb_add_mesh. Repeat parts withbb_array_elements, symmetry withbb_mirror_elements(not hand-placed copies).Textures:
bb_create_texture/bb_generate_texture(seeded ops), refine withbb_draw_texture/bb_paint_pixels, assign withbb_set_face_texture, verify withbb_get_texture_pixel.Look at the result:
bb_reviewrenders the model from 4–6 angles into a single contact sheet (the path is returned; the agent reads the image and fixes proportions/textures).bb_set_view+bb_screenshotare available too.bb_validate→ fix findings →bb_export_model(bbmodel, java_block, bedrock, gltf, obj, fbx, stl, collada, skin…).bb_execute_jsfor arbitrary JS inside Blockbench;bb_stepbatches several calls in one round trip.
Tools (69)
Utility
bb_status, bb_execute_js, bb_step (batch; later steps can reference earlier
results with "$0.element.uuid")
Project and codecs
bb_new_project, bb_open_model, bb_save_project, bb_export_model,
bb_project_info, bb_set_project
Files
bb_read_file, bb_write_file, bb_list_dir, bb_glob, bb_file_info,
bb_mkdir, bb_delete_path, bb_request_fs
Reads and writes go through Blockbench's file layer and need no permission. Directory listing, stat, mkdir and delete need a one-time plugin permission for the filesystem — Blockbench asks on first use; click "Always allow for this plugin".
Model
bb_list_elements, bb_add_cube, bb_add_group, bb_add_mesh, bb_edit_mesh,
bb_add_element, bb_set_element, bb_transform_elements, bb_array_elements,
bb_mirror_elements, bb_duplicate_elements, bb_delete_elements,
bb_reparent_elements, bb_select_elements, bb_group_elements,
bb_set_face_texture, bb_set_face_uv, bb_auto_uv, bb_validate
Textures
bb_list_textures, bb_create_texture, bb_generate_texture, bb_draw_texture,
bb_paint_pixels, bb_get_texture_pixel, bb_import_texture, bb_export_texture,
bb_set_texture_properties, bb_resize_texture, bb_delete_texture
Material presets: wood, planks, stone, cobble, metal, dirt, grass,
leaves, bricks, fabric, skin, gem, noise, gradient — set with the
preset field; your own ops run on top. Drawing ops (ops) support: fill,
noise, cells, gradient, radial, rect, circle, ellipse, line,
checker, stripes, border, vignette, scatter, pixel, pixels, text,
adjust, replace, blend. Everything is deterministic for a given seed.
Animation
bb_list_animations, bb_create_animation, bb_set_animation,
bb_delete_animation, bb_add_keyframe, bb_delete_keyframe, bb_play_animation
UI / rendering
bb_set_mode, bb_set_view, bb_run_action, bb_list_actions, bb_notify,
bb_screenshot, bb_review
Plugins and settings
bb_list_plugins, bb_install_plugin, bb_uninstall_plugin, bb_reload_plugin,
bb_list_settings, bb_set_setting
Host tools (work even with Blockbench closed)
bb_bridge_status, bb_setup, bb_reconnect
Examples
// procedural 64×64 texture
{ "tool": "bb_generate_texture", "arguments": {
"name": "stone", "width": 64, "height": 64, "seed": 7,
"ops": [
{ "op": "fill", "color": "#3a3f46" },
{ "op": "noise", "color": "#22262b", "color2": "#6b7480", "scale": 3, "octaves": 5 },
{ "op": "cells", "cell_size": 10, "color": "#000000", "color2": "#ffffff", "edge": true },
{ "op": "vignette", "strength": 0.4 }
] } }// the same, with a material preset
{ "tool": "bb_generate_texture", "arguments": { "preset": "wood", "name": "wood", "width": 64, "height": 64 } }// a deterministic row of cubes
{ "tool": "bb_array_elements", "arguments": {
"targets": ["step-original-uuid"], "axis": "x", "count": 5, "offset": 16, "names": "step_{i}" } }// batch with a result reference: add a cube, then texture it by its new uuid
{ "tool": "bb_step", "arguments": { "steps": [
{ "tool": "bb_add_cube", "arguments": { "name": "spike", "from": [0,20,0], "size": [4,4,4] } },
{ "tool": "bb_set_face_texture", "arguments": { "targets": ["$0.element.uuid"], "texture": "stone" } }
] } }// "do anything": raw JavaScript inside Blockbench
{ "tool": "bb_execute_js", "arguments": {
"code": "return Cube.all.map(c => c.name + ' @ ' + JSON.stringify(c.from));" } }Sample output lives in examples/: a quadruped mob (toxin_beast) built entirely
through this MCP — .bbmodel, a 6-angle review sheet and a hero render. Open the
.bbmodel in Blockbench or look at the PNGs to see what comes out of the box.
Security
The server listens only on
127.0.0.1on a random port and accepts connections only with a matching token (regenerated on every start). The endpoint is loopback-only and token-gated.bb_execute_js,bb_run_actionandbb_install_plugincan run arbitrary code and install third-party plugins — that is the intended functionality. Don't point this server at a Blockbench instance you don't trust, and don't install plugins from untrusted sources.
Project layout
blockbench-MCP/
├─ plugin/
│ ├─ src/ plugin sources (concatenated into one file)
│ │ ├─ 00-core.js helpers, ref resolution, undo, fs, sanitize
│ │ ├─ 10-textures.js procedural texture engine (seeded ops) + presets
│ │ ├─ 20-tools-core.js status, execute_js, projects, files, screenshots
│ │ ├─ 30-tools-model.js elements, transforms, arrays, UV, validate
│ │ ├─ 40-tools-texture.js
│ │ ├─ 50-tools-animation.js
│ │ ├─ 60-tools-plugins.js
│ │ └─ 99-boot.js WS client, plugin registration, tool registry
│ └─ build/blockbench_mcp.js built plugin (this is what Blockbench loads)
├─ src/
│ ├─ index.js MCP server (stdio) + host tools
│ ├─ mcp.js MCP protocol implementation (zero-dep)
│ ├─ ws.js WebSocket server (RFC 6455, zero-dep)
│ ├─ bridge.js bridge to the plugin + connection.json
│ ├─ setup.js plugin install + client configs
│ └─ register.js CDP-based plugin registration
├─ install.js installer / config CLI
├─ examples/ a model built through the MCP
└─ test/ ws.js · offline.js · live.js · call.js · eval.jsDevelopment
node plugin/build.js # rebuild the plugin (validates syntax and schemas)
node test/ws.js # WebSocket server test
node test/offline.js # MCP protocol without Blockbench
node test/live.js # end-to-end test in a live Blockbench (must be running)
node test/call.js bb_status # one-off tool call
node test/eval.js "Plugins.registered" # evaluate JS in Blockbench over CDPAfter editing the plugin: node plugin/build.js, then node install.js --plugin
and node install.js --register --no-plugin (hot reload without restarting
Blockbench — only if it's running with a debug port).
Troubleshooting
bb_bridge_status→connected: false. The plugin isn't loaded or Blockbench is closed. Runnode install.js --registerand make sure "Blockbench MCP Bridge" is listed among Blockbench's plugins.The plugin file is in the folder but Blockbench doesn't see it. A file in
plugins/alone isn't loaded — it must be recorded inStateMemory.installed_plugins, which is what--register(or dragging the file into the window) does.FS tools ask for permission. That's expected and one-time; or call
bb_request_fs.Format/version mismatch. See available formats and codecs in
bb_statusandbb_project_info.
License: MIT.
Available Tools
72 toolsbb_add_cubeAdd a cubeB
Create a cube element. Provide from+to, or from+size (Blockbench cubes use from/to where to is the exclusive upper bound). origin defaults to from. Optionally assign a texture to all faces, set per-face uv, and enable auto UV.
Inputs: to, from, name, size, +10 more.
bb_add_elementAdd a special elementC
Create a locator, null_object, bounding_box, texture_mesh, armature or armature_bone. Pass its properties directly.
Inputs: type (required), name, parent, properties.
bb_add_groupAdd a groupB
Create an empty group (bone) to hold elements or drive animation. Position it with origin.
Inputs: name, origin, parent, rotation.
bb_add_keyframeAdd a keyframeB
Add a keyframe for a bone on rotation/position/scale. x/y/z are Molang expressions (default "0"), or plain numbers. The bone is referenced by group name or uuid.
Inputs: bone (required), time (required), x, y, +4 more.
bb_add_meshAdd a meshB
Create a free-form mesh. vertices is a list of [x,y,z] (or a {key:[x,y,z]} map). faces is a list where each face is either [i0,i1,i2] indices into vertices, or {vertices:[i..], uv:[[u,v]..], texture}. UVs are stored per vertex.
Inputs: faces (required), vertices (required), name, origin, +3 more.
bb_array_elementsArray elementsB
Create repeated copies of elements along a grid — the correct way to build rows of windows, treads, spokes and so on instead of placing copies by hand. names may contain {i} and starts at 1.
Inputs: targets (required), axis, count, names, +3 more.
bb_auto_uvRegenerate UVsC
Set automatic UV mode on cubes: mode "faces" (autouv 1, per-face), "relative" (autouv 2), "box" (box_uv), or "off".
Inputs: targets (required), mode.
bb_bridge_statusBridge statusA
Check whether this server is talking to Blockbench, the port it listens on, the connection file path and where the tool schemas came from. Call this first when any bb_* tool reports "not connected".
Inputs: no named parameters.
bb_create_animationCreate an animationC
Create a new animation. loop is "once", "loop" or "hold"; length is in seconds.
Inputs: loop, name, length, select.
bb_create_textureCreate a textureC
Create a blank texture, optionally filled with a colour. Size defaults to the project texture resolution.
Inputs: fill, name, width, height, +1 more.
bb_delete_animationDelete an animationC
Remove an animation from the project.
Inputs: animation (required).
bb_delete_elementsDelete elementsC
Delete elements (groups delete their children).
Inputs: targets (required).
bb_delete_keyframeDelete a keyframeB
Delete a keyframe by uuid, or the one nearest to a given time on a bone/channel.
Inputs: bone (required), time, uuid, channel, +1 more.
bb_delete_pathDelete a file or directoryA
Delete a file, or a directory when recursive is true. Needs file-system permission.
Inputs: path (required), recursive.
bb_delete_textureDelete texture(s)C
Remove textures from the project.
Inputs: targets (required).
bb_draw_textureDraw on an existing textureB
Apply a list of ops onto an existing texture (adds to what is already there). Same ops as bb_generate_texture.
Inputs: ops (required), target (required), seed.
bb_duplicate_elementsDuplicate elementsC
Copy elements (groups copy their children too). Optionally repeat and offset each copy.
Inputs: targets (required), axis, count, offset, +1 more.
bb_edit_meshEdit a meshA
Modify an existing mesh in place. With vertices+faces it redefines the geometry; with merge:true the new vertices/faces are appended. delete_faces / delete_vertices remove by key. Keys are shown by bb_list_elements {include_geometry:true}.
Inputs: target (required), faces, merge, vertices, +2 more.
bb_execute_jsExecute JavaScript in BlockbenchA
Run arbitrary async JavaScript inside Blockbench with full access to every global (Project, Cube, Group, Mesh, Texture, Canvas, Codecs, Formats, Modes, Undo, Outliner, Preview, Menu, Action, BarItems, Plugins, StateMemory, ...) and the Node modules a plugin may use. Use this for anything the structured tools do not cover. The code may use await and must return a value; console output is captured and returned. An api argument is injected with helpers: api.find(ref), api.findAll(refs), api.textures(), api.animations(), api.sleep(ms), api.readFile(path), api.writeFile(path,text), api.toBase64(bytes), api.fromBase64(b64), api.toast(text).
Inputs: code (required).
bb_export_modelExport modelB
Compile the project into another format and write it to disk. Formats: bbmodel/project, java_block, bedrock, bedrock_old, modded_entity, optifine_entity (jem), optifine_part (jpm), collada (dae), fbx, gltf/glb, obj, stl, skin_model.
Inputs: path (required), format, options.
bb_export_textureExport texture(s) to PNGB
Write texture PNGs to disk. Give a single target + path, or several targets + a directory.
Inputs: dir, path, targets, include_data_url.
bb_file_infoFile infoB
Stat a path: exists, type, size, modified time. Needs file-system permission.
Inputs: path (required).
bb_generate_textureGenerate a procedural textureB
Paint a new texture from a preset and/or an ordered list of ops. Deterministic for a given seed. Presets: wood, planks, stone, cobble, metal, dirt, grass, leaves, bricks, fabric, skin, gem, noise, gradient. Ops: fill, noise, cells, gradient, radial, rect, circle, ellipse, line, checker, stripes, border, vignette, scatter, pixel, pixels, text, adjust, replace, blend. Example: {preset:"wood"} or {ops:[{op:"fill",color:"#2b3a55"},{op:"noise",color:"#101820",color2:"#8fb8de",scale:2,octaves:4},{op:"vignette",strength:0.5}]}.
Inputs: ops, name, seed, width, +4 more.
bb_get_texture_pixelRead texture pixelsB
Read a rectangle of pixels from a texture. Use this to verify what was drawn: it returns rows of [r,g,b,a].
Inputs: targets (required), h, w, x, +1 more.
bb_globFind files by globA
Recursively find files under a directory matching a glob such as "**/.json" or ".png". Needs file-system permission.
Inputs: path (required), pattern (required), limit.
bb_group_elementsGroup elementsB
Create a new group around the given elements, positioned at their centre, and move the elements into it.
Inputs: targets (required), name.
bb_import_textureImport a textureC
Load an image from disk or a data URL as a project texture.
Inputs: name, path, data_url.
bb_install_pluginInstall a pluginA
Install a Blockbench plugin from source code, a local file, or a URL. The code is written to the plugins folder, recorded so it loads on startup, and loaded immediately. Executes third-party code inside Blockbench.
Inputs: id, url, code, path, +1 more.
bb_list_actionsList toolbar actionsC
List runnable Blockbench actions (BarItems) by id and name, optionally filtered.
Inputs: limit, filter.
bb_list_animationsList animationsA
List the project animations with loop mode, length and per-bone keyframe counts.
Inputs: no named parameters.
bb_list_dirList a directoryA
List the entries of a directory. Needs the plugin file-system permission (the user is asked once; bb_request_fs can trigger the prompt explicitly). Supports recursion and a glob filter.
Inputs: path (required), limit, filter, recursive.
bb_list_elementsList elementsA
List outliner elements with their ids, transforms and (optionally) geometry. Filter by type or parent.
Inputs: type, parent, include_faces, include_geometry.
bb_list_pluginsList pluginsA
List every Blockbench plugin that is present, with id, version, source, install state and whether it can be reloaded.
Inputs: no named parameters.
bb_list_settingsList Blockbench settingsA
List user settings by id with their current values. Handy before bb_set_setting. filter matches the id.
Inputs: limit, filter.
bb_list_texturesList texturesB
List the project textures with size, UV resolution, layers and saved state.
Inputs: include_data_url.
bb_mirror_elementsMirror elementsA
Reflect elements across an axis-aligned plane (default x=0). copy=true duplicates first, which is the usual way to build a symmetrical half. Meshes keep correct winding.
Inputs: targets (required), axis, copy, plane.
bb_mkdirCreate a directoryB
Create a directory (recursively by default). Needs file-system permission.
Inputs: path (required), recursive.
bb_new_projectNew projectA
Create a new empty Blockbench project. format is a Blockbench format id (free, java_block, bedrock, bedrock_block, modded_entity, skin, image, ...). Always call this (or bb_open_model) before building, unless a project is already open.
Inputs: name, box_uv, format, texture_width, +2 more.
bb_notifyNotify the userB
Show a toast / quick message inside Blockbench. Use it to tell the human what the agent is doing or to ask them to look at the screen.
Inputs: text (required), icon, expire.
bb_open_modelOpen / import a model fileA
Load a model from disk, replacing the current project (or importing into it). Codec inferred from the extension (.bbmodel, .json, .obj, .gltf, .fbx, .stl, .dae, .jem, .jpm), or set with format (ids from bb_status).
Inputs: path (required), format, import_to_current.
bb_paint_pixelsPaint pixelsB
Set individual pixels on a texture — the precise way to hand-draw pixel art. pixels is a list of [x, y, color] with color "#rrggbb" or [r,g,b] or [r,g,b,a].
Inputs: pixels (required), target (required).
bb_play_animationTimeline playbackC
Control the animation timeline: set the time, play, pause or stop.
Inputs: time, action, animation.
bb_project_infoProject overviewA
Dump the current project: format, mode, sizes, and optionally the element tree, textures and animations. Call this to re-orient after a large edit.
Inputs: elements, geometry, textures, animations.
bb_read_fileRead a fileA
Read a file from disk. encoding "auto" (default) returns text for text files and base64 for binary; force it with "text" or "base64". Reading uses Blockbench's own file layer and needs no plugin permission.
Inputs: path (required), encoding.
bb_reconnectReconnect the bridgeA
Drop the current Blockbench connection so the plugin dials back in. Use after reloading the plugin in Blockbench.
Inputs: no named parameters.
bb_redoRedoC
Redo the last undone edit.
Inputs: steps.
bb_reload_pluginReload a pluginA
Reload a dev/URL plugin without restarting Blockbench. Store plugins are not reloadable in place.
Inputs: id (required).
bb_reparent_elementsReparent elementsC
Move elements under a new parent group (or "root").
Inputs: parent (required), targets (required).
bb_request_fsRequest file-system permissionA
Ask the user for the plugin file-system permission (needed only by bb_list_dir, bb_glob, bb_file_info, bb_mkdir, bb_delete_path; reads and writes work without it). An optional scope limits the permission to one directory.
Inputs: scope.
bb_resize_textureResize a textureB
Resize the texture image (nearest neighbour). uv_width/uv_height follow the new size unless keep_uv is true.
Inputs: width (required), height (required), target (required), keep_uv.
bb_reviewReview the model from several anglesA
Render the model from several camera angles into one contact-sheet PNG and return its path. Use this to LOOK at your own work and catch proportion and texture problems before declaring a model finished. The agent can then read the image file.
Inputs: path, width, angles, background.
bb_run_actionRun a toolbar actionB
Trigger any Blockbench action by its BarItems id (see bb_list_actions). This reaches every built-in command the UI exposes.
Inputs: id (required).
bb_save_projectSave project (bbmodel)B
Compile the project to .bbmodel and write it to disk. Without a path, the current project path is reused; pass one to save a copy.
Inputs: path, embed_textures.
bb_screenshotScreenshot the viewportA
Render the current preview to a PNG on disk and return the path. This is how an agent looks at its own work. Set crop=true (default) to auto-crop to the model, or crop=false for the full viewport. The transparent viewport is composited over a solid background (override with "background", or disable with background:false). Returns a data URL too when include_data_url is true.
Inputs: crop, path, width, height, +2 more.
bb_select_elementsSelect elementsC
Change the outliner selection. mode: replace (default), add, remove, toggle, none.
Inputs: mode, targets.
bb_set_animationEdit an animationC
Change name, loop mode or length of an animation.
Inputs: loop, name, length, animation.
bb_set_elementEdit element propertiesB
Change properties of one or more elements: name, origin, rotation, from/to/size (cubes), position (locators), inflate, visibility, export, locked, box_uv, autouv, shade, mirror_uv, uv_offset, color, and per-face overrides via faces:{north:{uv,texture,enabled,tint,rotation}}. Renaming more than one element at once is refused.
Inputs: targets (required), properties (required), apply_to_children.
bb_set_face_textureAssign a texture to facesA
Assign a texture (by name/uuid) to cube or mesh faces, or clear it with null. For cubes, pass faces to limit which sides are changed.
Inputs: targets (required), texture (required), faces.
bb_set_face_uvSet face UVsB
Set UVs on one face. For cubes give uv=[x1,y1,x2,y2] in texture pixels. For meshes give uvs aligned to the face vertices, or a {vertex_key:[u,v]} map.
Inputs: face (required), target (required), uv, uvs.
bb_set_modeSwitch editor modeA
Switch Blockbench mode: edit, paint, animate, display or pose. Paint/animate are needed for texture and animation tools on some formats.
Inputs: mode (required).
bb_set_projectEdit project metadataC
Change the open project: name, texture resolution, the box_uv default and the view mode. Use it to rename a project or change the texture canvas the model is authored against.
Inputs: name, box_uv, view_mode, texture_width, +1 more.
bb_set_settingChange a settingC
Set a Blockbench user setting by id (e.g. viewport_zoom_speed, default_cube_size, shading).
Inputs: id (required), value (required).
bb_set_texture_propertiesEdit texture propertiesC
Change texture metadata: name, folder, render_mode, pbr_channel, particle, fps, layers_enabled, saved.
Inputs: targets (required), fps, name, folder, +5 more.
bb_setupInstall bridge and configure clientsA
Install or refresh the Blockbench plugin file and print the MCP client configuration for opencode, Claude, Cursor, Windsurf, VS Code, Gemini and Cline. Pass clients:["write"] to actually write the config files.
Inputs: clients, install_plugin.
bb_set_viewSet view mode and camera angleB
Change the viewport view mode (textured, solid, wireframe, normal, uv) and/or move the camera to a preset angle (front, back, left, right, top, bottom, isometric_right, isometric_left, true_isometric_right, true_isometric_left, north, east, south, west, up, down). Useful before bb_screenshot.
Inputs: zoom, angle, view_mode.
bb_statusBridge statusA
Report the connection to the MCP server, the Blockbench version, the open project summary and whether file-system permission has been granted. Call this first in a session.
Inputs: no named parameters.
bb_stepRun several tools in one requestA
Execute a list of tool calls in order inside a single round trip. Each step is {tool, arguments}. Later steps may reference earlier results with "$N.path" (N = step index, or -1/"last" for the previous step), e.g. "$0.element.uuid". Failures are reported per step and do not stop the batch unless stop_on_error is true.
Inputs: steps (required), stop_on_error.
bb_transform_elementsTransform elementsA
Move, rotate or scale elements. Use vector [x,y,z], or axis+amount. Move translates from/to/origin (cubes) or origin/position (others). Rotate adds degrees around the element origin. Scale multiplies size about the element origin (cubes, meshes, texture_mesh).
Inputs: targets (required), operation (required), axis, amount, +2 more.
bb_undoUndoC
Undo the last edit (one or more steps).
Inputs: steps.
bb_uninstall_pluginUninstall a pluginC
Uninstall a Blockbench plugin by id and optionally delete its file.
Inputs: id (required), delete_file.
bb_validateValidate the modelA
Run a static audit of the project and return a score plus findings: empty project, zero-size or degenerate cubes, meshes with too few vertices, untextured faces, UVs outside the texture, duplicate cubes, and out-of-bounds UVs. Fix and re-run before declaring a model finished.
Inputs: no named parameters.
bb_write_fileWrite a fileA
Write text or base64-decoded bytes to a file, creating parent directories is the caller's job. Uses Blockbench's file layer (no permission prompt).
Inputs: path (required), content (required), encoding.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 72 tools
Most tools have distinct resource+action targets, and the descriptions are detailed enough to guide selection. A few overlaps remain, notably bb_set_element vs bb_transform_elements for transforms, bb_set_face_uv/bb_auto_uv/bb_set_element for UVs, and bb_generate_texture/bb_draw_texture/bb_paint_pixels for texture editing, but they are not severe enough to make the set unusable.
All tools use the same bb_ prefix and snake_case convention, with predictable verb_noun patterns such as bb_list_elements, bb_add_cube, bb_delete_texture, and bb_set_setting. The few non-verb-noun names (bb_undo, bb_status, bb_validate) are still consistent in style and easily understood.
72 tools is an extreme over-provisioning for an MCP server, well beyond the 50+ threshold for severe mismatch. While Blockbench is a large domain, this many tools creates unnecessary cognitive load and makes discoverability poor for an agent.
The surface is very broad, covering project lifecycle, elements, meshes, UVs, textures, animations, plugins, settings, file-system operations, screenshots, validation, and arbitrary JS escape hatches. Minor gaps exist, such as updating or reading individual keyframes and texture layer management, but bb_execute_js can fill most of these.
Maintenance
Related MCP Connectors
Generate 3D models, worlds, PBR materials, and coordinated asset packs from AI agents.
Generate game-ready 3D models, textures, and audio from natural language, over MCP.
Connect your AI assistant to Blender for 3D modeling, Geometry Nodes, materials, lighting, animation, rendering and export. Inspect real scenes and viewport images, refine the result and restore checkpoints. OAuth connects your chat to Blender Bridge Desktop on an online Windows 10/11 x64 computer running Blender 4.2+. The chat can run on another device. Requires an active Blender Bridge account; 7-day trial available. AI model access is separate.
214 tools for AI agents over one MCP endpoint: image, video, audio, 3D, data, storage, mail, GPUs.
Related MCP Servers
- AlicenseNot gradedqualityAmaintenanceEnables AI agents to create and edit 3D models in Blockbench via the Model Context Protocol.628GPL 3.0
- AlicenseNot gradedqualityDmaintenanceEnables AI assistants to control Blockbench for Minecraft 3D modeling, including project creation, cube placement, UV layout, and texture painting.GPL 3.0
- AlicenseNot gradedqualityBmaintenanceEnables AI clients to control Blockbench for 3D modeling, including geometry, UV, texturing, animation, procedural generation, quality gates, and human review via 95 tools over HTTP or stdio.MIT
- AlicenseNot gradedqualityCmaintenanceEnables AI agents to build, texture, rig, and animate models in a live Blockbench editor through high-level workflow tools for rig construction, face painting, multi-angle capture, animation presets, and model auditing. Also provides a headless stdio mode that edits, validates, converts, and renders .bbmodel files without the editor running.GPL 3.0