Blockbench MCP

Tools 60 of 75

11 only read, 44 change things, 5 can delete or overwrite. A ? marks an optional parameter.

get_status

Report whether Blockbench is connected, its version, plugin version, 5.2 features and common folders

blockbench_window changes

Show, hide or check the Blockbench window (Windows only)action: enum

list_formats

List Blockbench's model formats and what each supports

create_project changes

Start a project in a chosen format, including Minecraft skins and Hytale formatsformat?: stringname?: stringmodel_identifier?: stringtexture_width?: numbertexture_height?: numberskin_model?: stringskin_variant?: stringskin_edition?: enumskin_resolution?: numberskin_pose?: boolean

project_file deletes

Open, save, export, import, read JSON, switch or close project tabsaction: enum

add_groups changes

Create groups that work as bonesgroups: array

add_cubes changes

Add cubes, with optional mirrored copiescubes: arraytexture?: string

add_meshes changes

Add custom meshes from vertices and facesmeshes: array

add_mesh_primitive changes

Add a cylinder, sphere, torus or other primitive meshshape: enumname?: stringparent?: stringposition?: arrayrotation?: arraydiameter?: numberheight?: numbersides?: numberminor_diameter?: numberdetail?: numbertexture?: string

add_loft changes

Build a limb or tube mesh from a chain of cross-section ringsname?: stringrings: arrayprofile?: anysides?: numbercaps?: enumside?: arrayparent?: stringposition?: arrayrotation?: arraytexture?: string

edit_mesh changes

Run extrude, inset, loop cut, bevel and similar steps on a meshmesh: stringsteps: array

transform_mesh changes

Taper, bend, twist or otherwise deform meshes with falloffmesh?: stringmeshes?: arrayselect?: anyfalloff?: objectops: array

add_planes changes

Add flat planes or strips for thin parts such as fur or leavesplanes?: arraystrips?: arraytexture?: string

add_bounding_boxes changes

Add bounding boxes (needs Blockbench 5.2)boxes: array

add_ik_controllers changes

Add inverse-kinematics controllers to bonescontrollers: array

bake_ik_animation changes

Turn IK-driven motion into plain rotation keyframesanimation?: stringdetach_controllers?: boolean

mirror_elements changes

Mirror elements in place or as copies across an axisids: arrayaxis?: enumcenter?: numberduplicate?: booleanrename?: boolean

validate_model

Check for intersecting parts, detached parts and other model faultsanimation?: stringtimes?: arraytolerance?: numberinclude_same_bone?: booleanmax_pairs?: numberchecks?: booleanintersections?: booleandetached?: boolean

query_geometry

Measure element and bone positions, at rest or at animation timeselements?: arrayanimation?: stringtime?: numbertimes?: arrayinclude_elements?: booleaninclude_bones?: boolean

list_outline

List the model's element treeinclude_elements?: booleanmax_depth?: number

update_elements changes

Change position, size, faces or other properties of elementselements: array

delete_elements deletes

Remove elements from the modelids: array

create_texture changes

Create a texture, blank, filled or from image dataname: stringwidth?: numberheight?: numberfill_color?: stringdata?: stringpbr_channel?: enumrender_mode?: enumparticle?: booleanforce_translucent?: booleanapply_to_all?: boolean

generate_texture_template changes

Lay out a texture template so each face gets its own UV spacename?: stringpixel_density?: numberelements?: arrayrearrange_uv?: booleanpower_of_two?: booleanpadding?: booleancolor?: string

delete_texture deletes

Remove a texture from the projectid: string

get_texture

Return a texture image, or an enlarged crop of one faceid?: stringmax_size?: numberelement?: stringface?: anyfaces?: anypadding?: numberlayer?: string

texture_layers changes

Add, reorder, merge or group texture layerstexture?: stringops?: array

import_texture changes

Load a texture from an image filepath: stringforce_translucent?: boolean

apply_texture changes

Assign a texture to elementstexture: stringelements?: arraymode?: enum

paint_texture changes

Paint fills, shapes, gradients and noise onto a texturetexture?: stringlayer?: stringops: array

paint_faces changes

Paint chosen faces of cubes or meshestargets: arraytexture?: stringlayer?: string

unwrap_mesh changes

Unwrap mesh UVs into islands, with seams and per-part densityelements?: arraypixel_density?: numberdensity_scale?: objectseams?: arrayseam_angle?: numberisland_angle?: numbercombine?: booleankeep_paint?: booleanpadding?: booleanpower_of_two?: booleancolor?: stringname?: string

uv changes

Inspect UVs, or set cube, mesh or automatic UVsaction: enum

bake_texture changes

Bake light, ambient occlusion and edge shading into a texture layerelements?: arraytexture?: stringlayer?: stringsource?: stringpasses?: arraymax_shadow?: numbermax_highlight?: numberdither?: enumramp?: objectonly_painted?: boolean

blend_seams changes

Soften colour seams across face edges and UV cutselements?: arraytexture?: stringwidth?: numberstrength?: numbermax_angle?: numberbetween?: enumlayer?: stringonly_painted?: boolean

palette changes

Make colour ramps, pull colours from a texture or limit a texture to a paletteaction: enumcolors?: arraycolor?: stringshadows?: numberhighlights?: numberramp?: objecttexture?: stringlayer?: stringpalette?: anymax_colors?: numberdither?: enumdither_strength?: numberbinary_alpha?: boolean

compare_reference

Score the model's silhouette against the loaded reference imagebands?: numberthreshold?: number

project_reference changes

Project a reference image onto the visible texture pixelselements?: arraylayer?: stringopacity?: numbermin_facing?: number

record_build changes

Record edits as frames and write a GIF of the buildaction: enumview?: stringyaw?: numberpitch?: numbersize?: numberheight_units?: numberbackground?: stringlabel?: stringpath?: stringfps?: numberhold_last?: number

create_animation changes

Create an animationname: stringloop?: enumlength?: numbersnapping?: numberoverride?: booleananim_time_update?: stringblend_weight?: stringstart_delay?: stringloop_delay?: string

set_keyframes changes

Add keyframes to bones, as numbers or Molang expressionsanimation?: stringsnap?: booleanbones: array

edit_keyframes deletes

Retime, rescale, delete or change interpolation of keyframesanimation?: stringbone?: stringchannel?: enumtime_range?: arrayrelative_to_playhead?: enumplayhead?: numberdelete?: booleanset_time?: numbertime_offset?: numbertime_scale?: numbersnap?: booleanresize_to_content?: booleanset_interpolation?: enumset_values?: anyvalue_multiplier?: number

mirror_keyframes changes

Copy keyframes to the matching left or right boneanimation?: stringmappings?: arrayphase_offset?: numberchannels?: arraymirror_values?: booleanreplace?: booleanwrap?: boolean

add_effect_keyframes changes

Add sound, particle or timeline keyframesanimation?: stringeffects: array

apply_animation_preset changes

Apply a ready motion such as float, swing or walk to a boneanimation?: stringbone: stringpreset: string

variable_placeholders changes

Set Molang variable placeholders (needs Blockbench 5.2)text?: stringadd?: arrayvalues?: object

preview_animation

Capture the model at one moment of an animationanimation?: stringtime: numberangle?: stringcamera?: anyresolution?: number

render_animation

Capture several frames of an animation as imagesanimation?: stringframes?: numbertimes?: arrayangle?: stringcamera?: anyresolution?: number

add_armature changes

Build an armature of bones for skinned meshes and weight themname?: stringarmature?: stringbones?: arraymeshes?: arrayauto_weights?: booleanweight_method?: enumblend?: numbermax_bones?: number

vertex_weights changes

Compute, set, smooth, normalize, clear or inspect vertex weightsaction: enum

smooth_mesh changes

Add subdivision and smooth-by-angle modifiers, creases and sharp edges (needs BlockSmooth, except shading)action: enum

generate_pbr_map changes

Make height, normal or MER maps from a colour texturetexture?: stringmaps?: arraylist_presets?: boolean

display_transforms changes

Read or set how an item model sits in each display slotaction: enum

capture_screenshot

Take a viewport screenshot from a chosen angle or view modeangle?: stringcamera?: anyresolution?: numbershading?: booleanbackground?: stringinclude_reference_models?: booleanview_mode?: enum

capture_multi_view

Capture several camera views in one callviews?: arrayresolution?: numberbackground?: stringinclude_reference_models?: boolean

preview_models changes

Show and place Blockbench's reference models, such as the player, beside the modelmodels?: array

reference_images changes

Add, move or remove reference images in the viewportadd?: arrayupdate?: arrayremove?: array

pixel_art changes

Render the model as pixel-art sprites or a sprite sheet with Aseprite JSONaction: enum

run_action changes

Run any built-in Blockbench action by its idid: stringconfirm_dialog?: booleandialog_values?: object

eval_code deletes

Run JavaScript inside Blockbench with access to its APIcode: stringundo?: booleanresult_file?: stringmax_length?: numberallow_native_modules?: boolean