BlockHand MCP server

Read from the package source without running it. The installed server may list more.

• mc_agent_act

  Act in a direction: attack hits a mob, destroy breaks a block and puts it in the inventory, till turns dirt into farmland. repeat runs it several times in a row. …

• mc_agent_collect

  Pick up dropped items near the Agent. Leave item empty to pick up everything. …

• mc_agent_createwrite action

  Spawn the Agent next to the player. Calling it again when the Agent already exists is safe. …

• mc_agent_inventory

  Do one thing with the Agent inventory: count reads the amount in a slot, space reads the room left, detail reads item details, drop drops a quantity, dropAll drops everything in a direction, transfer moves items between slots. …

• mc_agent_move

  Move the Agent steps blocks in a direction, one command per block. A step blocked by a block fails without stopping the rest. …

• mc_agent_place

  Take a block from an inventory slot (1-27) and place it in a direction. Fails when the slot is empty. …

• mc_agent_programwrite action

  Run a sequence of Agent actions in order as one program. This is the main tool for getting real work done with the Agent: laying a path as it walks, digging a tunnel, tilling a whole field. Each step is reported separately, and it can stop at the first failure.

• mc_agent_sense

  Read what is around the Agent without changing the world: inspect reads the block type, inspectData reads the block data value, detect checks whether there is a solid block in that direction, detectRedstone checks for a redstone signal. These are the Agent's eyes; look before acting.

• mc_agent_teleport

  Bring the Agent to the player. Use it to recover the Agent when it is lost, stuck or has fallen into a hole. …

• mc_agent_turn

  Turn the Agent left or right in place, 90 degrees each time. times=2 turns it around. …

• mc_analyze_symmetry

  Check whether a region is symmetric left to right (or front to back), and when it is not, point out **which parts** are not.

• mc_await_connection

  Block until the game connects to the bridge, for at most timeoutSeconds seconds. A timeout is not an error; it just reports connected=false. Call it after asking the user to type /connect.

• mc_blueprint_preview

  Compute only, build nothing: group a block-by-block blueprint by block type and report the total block count and the number of merged fill batches.

• mc_build_blueprint

  Build any form from a list of coordinate -> block entries; identical blocks are merged into the fewest fill commands automatically.

• mc_build_preview

  Compute only, build nothing: report how many blocks the shape uses, where its bounding box is, and how many fill commands it splits into. …

• mc_build_shape

  Build a shape directly in the world. Block coordinates are merged into the fewest fill commands automatically, so a sphere of radius 20 takes a few hundred commands instead of thirty thousand.… …

• mc_clone

  Copy the region from begin to end to destination. cloneMode="move" clears the original. Good for mass-producing a hand-built template.

• mc_compare_regions

  Compare a whole region with one command; good for checking whether a student build matches a reference.

• mc_effect

  action="apply" applies a potion effect; "clear" removes all effects.

• mc_events_catalog

  Return the event names known to work. Mojang does not formally document this list, so subscribing to a name outside it is allowed; it is just marked unverified. No side effects.

• mc_events_poll

  Return the events after a cursor. Use afterCursor=0 the first time, then pass back the nextCursor from the previous call to keep reading.

• mc_events_subscribe

  Start receiving a kind of game event (for example PlayerMessage for chat, BlockPlaced for placed blocks, PlayerTravelled for movement).

• mc_events_unsubscribe

  Stop receiving a kind of event. Events already in the buffer are kept.

• mc_feedback

  Play a sound or spawn a particle effect at a coordinate, to give players immediate sensory feedback.

• mc_fill

  Fill the box from from to to with one kind of block. Bedrock allows at most 32768 blocks per fill; beyond that use mc_build_shape, which splits the work into batches automatically. mode=hollow fills the six outer faces and clears the inside to air; mode=outline replaces only the six outer faces and leaves the inside as it is.

• mc_gamemode

  Switch the target to survival, creative, adventure or spectator.

• mc_give

  Give a target a number of items. To give the Agent something to place, give it to the player first and then hand it to the Agent.

• mc_message

  say posts to everyone in chat, tell sends a private message, title / subtitle / actionbar show large text on screen. Use it to talk to players while teaching or reporting progress.

• mc_player_actionwrite action

  kill kills the target, clear empties the inventory (optionally one item only), xp gives experience, ability turns the worldbuilder / mayfly / mute abilities on or off.

• mc_query_target

  Query the coordinates, facing and unique ID of entities by selector, returned as parsed JSON. This is the standard way to get the current position of the player or the Agent; ask this before building so you know where to build.

• mc_read_block

  Report what is actually at a coordinate, without you having to guess first. Education has no command to read a block,

• mc_run_commandwrite action

  Send one raw slash command, for anything this server has no dedicated tool for. Single line only, no newline chaining. Refuses wsserver / connect / closewebsocket, including when wrapped in execute (that would cut this bridge). The leading slash is optional.

• mc_run_commandswrite action

  Send several raw commands in order; each one passes the command policy on its own. Good for hand-written macros; for many blocks use mc_build_shape or mc_build_blueprint, which merge them into the fewest fill commands automatically.

• mc_set_block

  Place one block at a coordinate. For many blocks use mc_fill or mc_build_shape instead; calling this tool block by block is very slow.

• mc_status

  Report the WebSocket bridge, whether the game is answering commands (commandState), the last reply and timeout times, the /connect command and subscribed events. connected only means the network link is up; timed-out means a recent command got no reply, so do not assume the game can still act. No side effects.

• mc_structure

  Save a region as a named structure, or place a saved structure back into the world. This is the official way to keep what the AI built, mass-produce it, or take it to another world.

• mc_summon

  Spawn one entity at a coordinate, optionally with a name tag. Leave position empty to spawn it where the command runs.

• mc_teleport

  Teleport the targets of a selector to a coordinate. target defaults to @s, the player running the commands.

• mc_test_block

  Report whether a coordinate holds the given block, without changing the world. Use it to check the terrain before building or to verify what was just built.

• mc_ticking_area

  Keep a region loaded so its mechanisms keep running after the player leaves. Needed when the Agent works on its own far away.

• mc_undo

  Undo the last protected setblock/fill or build tool call; several build commands count as one step. All target blocks are checked first, then each region is restored with conditional commands so later changes are not overwritten. operationId guards against undoing the wrong version. Use overwriteChanges only when the user explicitly asks to overwrite conflicts, or accepts restoring the site after

• mc_undo_control
• mc_verify_reading

  Block reading relies on the testforblock **failure message** revealing the block name, and that message format has no official stability guarantee.

• mc_world_settings

  Change one world setting at a time: time sets the time (day/night/noon/midnight or a tick count), weather the weather, gamerule a game rule, difficulty the difficulty.

• Code scan77 source files scanned25/25
• –Live reliabilityno gateway calls yet and no remote to proben/a
• –Tool poisoningtools not inspected (local package is not executed); not countedn/a
• Auth qualitylocal package, no credentials required12/15
• Maintenancelast push 8 days ago15/15
• Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10

Safety score

92/100

higher than 90% of 4,460 AI and agents servers

Tools

44

the typical AI and agents server has 6

Tools that change things

11%

typical: 0%. Fewer write tools means less an agent can break

GitHub stars

3

more than 75% of 2,711 AI and agents servers

Downloads a week

71

more than 55% of 1,538 AI and agents servers with a package

BlockHand: common questions

Is BlockHand MCP server safe?

Yes, by our scan: it is graded A (92/100). Read the BlockHand safety report

How do I install BlockHand?

It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.

Does BlockHand need an API key?

No secret keys are declared. It reads 2 settings from the environment.

Is BlockHand maintained?

The last commit was 16 days ago (2026-10-19). The latest release is v0.1.1.

How does BlockHand compare with other AI and agents MCP servers?

safety score 92/100 (higher than 90% of 4,460 AI and agents servers); tools 44 (the typical AI and agents server has 6); tools that change things 11% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.