Implementation
gradeNot graded
gradeNot graded
get_building_guideAnswer
Call this once before your first world-related action. Explains the voxel sandbox, your administrator-like editing capabilities, required workflow, tool choice, construction principles, player traversal constraints, and material guidance. Then call get_world_info for current bounds and available blocks.
View tool JSON
{
"name": "get_building_guide",
"kind": "answer",
"impl": "imperative",
"description": "Call this once before your first world-related action. Explains the voxel sandbox, your administrator-like editing capabilities, required workflow, tool choice, construction principles, player traversal constraints, and material guidance. Then call get_world_info for current bounds and available blocks.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}get_world_infoAnswer
Call this before planning a build. Returns the editable world bounds, coordinate system, generator, game mode, current world revision, and the single authoritative block catalog with human-readable labels, texture meanings, and physical or visual traits. Material characteristics live here rather than being repeated in every editing tool.
View tool JSON
{
"name": "get_world_info",
"kind": "answer",
"impl": "imperative",
"description": "Call this before planning a build. Returns the editable world bounds, coordinate system, generator, game mode, current world revision, and the single authoritative block catalog with human-readable labels, texture meanings, and physical or visual traits. Material characteristics live here rather than being repeated in every editing tool.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}get_playerAnswer
Returns the player position, cardinal coordinate basis, camera orientation, targeted block, and current world revision. Use this before interpreting relative requests such as in front, left, or on this wall.
View tool JSON
{
"name": "get_player",
"kind": "answer",
"impl": "imperative",
"description": "Returns the player position, cardinal coordinate basis, camera orientation, targeted block, and current world revision. Use this before interpreting relative requests such as in front, left, or on this wall.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}scan_regionAnswer
Reads authoritative voxel geometry. Select exactly one region form: center plus radius for exploration, or inclusive from plus to corners. Summary is cheapest; heightmap shows terrain; slices return coordinate-addressable ASCII plans or elevations. Air is omitted from summaries and represented by a dot in grids.
View tool JSON
{
"name": "scan_region",
"kind": "answer",
"impl": "imperative",
"description": "Reads authoritative voxel geometry. Select exactly one region form: center plus radius for exploration, or inclusive from plus to corners. Summary is cheapest; heightmap shows terrain; slices return coordinate-addressable ASCII plans or elevations. Air is omitted from summaries and represented by a dot in grids.",
"inputSchema": {
"type": "object",
"properties": {
"from": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 3,
"maxItems": 3,
"description": "Inclusive minimum or first corner [x, y, z]."
},
"to": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 3,
"maxItems": 3,
"description": "Inclusive maximum or opposite corner [x, y, z]."
},
"center": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 3,
"maxItems": 3,
"description": "Center voxel [x, y, z]."
},
"radius": {
"type": "integer",
"minimum": 0,
"maximum": 19
},
"mode": {
"type": "string",
"enum": [
"summary",
"heightmap",
"slices"
],
"default": "summary"
},
"axis": {
"type": "string",
"enum": [
"x",
"y",
"z"
],
"default": "y"
},
"slice_positions": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 1,
"maxItems": 16,
"description": "Absolute coordinates on the chosen axis. Defaults to the region midpoint."
}
},
"oneOf": [
{
"required": [
"from",
"to"
]
},
{
"required": [
"center",
"radius"
]
}
],
"additionalProperties": false
}
}fill_regionAction
Fills an inclusive box with a block. Solid fills every voxel, walls fills only four vertical sides, and shell fills all six faces. One call creates one undo step.
View tool JSON
{
"name": "fill_region",
"kind": "act",
"impl": "imperative",
"description": "Fills an inclusive box with a block. Solid fills every voxel, walls fills only four vertical sides, and shell fills all six faces. One call creates one undo step.",
"inputSchema": {
"type": "object",
"properties": {
"from": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 3,
"maxItems": 3,
"description": "Inclusive minimum or first corner [x, y, z]."
},
"to": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 3,
"maxItems": 3,
"description": "Inclusive maximum or opposite corner [x, y, z]."
},
"block": {
"type": "string",
"enum": [
"air",
"barrier",
"bedrock",
"birch_leaves",
"birch_log",
"birch_planks",
"black_concrete",
"black_stained_glass",
"black_wool",
"blue_concrete",
"blue_stained_glass",
"blue_wool",
"bookshelf",
"bricks",
"brown_concrete",
"brown_stained_glass",
"brown_wool",
"cactus",
"coal_ore",
"cobblestone",
"crafting",
"cyan_concrete",
"cyan_stained_glass",
"cyan_wool",
"deadbush",
"diamond_block",
"diamond_ore",
"dirt",
"glass",
"gold_block",
"grass",
"grass_plant",
"grass_plant_yellow",
"grass_snow",
"grass_yellow",
"gravel",
"gray_concrete",
"gray_stained_glass",
"gray_wool",
"green_concrete",
"green_stained_glass",
"green_wool",
"ice",
"iron_block",
"iron_ore",
"lapis_block",
"lapis_ore",
"leaves",
"leaves_yellow",
"light_blue_concrete",
"light_blue_stained_glass",
"light_blue_wool",
"lime_concrete",
"lime_stained_glass",
"lime_wool",
"log",
"magenta_concrete",
"magenta_stained_glass",
"magenta_wool",
"mossy_cobblestone",
"mossy_stonebricks",
"oak_sapling",
"obsidian",
"orange_concrete",
"orange_stained_glass",
"orange_wool",
"pink_concrete",
"pink_stained_glass",
"pink_wool",
"planks",
"pumpkin",
"purple_concrete",
"purple_stained_glass",
"purple_wool",
"red_concrete",
"red_flower",
"red_stained_glass",
"red_wool",
"sand",
"sandstone",
"snow",
"spruce_leaves",
"spruce_log",
"spruce_planks",
"stone",
"stonebrick",
"tnt",
"water",
"white_concrete",
"white_stained_glass",
"white_wool",
"yellow_concrete",
"yellow_flower",
"yellow_stained_glass",
"yellow_wool"
]
},
"shape": {
"type": "string",
"enum": [
"solid",
"walls",
"shell"
],
"default": "solid"
},
"delay_ms": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"default": 0,
"description": "Delay in milliseconds between visible block changes. Use 0 for an instant edit. The total requested animation delay may not exceed 60000 milliseconds."
}
},
"required": [
"from",
"to",
"block"
],
"additionalProperties": false
}
}replace_blocksAction
Replaces every occurrence of one block with another inside an inclusive box. One call creates one undo step.
View tool JSON
{
"name": "replace_blocks",
"kind": "act",
"impl": "imperative",
"description": "Replaces every occurrence of one block with another inside an inclusive box. One call creates one undo step.",
"inputSchema": {
"type": "object",
"properties": {
"from": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 3,
"maxItems": 3,
"description": "Inclusive minimum or first corner [x, y, z]."
},
"to": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 3,
"maxItems": 3,
"description": "Inclusive maximum or opposite corner [x, y, z]."
},
"from_block": {
"type": "string",
"enum": [
"air",
"barrier",
"bedrock",
"birch_leaves",
"birch_log",
"birch_planks",
"black_concrete",
"black_stained_glass",
"black_wool",
"blue_concrete",
"blue_stained_glass",
"blue_wool",
"bookshelf",
"bricks",
"brown_concrete",
"brown_stained_glass",
"brown_wool",
"cactus",
"coal_ore",
"cobblestone",
"crafting",
"cyan_concrete",
"cyan_stained_glass",
"cyan_wool",
"deadbush",
"diamond_block",
"diamond_ore",
"dirt",
"glass",
"gold_block",
"grass",
"grass_plant",
"grass_plant_yellow",
"grass_snow",
"grass_yellow",
"gravel",
"gray_concrete",
"gray_stained_glass",
"gray_wool",
"green_concrete",
"green_stained_glass",
"green_wool",
"ice",
"iron_block",
"iron_ore",
"lapis_block",
"lapis_ore",
"leaves",
"leaves_yellow",
"light_blue_concrete",
"light_blue_stained_glass",
"light_blue_wool",
"lime_concrete",
"lime_stained_glass",
"lime_wool",
"log",
"magenta_concrete",
"magenta_stained_glass",
"magenta_wool",
"mossy_cobblestone",
"mossy_stonebricks",
"oak_sapling",
"obsidian",
"orange_concrete",
"orange_stained_glass",
"orange_wool",
"pink_concrete",
"pink_stained_glass",
"pink_wool",
"planks",
"pumpkin",
"purple_concrete",
"purple_stained_glass",
"purple_wool",
"red_concrete",
"red_flower",
"red_stained_glass",
"red_wool",
"sand",
"sandstone",
"snow",
"spruce_leaves",
"spruce_log",
"spruce_planks",
"stone",
"stonebrick",
"tnt",
"water",
"white_concrete",
"white_stained_glass",
"white_wool",
"yellow_concrete",
"yellow_flower",
"yellow_stained_glass",
"yellow_wool"
]
},
"to_block": {
"type": "string",
"enum": [
"air",
"barrier",
"bedrock",
"birch_leaves",
"birch_log",
"birch_planks",
"black_concrete",
"black_stained_glass",
"black_wool",
"blue_concrete",
"blue_stained_glass",
"blue_wool",
"bookshelf",
"bricks",
"brown_concrete",
"brown_stained_glass",
"brown_wool",
"cactus",
"coal_ore",
"cobblestone",
"crafting",
"cyan_concrete",
"cyan_stained_glass",
"cyan_wool",
"deadbush",
"diamond_block",
"diamond_ore",
"dirt",
"glass",
"gold_block",
"grass",
"grass_plant",
"grass_plant_yellow",
"grass_snow",
"grass_yellow",
"gravel",
"gray_concrete",
"gray_stained_glass",
"gray_wool",
"green_concrete",
"green_stained_glass",
"green_wool",
"ice",
"iron_block",
"iron_ore",
"lapis_block",
"lapis_ore",
"leaves",
"leaves_yellow",
"light_blue_concrete",
"light_blue_stained_glass",
"light_blue_wool",
"lime_concrete",
"lime_stained_glass",
"lime_wool",
"log",
"magenta_concrete",
"magenta_stained_glass",
"magenta_wool",
"mossy_cobblestone",
"mossy_stonebricks",
"oak_sapling",
"obsidian",
"orange_concrete",
"orange_stained_glass",
"orange_wool",
"pink_concrete",
"pink_stained_glass",
"pink_wool",
"planks",
"pumpkin",
"purple_concrete",
"purple_stained_glass",
"purple_wool",
"red_concrete",
"red_flower",
"red_stained_glass",
"red_wool",
"sand",
"sandstone",
"snow",
"spruce_leaves",
"spruce_log",
"spruce_planks",
"stone",
"stonebrick",
"tnt",
"water",
"white_concrete",
"white_stained_glass",
"white_wool",
"yellow_concrete",
"yellow_flower",
"yellow_stained_glass",
"yellow_wool"
]
},
"delay_ms": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"default": 0,
"description": "Delay in milliseconds between visible block changes. Use 0 for an instant edit. The total requested animation delay may not exceed 60000 milliseconds."
}
},
"required": [
"from",
"to",
"from_block",
"to_block"
],
"additionalProperties": false
}
}set_blocksAction
Sets up to 2048 explicit voxel positions in one atomic editing operation. Use for stairs, roofs, arches, diagonals, and other geometry boxes express poorly. Later duplicate positions win. One call creates one undo step.
View tool JSON
{
"name": "set_blocks",
"kind": "act",
"impl": "imperative",
"description": "Sets up to 2048 explicit voxel positions in one atomic editing operation. Use for stairs, roofs, arches, diagonals, and other geometry boxes express poorly. Later duplicate positions win. One call creates one undo step.",
"inputSchema": {
"type": "object",
"properties": {
"blocks": {
"type": "array",
"minItems": 1,
"maxItems": 2048,
"items": {
"type": "object",
"properties": {
"position": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 3,
"maxItems": 3
},
"block": {
"type": "string",
"enum": [
"air",
"barrier",
"bedrock",
"birch_leaves",
"birch_log",
"birch_planks",
"black_concrete",
"black_stained_glass",
"black_wool",
"blue_concrete",
"blue_stained_glass",
"blue_wool",
"bookshelf",
"bricks",
"brown_concrete",
"brown_stained_glass",
"brown_wool",
"cactus",
"coal_ore",
"cobblestone",
"crafting",
"cyan_concrete",
"cyan_stained_glass",
"cyan_wool",
"deadbush",
"diamond_block",
"diamond_ore",
"dirt",
"glass",
"gold_block",
"grass",
"grass_plant",
"grass_plant_yellow",
"grass_snow",
"grass_yellow",
"gravel",
"gray_concrete",
"gray_stained_glass",
"gray_wool",
"green_concrete",
"green_stained_glass",
"green_wool",
"ice",
"iron_block",
"iron_ore",
"lapis_block",
"lapis_ore",
"leaves",
"leaves_yellow",
"light_blue_concrete",
"light_blue_stained_glass",
"light_blue_wool",
"lime_concrete",
"lime_stained_glass",
"lime_wool",
"log",
"magenta_concrete",
"magenta_stained_glass",
"magenta_wool",
"mossy_cobblestone",
"mossy_stonebricks",
"oak_sapling",
"obsidian",
"orange_concrete",
"orange_stained_glass",
"orange_wool",
"pink_concrete",
"pink_stained_glass",
"pink_wool",
"planks",
"pumpkin",
"purple_concrete",
"purple_stained_glass",
"purple_wool",
"red_concrete",
"red_flower",
"red_stained_glass",
"red_wool",
"sand",
"sandstone",
"snow",
"spruce_leaves",
"spruce_log",
"spruce_planks",
"stone",
"stonebrick",
"tnt",
"water",
"white_concrete",
"white_stained_glass",
"white_wool",
"yellow_concrete",
"yellow_flower",
"yellow_stained_glass",
"yellow_wool"
]
}
},
"required": [
"position",
"block"
],
"additionalProperties": false
}
},
"delay_ms": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"default": 0,
"description": "Delay in milliseconds between visible block changes. Use 0 for an instant edit. The total requested animation delay may not exceed 60000 milliseconds."
}
},
"required": [
"blocks"
],
"additionalProperties": false
}
}copy_regionAction
Copies an inclusive source box, including air, with optional mirroring and clockwise y-axis rotation. Destination is the minimum corner of the transformed output box. The source is snapshotted first, so overlap is safe. One call creates one undo step.
View tool JSON
{
"name": "copy_region",
"kind": "act",
"impl": "imperative",
"description": "Copies an inclusive source box, including air, with optional mirroring and clockwise y-axis rotation. Destination is the minimum corner of the transformed output box. The source is snapshotted first, so overlap is safe. One call creates one undo step.",
"inputSchema": {
"type": "object",
"properties": {
"from": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 3,
"maxItems": 3,
"description": "Inclusive minimum or first corner [x, y, z]."
},
"to": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 3,
"maxItems": 3,
"description": "Inclusive maximum or opposite corner [x, y, z]."
},
"destination": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 3,
"maxItems": 3,
"description": "Minimum corner of the transformed output box [x, y, z]."
},
"mirror": {
"type": "string",
"enum": [
"none",
"x",
"z",
"xz"
],
"default": "none",
"description": "Reverse the source-local x coordinate, z coordinate, or both before rotation."
},
"rotation": {
"type": "integer",
"enum": [
0,
90,
180,
270
],
"default": 0,
"description": "Clockwise rotation in degrees around the y axis when viewed from above."
},
"delay_ms": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"default": 0,
"description": "Delay in milliseconds between visible block changes. Use 0 for an instant edit. The total requested animation delay may not exceed 60000 milliseconds."
}
},
"required": [
"from",
"to",
"destination"
],
"additionalProperties": false
}
}move_regionAction
Moves an inclusive source box, including air, with optional mirroring and clockwise y-axis rotation, then clears non-overlapping source voxels to air. Destination is the minimum corner of the transformed output box. Overlap is safe. One call creates one undo step.
View tool JSON
{
"name": "move_region",
"kind": "act",
"impl": "imperative",
"description": "Moves an inclusive source box, including air, with optional mirroring and clockwise y-axis rotation, then clears non-overlapping source voxels to air. Destination is the minimum corner of the transformed output box. Overlap is safe. One call creates one undo step.",
"inputSchema": {
"type": "object",
"properties": {
"from": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 3,
"maxItems": 3,
"description": "Inclusive minimum or first corner [x, y, z]."
},
"to": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 3,
"maxItems": 3,
"description": "Inclusive maximum or opposite corner [x, y, z]."
},
"destination": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 3,
"maxItems": 3,
"description": "Minimum corner of the transformed output box [x, y, z]."
},
"mirror": {
"type": "string",
"enum": [
"none",
"x",
"z",
"xz"
],
"default": "none",
"description": "Reverse the source-local x coordinate, z coordinate, or both before rotation."
},
"rotation": {
"type": "integer",
"enum": [
0,
90,
180,
270
],
"default": 0,
"description": "Clockwise rotation in degrees around the y axis when viewed from above."
},
"delay_ms": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"default": 0,
"description": "Delay in milliseconds between visible block changes. Use 0 for an instant edit. The total requested animation delay may not exceed 60000 milliseconds."
}
},
"required": [
"from",
"to",
"destination"
],
"additionalProperties": false
}
}stack_regionAction
Repeats an inclusive source box, including air, directly adjacent to itself count times in a cardinal direction. Count excludes the original. One call creates one undo step.
View tool JSON
{
"name": "stack_region",
"kind": "act",
"impl": "imperative",
"description": "Repeats an inclusive source box, including air, directly adjacent to itself count times in a cardinal direction. Count excludes the original. One call creates one undo step.",
"inputSchema": {
"type": "object",
"properties": {
"from": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 3,
"maxItems": 3,
"description": "Inclusive minimum or first corner [x, y, z]."
},
"to": {
"type": "array",
"items": {
"type": "integer"
},
"minItems": 3,
"maxItems": 3,
"description": "Inclusive maximum or opposite corner [x, y, z]."
},
"count": {
"type": "integer",
"minimum": 1,
"maximum": 16
},
"direction": {
"type": "string",
"enum": [
"up",
"down",
"north",
"south",
"east",
"west"
]
},
"delay_ms": {
"type": "integer",
"minimum": 0,
"maximum": 100,
"default": 0,
"description": "Delay in milliseconds between visible block changes. Use 0 for an instant edit. The total requested animation delay may not exceed 60000 milliseconds."
}
},
"required": [
"from",
"to",
"count",
"direction"
],
"additionalProperties": false
}
}undoAction
Undoes the most recent WebMCP editing calls using WorldEdit semantics. Each prior write tool call is one step.
View tool JSON
{
"name": "undo",
"kind": "act",
"impl": "imperative",
"description": "Undoes the most recent WebMCP editing calls using WorldEdit semantics. Each prior write tool call is one step.",
"inputSchema": {
"type": "object",
"properties": {
"count": {
"type": "integer",
"minimum": 1,
"maximum": 20,
"default": 1
}
},
"additionalProperties": false
}
}