server_get_stats
Retrieve live Minecraft server runtime statistics including CPU/RAM usage, player count, world details, and operational status for monitoring and management.
Instructions
Get live runtime statistics for a Minecraft server including CPU/RAM usage, online player count and list, world name/size, MOTD, version, and whether it is running
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| server_id | Yes | Server ID or UUID |
Implementation Reference
- src/tools/server-console.ts:47-53 (handler)The handler function for the `server_get_stats` tool which fetches server statistics via an API call.
async ({ server_id }) => { try { const data = await client.get(`/servers/${server_id}/stats`); return { content: [{ type: "text", text: JSON.stringify(data, null, 2) }] }; } catch (error) { const msg = error instanceof Error ? error.message : String(error); return { content: [{ type: "text", text: `Error: ${msg}` }], isError: true }; - src/tools/server-console.ts:41-46 (registration)Registration of the `server_get_stats` tool with its description and input schema.
server.tool( "server_get_stats", "Get live runtime statistics for a Minecraft server including CPU/RAM usage, online player count and list, world name/size, MOTD, version, and whether it is running", { server_id: z.string().describe("Server ID or UUID"), },