Skip to main content
Glama

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 --register

This will:

  1. Copy the plugin blockbench_mcp.js into Blockbench's plugins folder.

  2. Add it to StateMemory.installed_plugins (Blockbench does not auto-scan the folder) and load it immediately.

  3. If Blockbench isn't running (or is running without a debug port), relaunch it with --remote-debugging-port and inject the plugin over CDP.

Prefer doing it by hand? Copy plugin/build/blockbench_mcp.js into the Blockbench plugins folder and drag the file into the Blockbench window once, confirming the install. --force lets 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 anything

Check everything is in place:

node install.js --status

Open (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)

  1. bb_status — learn the format, mode and contents.

  2. bb_new_project / bb_open_model — create or open a project.

  3. Build: bb_add_cube, bb_add_group, bb_add_mesh. Repeat parts with bb_array_elements, symmetry with bb_mirror_elements (not hand-placed copies).

  4. Textures: bb_create_texture / bb_generate_texture (seeded ops), refine with bb_draw_texture / bb_paint_pixels, assign with bb_set_face_texture, verify with bb_get_texture_pixel.

  5. Look at the result: bb_review renders 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_screenshot are available too.

  6. bb_validate → fix findings → bb_export_model (bbmodel, java_block, bedrock, gltf, obj, fbx, stl, collada, skin…).

  7. bb_execute_js for arbitrary JS inside Blockbench; bb_step batches 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.1 on 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_action and bb_install_plugin can 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.js

Development

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 CDP

After 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. Run node install.js --register and 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 in StateMemory.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_status and bb_project_info.

License: MIT.

Available Tools

72 tools
bb_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

    B3.1/5.0

    Scored across 72 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count1/5

    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.

    Completeness4/5

    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

    ActivitySlowing
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Enables AI assistants to control Blockbench for Minecraft 3D modeling, including project creation, cube placement, UV layout, and texture painting.
      GPL 3.0
    • A
      license
      Not graded
      quality
      B
      maintenance
      Enables 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
    • A
      license
      Not graded
      quality
      C
      maintenance
      Enables 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