VergeOS MCP Server

Instructions

Implementation Reference

• src/index.js:125-127 (handler)

  The core handler function in VergeOSAPI that powers on a VM by calling the generic vmAction API endpoint.

  async powerOnVM(id) {
    return this.vmAction(id, "poweron");
  }

• src/index.js:117-123 (helper)

  Helper method in VergeOSAPI that performs generic VM actions via POST to /api/v4/vm_actions.

  async vmAction(id, action) {
    return this.request("/api/v4/vm_actions", {
      method: "POST",
      headers: { "Content-Type": "application/json" },
      body: JSON.stringify({ vm: id, action }),
    });
  }

• src/index.js:294-306 (schema)

  Input schema definition for the power_on_vm tool, requiring a numeric VM ID.

    name: "power_on_vm",
    description: "Power on a virtual machine",
    inputSchema: {
      type: "object",
      properties: {
        id: {
          type: "number",
          description: "VM ID to power on",
        },
      },
      required: ["id"],
    },
  },

• src/index.js:548-550 (registration)

  Tool registration in the MCP CallToolRequestHandler switch statement, dispatching to the powerOnVM handler.

  case "power_on_vm":
    result = await api.powerOnVM(args.id);
    break;