Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Capabilities
Features and capabilities supported by this server
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| resources | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| start_server | Start the Minecraft Java Edition server. Ensures RCON is enabled and waits for startup completion. |
| stop_server | Gracefully stop the Minecraft server. Uses RCON 'stop' command, falls back to stdin, then SIGKILL after 30s. |
| restart_server | Restart the Minecraft server (stop then start). Useful after configuration changes. |
| server_status | Get the current server status including running state, uptime, online players, and MOTD. |
| server_logs | Get recent server console output. Useful for debugging startup issues or monitoring activity. |
| validate_server | Check if the server directory, JAR file, and EULA are properly configured. |
| configure_mcp | Update the MCP server configuration (server directory, JAR path, RCON settings, Java path, JVM args). |
| get_server_properties | Read all server.properties settings. Returns key-value pairs with descriptions for known settings. |
| set_server_property | Set a server.properties value. The server must be restarted for changes to take effect. Common properties: gamemode, difficulty, level-seed, level-type, max-players, view-distance, motd, online-mode, pvp, spawn-protection. |
| set_server_properties_bulk | Set multiple server.properties values at once. Useful for configuring a new server or changing world generation settings. |
| get_game_rules | Get all game rules for the current world via RCON. Server must be running. |
| set_game_rule | Set a game rule value via RCON. Common rules: doDaylightCycle, doWeatherCycle, doMobSpawning, keepInventory, mobGriefing, doFireTick, randomTickSpeed, playersSleepingPercentage. |
| setup_world | Configure server.properties for generating a new world. Sets the level name, seed, world type, and other generation options. The server must be restarted (with the old world deleted or renamed) to generate the new world. |
| list_worlds | List all Minecraft worlds in the server directory with their sizes. |
| get_world_info | Get detailed information about a world from its level.dat file, including seed, spawn point, game type, and version. |
| delete_world | Delete a world folder. WARNING: This is irreversible! Consider creating a backup first. The server must be stopped. |
| set_world_spawn | Set the world spawn point by modifying level.dat. The server must be stopped. |
| execute_command | Execute a Minecraft server command via RCON. Send any command without the leading '/'. Examples: 'time set 0', 'weather clear', 'give @a diamond 64', 'tp @a 0 64 0', 'setblock 0 64 0 diamond_block'. |
| execute_commands | Execute multiple Minecraft commands sequentially via RCON. Useful for batch operations like building structures or setting up game scenarios. |
| set_time | Set the world time. Presets: 'day' (1000), 'noon' (6000), 'sunset' (12000), 'night' (13000), 'midnight' (18000), 'sunrise' (23000). Or use a tick value. |
| set_weather | Set the weather. Options: clear, rain, thunder. |
| set_block | Place a block at a specific position. Uses the /setblock command. |
| fill_blocks | Fill a region with blocks. Uses the /fill command. Max 32,768 blocks per operation. |
| summon_entity | Summon an entity at a position. Examples: 'zombie', 'skeleton', 'villager', 'item_frame', 'armor_stand'. |
| teleport | Teleport a player or entity to coordinates or another entity. |
| give_item | Give items to a player. Examples: 'diamond', 'diamond_sword', 'golden_apple'. |
| list_players | List all online players and the server's max player count. |
| op_player | Grant operator status to a player. |
| deop_player | Revoke operator status from a player. |
| kick_player | Kick a player from the server with an optional reason. |
| ban_player | Ban a player from the server. |
| pardon_player | Remove a ban from a player. |
| whitelist_manage | Manage the server whitelist. |
| set_gamemode | Change a player's game mode. |
| apply_effect | Apply a status effect to a player. Examples: speed, strength, regeneration, night_vision, invisibility, resistance. |
| list_ops | List all server operators from ops.json. |
| create_backup | Create a compressed backup (tar.gz) of a world. Safe to use while the server is running (uses save-off/save-on). |
| list_backups | List all available world backups, optionally filtered by world name. |
| restore_backup | Restore a world from a backup. Creates a safety backup of the current world before overwriting. The server MUST be stopped first. |
| delete_backup | Delete a backup file. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| server-status | Current Minecraft server status (running state, players, uptime) |
| server-properties | Current server.properties configuration |
| world-list | List of all worlds with basic info |
| server-logs | Recent server console output (last 100 lines) |