Awesome Mineflayer MCP

Determine the best harvest tool currently in inventory for the block at the given coordinates, without equipping it. Returns null if no tool is better than hand.

Inspect the block at a world coordinate. Returns name/position and (detailed) hardness, diggability, line-of-sight, estimated dig time and sign text. Returns name 'air'/null-ish if the chunk is unloaded.

Scan a bounded box [min..max] (inclusive) and return non-air blocks, optionally filtered to specific block names. Volume is capped at 32768 blocks; shrink the box if you hit the cap.

List active boss bars with title, health, color, dividers and flags. Returns [] if none.

List the bot's registered chat patterns ({name?, type?, description?, pattern}). Pattern regexes are stringified.

Report the connection lifecycle state (disconnected/connecting/online/reconnecting), username, version, dimension, vitals, position, and last end/kick reason. Safe to call when not connected.

Return the bot's seven movement control booleans: forward, back, left, right, jump, sprint, sneak.

Raycast from the bot's eyes along its look direction. Returns the first block hit and (if includeEntity) the entity being aimed at.

Show the configured default account used for autonomous startup (host, port, username, auth mode, autoConnect). No passwords are stored or returned.

Get full details for a single tracked entity by its network id.

Drain buffered game events (chat, deaths, block/entity changes, goal_reached, etc.). Pass the returned `nextSince` on the next call to read only new events without gaps. `dropped:true` means the buffer overflowed and some events between your `since` and now were lost.

List the bot's inventory: held item/slot, all carried items, armor slots, off-hand, and free/total slot counts.

Report which mineflayer ecosystem plugins are attached to the bot.

One-call situational snapshot for an agent's observe loop: connection status, self vitals/position, held item + inventory, nearby entities, and recent/new events. Replaces calling get_state + get_inventory + list_entities + get_events separately. Pass `since` (a prior events.nextSince) to get only new events; otherwise a recent tail is returned with nextSince to start paginating.

Compute (but do not execute) a path to a goal and report its status/cost/timing without moving the bot. Useful to test reachability before committing to `goto`.

Return whether physics is enabled plus the physics constants (gravity, speeds, etc.) as primitive fields.

List active scoreboards with their name, title and items ({name,value}). Optionally filter to a single display slot.

Capture a REAL screenshot of what the bot actually sees — the textured 3D Minecraft world from its eyes (first person) or an orbit view (third person) — as a PNG image. This is an actual game render, not a schematic. Requires the optional screenshot extras (prismarine-viewer + a headless browser via Playwright); if they're missing it returns UNSUPPORTED with install steps. The bot must be in loaded chunks. First call is slower (launches the renderer/browser).

Return the bot's current game settings (view distance, chat flags, skin parts, etc.).

Snapshot the bot's own state: position, velocity, orientation, health/food, gamemode, dimension, held item, time/weather, control state and active effects.

List scoreboard teams with friendlyFire, nameTagVisibility, color, prefix, suffix and members. Optionally filter to one team.

Navigate to a goal using the pathfinder and block until arrival (or timeout). Supports block/near/xz/nearxz/y/getToBlock/lookAtBlock/placeBlock and composite_any/composite_all/invert (nested via `goals`). Cancellable; throws NO_PATH if unreachable, TIMEOUT if it takes too long.

Navigate to a saved waypoint by name (pathfinds and blocks until arrival). Cancellable; throws NO_PATH if unreachable, TIMEOUT if it takes too long.

List nearby tracked entities, nearest-first, filtered by type/kind/mobType/username/name and/or maxDistance.

List players currently visible in the tablist with username, display name, gamemode, ping and (if tracked) entity id/position.

List crafting recipes for an item. By default returns only recipes craftable with the bot's current inventory (recipesFor); set includeUnavailable to list every known recipe (recipesAll). Set useCraftingTable to consider table-only recipes using a crafting table within 4 blocks.

List all saved waypoints.

Set the bot's absolute head orientation in radians (yaw, pitch).

Aim the bot's head at a world point (x,y,z). Use `force` to snap instantly instead of turning smoothly over time.

Aim the bot's head at a tracked entity (by id), targeting its approximate eye height. Re-call to keep tracking a moving target.

Mount a rideable entity (boat, minecart, horse, etc.) identified by its network id.

Move the stack in `sourceSlot` to `destSlot` within the open window/inventory. If `destSlot` is omitted, put the item away into the main inventory (out of the hotbar/crafting/armor area).

Open a chest/barrel/shulker/dispenser/hopper at a block coordinate (x,y,z) or a container entity (entityId, e.g. a chest minecart). Keeps the window open as the active container session for read_open_container / container_deposit / container_withdraw until close_window.

Open the furnace (or blast furnace / smoker) at the given coordinates and return its current contents. Keeps the window open for subsequent furnace_action / furnace_status calls.

Walk up to and open trading with a villager entity (by id). Returns the list of trades with their input/output items, indices, disabled flag and max uses. Use trade_with_villager to execute a trade.

Report the pathfinder's current activity: isMoving, isMining, isBuilding, and whether a goal is set.

Place a block (or entity, e.g. boat/minecart) against a reference block's face. Equips `itemName` first if given. faceVector is the unit direction from the reference block toward the new block.

Continuously attack a target entity using the pvp plugin (pathfinds into range and keeps swinging). Resolves when the target dies or is lost. Long-running and cancellable. Provide an entityId, or a `target` filter (type/name/username) to pick the nearest match.

Configure pvp plugin parameters: followRange, attackRange, viewDistance, and meleeMode ('maxDamage' waits for the weapon cooldown for max damage; 'fast' attacks as quickly as possible). Returns the current numeric config.

Stop the current pvp attack. By default stops gracefully; pass force to hard-stop the pathfinder. Also cancels the active long-running action lock.

Read the contents of the currently-open container: its own slots (containerItems) and the bot's inventory slots (inventoryItems). Throws NO_WINDOW if no container is open.

Disconnect (if connected) and reconnect using the last connection options, optionally overriding some of them.

Register a named chat pattern (regex). When a matching chat line arrives, it is emitted as a `chat:<name>` event (drain with get_events). Pass an array of patterns to register a pattern set under one name.

Remove a previously registered chat pattern by its name or numeric id.

Render a colored top-down map (or a horizontal cross-section) of the area around the bot as a PNG image — a lightweight schematic overview (no extra dependencies). For a real textured first-person game render, use `get_screenshot` instead. North (−Z) is up, West (−X) is left. The bot is the white dot in the center with a dark facing tick; players are cyan, hostile mobs red, passive mobs yellow, items grey. mode "surface" (default) shows the topmost block of each column with height shading; mode "slice" shows a single Y layer (great for caves/mining — air reads light, walls dark). Returns the image plus a text legend of the block types shown.

Manually respawn after death (only needed when the bot was connected with respawn:false).

Run a server slash command. A leading `/` is added automatically if omitted. Some administrative commands (op, ban, stop, …) may be blocked by the server's command policy (see MCP_COMMAND_DENY / MCP_COMMAND_ALLOW).

Set persistent collectblock defaults: the chest locations to deposit into when full, and the item filter (depositItems or keepItems) used for those deposits.

Hold or release a single low-level movement control (forward/back/left/right/jump/sprint/sneak). Manual control; conflicts with active pathfinding.

Set a pathfinder goal without waiting (fire-and-forget). The bot keeps moving toward it in the background. Use `dynamic` for goals that should recompute as the world/target changes.