Tools

Tools

minecraft-mcp has 71 tools. Related actions share one tool, so the agent picks fast and doesn't get lost. Each tool needs a WorldAPI permission, and the agent sees only the tools its token has (see Tokens and permissions). In read-only mode, only the tools that look stay.

Each tool also tells the client whether it only reads, can be repeated safely, or destroys something, so clients like Claude Code can ask you first.

Look (28 tools)

Permissions server:read, players:read, events:read, and chat:read. Coordinates, inventories, chests, and death places also need players:private.

Tool	What it does
get_server_status	Version, players, uptime, TPS, memory, data packs. detail adds tick percentiles, CPU, load per world, and the JVM's memory pools, garbage collection, and threads.
list_plugins	Plugins with their folders and config files.
get_events	Recorded events: joins, deaths, block changes, and more.
get_chat	Chat history (needs chat:read too).
wait_for_event	Waits for a live event, such as a player joining; console lines too, with logs:read.
list_worlds, get_world	Time, weather, difficulty, spawn, the border, game rules, size.
locate	The nearest blocks, biomes, or structures, around a point or a player.
get_block	What's at a spot, a container's slots included.
get_biome, get_highest_block	The biome and the surface height at a spot.
list_chunks, get_chunk	Loaded chunks, sorted by load, and what one holds.
find_containers	Chests and barrels nearby, and which of them hold an item.
get_entity_summary	Entity counts by type and the busiest chunks first.
list_entities, get_entity	Mobs and items one by one, with villager trades, leashes, and spawn reasons.
list_players, list_online_players	Everyone who ever played, and who's on now.
get_player	One player; include adds the inventory, ender chest, effects, deaths, sessions, statistics, and advancements in one call.
get_player_statistics, get_player_advancements	A player's statistics and advancements.
check_permission	Whether a player has a permission.
get_leaderboard, get_aggregates	Rankings by any statistic, and server totals.
get_recipes	How to craft anything.
list_extensions, read_extension	Data other plugins share through WorldAPI; their events come through get_events and wait_for_event too.

Logs, host, and configs (5 tools)

Tool	Permission	What it does
get_server_log	logs:read	The console since WorldAPI started, by level and text.
get_system	system:read	CPU, RAM, swap, disk, container limits, and the Java runtime.
list_configs	files:read	The server's and each plugin's configs.
list_files, read_file	files:read, or logs:read under logs/	Folders, and files as numbered lines: a page at a time, from the end, or with grep and context. Gzipped logs too.

World (11 tools, world:write)

Tool	What it does
set_world	Time, weather, difficulty, PvP, spawn.
set_gamerule, set_world_border	Game rules and the world border.
set_block, fill_blocks	One block, or a box of them.
force_load_chunk	Keeps a chunk loaded, or lets it go.
edit_container	Gives, sets or clears a slot, or empties a chest.
spawn_entity, update_entity, remove_entity	Spawns, changes, and removes entities: one, or many by type and area.
world_effect	Lightning, explosions, sounds, particles.

Players (8 tools, players:write)

Most of them need the player online.

Tool	What it does
teleport_player	Moves a player to coordinates, another player, or a world's spawn.
set_player_property	Game mode, health, food, experience, flight, speed, display name, and more.
send_message, broadcast	A chat message, title, or action bar text to one player (with a sound, if you like) or to everyone.
give_item, edit_inventory	Gives items, or sets and clears inventory slots.
set_effects	Adds or removes potion effects.
set_advancement	Grants or revokes an advancement.

Moderation (5 tools, players:moderate)

Tool	What it does
get_access	The whitelist, operators, and bans.
manage_whitelist	Adds or removes players, turns the whitelist on or off.
set_operator	Grants or revokes operator.
manage_bans	Bans or pardons a player or an IP.
kick_player	Kicks a player with a reason.

Server (6 tools)

Tool	Permission	What it does
run_command	server:console	Runs any console command and returns its output. Every call lands in the audit log.
save_worlds	server:control	Saves every world.
restart_server, stop_server	server:control	Restarts or stops with a countdown and warnings, or cancels one.
list_tokens, get_audit_log	tokens:manage	WorldAPI's tokens, and what each of them changed.

Configs (3 tools, files:write)

Tool	What it does
edit_file	Replaces exact text, like an editor's find and replace.
set_config_values	Sets keys by dotted path in YAML, .properties, or JSON, comments kept.
write_file	Creates or replaces a whole file.

Each write can pass the sha256 that read_file shows, so it fails if someone changed the file meanwhile.

Java (5 tools, code)

These work only when WorldAPI turns scripts on.

Tool	What it does
execute_java	Compiles and runs Java once and returns the result.
load_java_script	Loads a script that stays and reacts to events.
list_java_scripts, get_java_script	Loaded scripts, and one script's source with its latest log lines and errors.
unload_java_script	Unloads a script.

Prompts

Ready-made jobs your client may show as slash commands:

Prompt	What it does
server_health_check	Checks performance, load, and recent trouble.
investigate_lag	Tracks lag down to the worlds, chunks, and entities behind it.
investigate_grief	Gathers what the server knows about damage at a place or by a player.
new_player_guide	What a player has done, what to do next, and what's around them.
player_whereabouts	Finds a player and describes what's around them.

Resources

Resource	What it holds
worldapi://server/status	Version, players online, uptime, and TPS.
worldapi://players/online	Who's playing right now.
worldapi://events/recent	Recent events, live when the feed runs.
worldapi://server/console	The newest console lines, with logs:read.
worldapi://openapi	WorldAPI's OpenAPI document, every endpoint.

Next: Example prompts.