TOOLS REFERENCE

39 MCP TOOLS

Most tools take username (the bot name) and return JSON with success or error plus tool-specific fields. Fleet status and waypoint tools expose process-local coordination state for multi-bot planning. This is the one-liner index — full parameter-level docs live in the repo's docs/TOOLS.md.

CONNECTION

4 tools
minecraft_join
Spawn a new bot on the server.
minecraft_leave
Cleanly disconnect a bot.
minecraft_bots
List active bots + status (position, health, queue, follow target, last error).
minecraft_fleet_status
Read a sanitized snapshot of every bot, reservation, waypoint, and recent conflict.

CHAT

3 tools
minecraft_chat
Send a chat line (/commands work too if the bot has perms).
minecraft_emote
Send /me <emote>.
minecraft_messages
Recent chat lines received by a bot, with timestamps + sender.

MOVEMENT & LOOKING

8 tools
minecraft_move
A* pathfind to a coordinate; poll last_move_result for status.
minecraft_goto_waypoint
Pathfind to a named waypoint with corridor reservation enabled by default.
minecraft_goto_player
Pathfind to another visible player and arrive within range.
minecraft_look
Set yaw/pitch in degrees.
minecraft_jump
Single jump impulse.
minecraft_get_position
Position, yaw/pitch, health, food, last move result.
minecraft_follow_player
Follow another player continuously.
minecraft_stop
Drop all goals, clear the task queue, release control states.

FLEET PLANNING

3 tools
minecraft_set_waypoint
Register an immutable shared target for the current world.
minecraft_remove_waypoint
Remove a named waypoint from future selection without cancelling active movement.
minecraft_fleet_assign
Queue a gather/build task on the eligible bot with the shortest queue; ties break by username.

WORLD INTERACTION

5 tools
minecraft_mine_block
Dig the block at a coordinate.
minecraft_place_block
Place a block from the held hotbar slot, auto-picking a reference face.
minecraft_examine
Block info: name, type, hardness at a coordinate.
minecraft_get_surroundings
List non-air blocks within a radius (max 8).
minecraft_find_blocks
Find up to 64 blocks of a named type.

INVENTORY & CONTAINERS

9 tools
minecraft_inventory
Full inventory + currently held item.
minecraft_select_hotbar_slot
Switch hotbar slot (0-8).
minecraft_equip_best
Equip the best tool available for harvesting a target block.
minecraft_open_container
Open a chest / furnace / dispenser block.
minecraft_close_container
Close the currently open window.
minecraft_get_container_contents
List items inside the open window.
minecraft_take_item
Withdraw items from the open container to inventory.
minecraft_put_item
Deposit items from inventory into the open container.
minecraft_craft
Craft an item; auto-finds a crafting table or falls back to 2x2 grid.

COMBAT & PLAYERS

3 tools
minecraft_attack_entity
Attack the nearest hostile mob, or a named target, in reach.
minecraft_set_guard_mode
Toggle auto-attack on hostile mobs within 12 blocks.
minecraft_players
List nearby entities the bot can see.

COMPOSITE TASKS

2 tools
minecraft_gather
Mine up to N blocks of a type within a radius; queued, interruptible.
minecraft_build
Place a blueprint of blocks relative to an origin; queued, interruptible.

SCRIPTED QUEUES

2 tools
minecraft_run_script
Run a sequence of steps as a queue, with optional abort_on_error.
minecraft_queue_status
Inspect the queue: current task + last 100 completed steps.
SCRIPTED QUEUES

CHAIN STEPS TOGETHER

minecraft_run_script runs a queue of steps — move_to, mine, place, look, chat, wait, examine, follow, stop, open_container, close_container, craft, gather, build — with optional abort_on_error. Fleet-aware gather/build queues reserve known block mutations and report explicit reservation conflicts.

{
  "username": "MCPTestBot",
  "abort_on_error": true,
  "steps": [
    { "action": "move_to", "args": { "x": 100, "y": 64, "z": 200 } },
    { "action": "mine",    "args": { "x": 100, "y": 64, "z": 200 } },
    { "action": "chat",    "args": { "message": "got the block" } }
  ]
}