server_start
Start a Minecraft server by providing its ID or UUID to initiate gameplay sessions.
Instructions
Start a Minecraft server
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| server_id | Yes | Server ID or UUID |
Implementation Reference
- src/tools/server-actions.ts:19-32 (handler)The handler implementation for the tools, including "server_start". It uses the client to perform a post request to the server action endpoint.
server.tool( name, description, serverIdSchema, async ({ server_id }) => { try { const data = await client.post(`/servers/${server_id}/action/${action}`); 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-actions.ts:8-16 (registration)Registration of the "server_start" tool action mapping.
const actions: Array<{ name: string; action: string; description: string }> = [ { name: "server_start", action: "start_server", description: "Start a Minecraft server" }, { name: "server_stop", action: "stop_server", description: "Stop a Minecraft server (sends configured stop command)" }, { name: "server_restart", action: "restart_server", description: "Restart a Minecraft server" }, { name: "server_kill", action: "kill_server", description: "Force-kill a Minecraft server process immediately" }, { name: "server_backup", action: "backup_server", description: "Trigger an immediate backup of a Minecraft server's files" }, { name: "server_update_executable", action: "update_executable", description: "Update the server jar/executable from the configured download URL" }, { name: "server_clone", action: "clone_server", description: "Clone an existing Minecraft server (server must not be running)" }, ];