minecraft-paper-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| server_startB | Start the Paper Minecraft server process. |
| server_stopA | Stop the Minecraft server. Sends 'stop' over RCON for a graceful shutdown, falling back to SIGTERM if RCON is unreachable. |
| server_restartA | Restart the Minecraft server (graceful stop, wait 10s, then start). |
| server_statusA | Check whether the Minecraft server process is running, and get its PID. |
| rcon_commandA | Send a raw command to the server console via RCON (e.g. 'gamerule keepInventory true'). Use dedicated tools for common actions when available. |
| players_listB | List currently online players. |
| server_tpsA | Get the server's current TPS (ticks per second) and MSPT stats. |
| server_sayB | Broadcast a chat message to all players. |
| player_kickC | Kick a player from the server. |
| player_banC | Ban a player from the server. |
| player_pardonA | Unban a player. |
| player_opA | Grant operator status to a player. |
| player_deopC | Revoke operator status from a player. |
| whitelist_addC | Add a player to the whitelist. |
| whitelist_removeB | Remove a player from the whitelist. |
| give_itemC | Give an item to a player. |
| teleport_playerB | Teleport a player to another player or to coordinates. |
| set_gameruleC | Set a gamerule on the server. |
| set_weatherC | Change the weather. |
| set_timeC | Set the in-game time. |
| whitelist_listA | Read the current whitelist.json contents. |
| ops_listA | Read the current ops.json contents. |
| banned_players_listA | Read the current banned-players.json contents. |
| banned_ips_listA | Read the current banned-ips.json contents. |
| server_properties_getA | Read all key-value pairs from server.properties. |
| server_properties_setB | Set a single key in server.properties. Requires a server restart to take effect. |
| logs_tailA | Get the last N lines of logs/latest.log. |
| logs_searchC | Search logs/latest.log for lines matching a regex pattern. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 28 tools
Each tool targets a clear and distinct action or resource, from server lifecycle to player moderation to log inspection. The generic rcon_command explicitly defers to dedicated tools, which reduces confusion rather than adding overlap.
All names are snake_case and readable, but the set mixes resource-first names like player_kick and server_properties_get with verb-first names like give_item and set_time. There is also minor singular/plural inconsistency such as players_list versus player_kick.
28 tools is on the heavy side for a Minecraft server admin server, exceeding the 25-tool threshold. Many tools are individually useful, but several could be consolidated, such as the multiple JSON file readers and properties get/set tools.
The surface covers server lifecycle, player moderation, whitelist/ops management, world settings, and log inspection well. Minor gaps exist around world save/backup operations and deeper player state queries, but common administrative workflows have no dead ends.