Skip to content
denfry edited this page Oct 5, 2026 · 1 revision

Tools

Call get_status first: it reports which side you are on and which groups are available. Server tools need a running server (integrated or dedicated). Client tools only work on the client. Which group needs which lock is on Capability locks and security.

Group Side Tools
info both get_status, list_capabilities
world, read server get_block, get_blocks_region, find_blocks, get_time_and_weather, list_dimensions, raycast
world, write server set_block, fill_blocks, set_time, set_weather
entities server query_entities, get_entity, summon_entity, remove_entity
players (admin) server list_players, get_player, teleport_player, set_gamemode, give_item, apply_effect, message_player, kick_player
command server run_command (any operator-level command, output captured)
chat both send_chat, get_recent_chat
player client get_self, get_inventory, get_equipment, get_status_effects
control client set_movement, stop_movement, look, look_at, jump, start_using_item, stop_using_item
interact client break_block, place_block, use_item, attack_entity, use_entity, drop_held_item
inventory client select_hotbar_slot, drop_slot, swap_slots
vision client screenshot (PNG for vision models), describe_scene
navigation client navigate_to (A*), navigation_status, stop_navigation
events both poll_events (damage, deaths, chat, spawns, joins and leaves)

Agent runtime tools

Persistent per-world memory, goals, a world map and background jobs. Details on Agent runtime.

agent_brief, observe, map_view, remember, recall, memory_update, memory_verify, goal_add, goal_update, goal_list, plan_craft, get_recipes, explore_next; jobs travel_to, explore, collect_blocks, craft_item with job_status and job_cancel; containers open_container, container_transfer, close_container.

Example prompts

Prompt What the model does
"Look around and describe what is nearby" get_self, describe_scene, optionally screenshot
"Walk to these coordinates and mine diamonds" find_blocks, navigate_to, break_block
"Get a stone pickaxe" plan_craft, collect_blocks, craft_item; progress is kept in goals and memory
"What is happening on the server" list_players, poll_events
"Build a wall" fill_blocks, or several set_block or run_command calls

The tool catalogue lives in mcp-server/src/tools.ts, which is the source of truth if this page falls behind.

Clone this wiki locally