Read the blocks in an area
read_blocksReturns full block states, block entity IDs, and counts for a box in saved Minecraft chunks, so agents can inspect and validate builds without changing the world.
Instructions
Returns the blocks in a box with their full states, block entity ids and a count per block. The server saves the world first and the tool reads the saved chunks, so it changes nothing. Limited to maxReadBlocks per call (32768 by default, for example 32x32x32); read big builds in parts. format "layers" (default) is compact, one line per row; "list" gives every non-air block as [x, y, z, state].
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"from": "<from>",
"to": "<to>"
},
"name": "read_blocks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| to | Yes | The opposite corner [x, y, z], inclusive | |
| from | Yes | One corner [x, y, z] | |
| format | No | layers | |
| dimension | No | Dimension. Default overworld. | overworld |