hostinger-api-mcp 1.6.2 → 1.7.1

package/src/core/runtime.ts

@@ -52,7 +52,7 @@ const SECURITY_SCHEMES: Record<string, SecurityScheme> = {
 
 /**
  * MCP Server for Hostinger API
- * Generated from OpenAPI spec version 1.7.0
+ * Generated from OpenAPI spec version 1.7.1
  */
 class MCPServer {
   private readonly name: string;
@@ -227,6 +227,10 @@ class MCPServer {
 
   private async executeCustomTool(tool: OpenApiTool, params: Record<string, any>): Promise<any> {
     switch (tool.name) {
+      case 'agencyHosting_deployNodeStaticWebsite':
+        return await this.handleNodeStaticDeploy(params);
+      case 'agencyHosting_deployPhpApplication':
+        return await this.handlePhpAppDeploy(params);
       case 'hosting_importWordpressWebsite':
         return await this.handleWordpressWebsiteImport(params);
       case 'hosting_deployWordpressPlugin':
@@ -246,6 +250,541 @@ class MCPServer {
     }
   }
 
+  private agencyHosting_normalizePath(pathString: string): string {
+    return pathString.replace(/\\/g, '/');
+  }
+
+  private agencyHosting_generateUploadDir(): string {
+    const chars = 'ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789';
+    let result = '';
+    for (let i = 0; i < 12; i++) {
+      result += chars.charAt(Math.floor(Math.random() * chars.length));
+    }
+    return result;
+  }
+
+  private agencyHosting_validateRequiredParams(params: Record<string, any>): void {
+    const { domain, archivePath, removeArchive } = params;
+
+    if (!domain || typeof domain !== 'string') {
+      throw new Error('domain is required and must be a string');
+    }
+
+    if (!archivePath || typeof archivePath !== 'string') {
+      throw new Error('archivePath is required and must be a string');
+    }
+
+    if (removeArchive !== undefined && typeof removeArchive !== 'boolean') {
+      throw new Error('removeArchive must be a boolean if provided');
+    }
+  }
+
+  private agencyHosting_validateArchiveFile(archivePath: string): void {
+    if (!fs.existsSync(archivePath)) {
+      throw new Error(`Archive file not found: ${archivePath}`);
+    }
+
+    const archiveStats = fs.statSync(archivePath);
+    if (!archiveStats.isFile()) {
+      throw new Error(`Archive path is not a file: ${archivePath}`);
+    }
+  }
+
+  private agencyHosting_removeArchive(archivePath: string, removeArchive: boolean): boolean {
+    if (!removeArchive) {
+      return false;
+    }
+
+    try {
+      this.log('info', `Removing archive file: ${archivePath}`);
+      fs.unlinkSync(archivePath);
+      this.log('info', `Successfully removed archive file: ${archivePath}`);
+      return true;
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.log('error', `Failed to remove archive file: ${errorMessage}`);
+      return false;
+    }
+  }
+
+  private async agencyHosting_resolveWebsiteUid(domain: string): Promise<string> {
+    const baseUrl = this.baseUrl.endsWith("/") ? this.baseUrl : `${this.baseUrl}/`;
+    const perPage = 100;
+
+    try {
+      const bearerToken = await this.getAuthToken();
+      let page = 1;
+      let total = 0;
+
+      do {
+        const url = new URL(
+          `api/agency-hosting/v1/domains?page=${page}&per_page=${perPage}`,
+          baseUrl
+        ).toString();
+
+        const config: AxiosRequestConfig = {
+          method: 'get',
+          url,
+          headers: {
+            ...this.headers,
+            'Authorization': `Bearer ${bearerToken}`
+          },
+          timeout: 60000, // 60s
+          validateStatus: function (status: number): boolean {
+            return status < 500;
+          }
+        };
+
+        const response = await axios(config);
+
+        if (response.status !== 200) {
+          throw new Error(`API returned status ${response.status}: ${JSON.stringify(response.data)}`);
+        }
+
+        const domains = response.data?.data ?? [];
+        const match = domains.find((item: any) => item.fqdn === domain);
+        if (match?.website_uid) {
+          this.log('info', `Resolved website UID: ${match.website_uid} for domain: ${domain}`);
+          return match.website_uid;
+        }
+
+        total = response.data?.meta?.total ?? domains.length;
+        page++;
+      } while ((page - 1) * perPage < total);
+
+      throw new Error(`No Agency Plan website found for domain: ${domain}`);
+
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.log('error', `Failed to resolve website UID for domain ${domain}: ${errorMessage}`);
+
+      if (axios.isAxiosError(error)) {
+        const responseData = error.response?.data;
+        const responseStatus = error.response?.status;
+        this.log('error', 'API Error Details:', {
+          status: responseStatus,
+          data: typeof responseData === 'object' ? JSON.stringify(responseData) : responseData
+        });
+      }
+
+      throw error;
+    }
+  }
+
+  private async agencyHosting_fetchUploadCredentials(
+    websiteUid: string
+  ): Promise<{ url: string; auth_key: string; rest_auth_key: string }> {
+    const baseUrl = this.baseUrl.endsWith("/") ? this.baseUrl : `${this.baseUrl}/`;
+    const url = new URL(`api/agency-hosting/v1/websites/${websiteUid}/files/upload-urls`, baseUrl).toString();
+
+    try {
+      const bearerToken = await this.getAuthToken();
+
+      const config: AxiosRequestConfig = {
+        method: 'post',
+        url,
+        headers: {
+          ...this.headers,
+          'Authorization': `Bearer ${bearerToken}`,
+          'Content-Type': 'application/json'
+        },
+        timeout: 60000, // 60s
+        validateStatus: function (status: number): boolean {
+          return status < 500;
+        }
+      };
+
+      const response = await axios(config);
+
+      if (response.status !== 200) {
+        throw new Error(`API returned status ${response.status}: ${JSON.stringify(response.data)}`);
+      }
+
+      return response.data;
+
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.log('error', `Failed to fetch upload credentials: ${errorMessage}`);
+
+      if (axios.isAxiosError(error)) {
+        const responseData = error.response?.data;
+        const responseStatus = error.response?.status;
+        this.log('error', 'API Error Details:', {
+          status: responseStatus,
+          data: typeof responseData === 'object' ? JSON.stringify(responseData) : responseData
+        });
+      }
+
+      throw error;
+    }
+  }
+
+  private async agencyHosting_uploadFile(
+    filePath: string,
+    relativePath: string,
+    uploadUrl: string,
+    authRestToken: string,
+    authToken: string
+  ): Promise<{ url: string; filename: string }> {
+    return new Promise(async (resolve, reject) => {
+      try {
+        const stats = fs.statSync(filePath);
+        const fileStream = fs.createReadStream(filePath);
+
+        const cleanUploadUrl = uploadUrl.replace(new RegExp('/$'), '');
+        const normalizedPath = this.agencyHosting_normalizePath(relativePath);
+        const uploadUrlWithFile = `${cleanUploadUrl}/${normalizedPath}?override=true`;
+
+        const requestHeaders: Record<string, string> = {
+          'X-Auth': authToken,
+          'X-Auth-Rest': authRestToken,
+          'upload-length': stats.size.toString(),
+          'upload-offset': '0'
+        };
+
+        try {
+          this.log('debug', `Making pre-upload POST request to ${uploadUrlWithFile}`);
+          await axios.post(uploadUrlWithFile, '', {
+            headers: requestHeaders,
+            timeout: 60000, // 60s
+            validateStatus: function (status: number): boolean {
+              return status == 201;
+            }
+          });
+        } catch (error) {
+          const errorMessage = error instanceof Error ? error.message : String(error);
+
+          if (axios.isAxiosError(error)) {
+            const responseData = error.response?.data;
+            const responseStatus = error.response?.status;
+            const responseHeaders = error.response?.headers;
+            const responseText = typeof responseData === 'object' ? JSON.stringify(responseData) : responseData;
+
+            this.log('error', 'Pre-upload POST request failed - Full Response Details:', {
+              status: responseStatus,
+              headers: responseHeaders,
+              data: responseText,
+              message: errorMessage
+            });
+            reject(new Error(`Pre-upload request failed: ${errorMessage}`));
+            return;
+          } else {
+            this.log('error', `Pre-upload POST request failed: ${errorMessage}`);
+            reject(new Error(`Pre-upload request failed: ${errorMessage}`));
+            return;
+          }
+        }
+
+        const upload = new tus.Upload(fileStream, {
+          uploadUrl: uploadUrlWithFile,
+          retryDelays: [1000, 2000, 4000, 8000, 16000, 20000],
+          uploadDataDuringCreation: false,
+          parallelUploads: 1,
+          chunkSize: 10485760,
+          headers: requestHeaders,
+          removeFingerprintOnSuccess: true,
+          uploadSize: stats.size,
+          metadata: {
+            filename: path.basename(relativePath)
+          },
+          onError: (error: Error) => {
+            this.log('error', `TUS upload error for ${relativePath}`, { error: error.message });
+            reject(new Error(`Upload failed: ${error.message}`));
+          },
+          onSuccess: () => {
+            this.log('info', `TUS upload completed for ${relativePath}`, { url: upload.url });
+            resolve({
+              url: upload.url || uploadUrlWithFile,
+              filename: relativePath
+            });
+          }
+        });
+
+        upload.start();
+
+      } catch (error) {
+        const errorMessage = error instanceof Error ? error.message : String(error);
+        this.log('error', `Error preparing upload for ${filePath}`, { error: errorMessage });
+        reject(new Error(`Failed to prepare upload: ${errorMessage}`));
+      }
+    });
+  }
+
+  private async agencyHosting_deployNodeStatic_triggerBuildAssets(websiteUid: string, archivePath: string): Promise<any> {
+    const baseUrl = this.baseUrl.endsWith("/") ? this.baseUrl : `${this.baseUrl}/`;
+    const url = new URL(`api/agency-hosting/v1/websites/${websiteUid}/build-assets`, baseUrl).toString();
+
+    try {
+      const bearerToken = await this.getAuthToken();
+
+      const config: AxiosRequestConfig = {
+        method: 'post',
+        url,
+        headers: {
+          ...this.headers,
+          'Authorization': `Bearer ${bearerToken}`,
+          'Content-Type': 'application/json'
+        },
+        data: {
+          archive_path: archivePath
+        },
+        timeout: 60000,
+        validateStatus: function (status: number): boolean {
+          return status < 500;
+        }
+      };
+
+      const response = await axios(config);
+
+      if (response.status < 200 || response.status >= 300) {
+        throw new Error(`API returned status ${response.status}: ${JSON.stringify(response.data)}`);
+      }
+
+      this.log('info', `Successfully triggered build for website ${websiteUid}`);
+      return response.data;
+
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.log('error', `Failed to trigger build: ${errorMessage}`);
+
+      if (axios.isAxiosError(error)) {
+        const responseData = error.response?.data;
+        const responseStatus = error.response?.status;
+        this.log('error', 'API Error Details:', {
+          status: responseStatus,
+          data: typeof responseData === 'object' ? JSON.stringify(responseData) : responseData
+        });
+      }
+
+      throw error;
+    }
+  }
+
+  private async handleNodeStaticDeploy(params: Record<string, any>): Promise<any> {
+    const { domain, archivePath, removeArchive = true } = params;
+
+    this.agencyHosting_validateRequiredParams(params);
+    this.agencyHosting_validateArchiveFile(archivePath);
+
+    this.log('info', `Resolving website UID from domain: ${domain}`);
+    const websiteUid = await this.agencyHosting_resolveWebsiteUid(domain);
+
+    this.log('info', `Starting archive upload for ${domain}`);
+
+    let uploadCredentials: any;
+    try {
+      uploadCredentials = await this.agencyHosting_fetchUploadCredentials(websiteUid);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      throw new Error(`Failed to fetch upload credentials: ${errorMessage}`);
+    }
+
+    const { url: uploadUrl, auth_key: authToken, rest_auth_key: authRestToken } = uploadCredentials;
+
+    if (!uploadUrl || !authToken || !authRestToken) {
+      throw new Error('Invalid upload credentials received from API');
+    }
+
+    const archiveBasename = path.basename(archivePath);
+    const uploadDir = `.h5g/${this.agencyHosting_generateUploadDir()}`;
+    let uploadResult: any;
+    try {
+      uploadResult = await this.agencyHosting_uploadFile(
+        archivePath,
+        `${uploadDir}/${archiveBasename}`,
+        uploadUrl,
+        authRestToken,
+        authToken
+      );
+
+      this.log('info', `Successfully uploaded archive: ${archiveBasename}`);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      throw new Error(`Failed to upload archive: ${errorMessage}`);
+    }
+
+    let deployResult: any;
+    try {
+      this.log('info', `Triggering build for ${domain}`);
+      deployResult = await this.agencyHosting_deployNodeStatic_triggerBuildAssets(websiteUid, uploadDir);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.log('error', `Failed to trigger build: ${errorMessage}`);
+      const archiveRemoved = this.agencyHosting_removeArchive(archivePath, removeArchive);
+
+      return {
+        upload: {
+          status: 'success',
+          data: {
+            filename: uploadResult.filename
+          }
+        },
+        deploy: {
+          status: 'error',
+          error: errorMessage
+        },
+        removeArchive: {
+          status: archiveRemoved ? 'success' : 'skipped'
+        }
+      };
+    }
+
+    const archiveRemoved = this.agencyHosting_removeArchive(archivePath, removeArchive);
+
+    return {
+      upload: {
+        status: 'success',
+        data: {
+          filename: uploadResult.filename
+        }
+      },
+      deploy: {
+        status: 'success',
+        data: deployResult
+      },
+      removeArchive: {
+        status: archiveRemoved ? 'success' : 'skipped'
+      }
+    };
+  }
+
+  private async agencyHosting_deployPhpApp_triggerImportArchive(websiteUid: string, archiveName: string): Promise<any> {
+    const baseUrl = this.baseUrl.endsWith("/") ? this.baseUrl : `${this.baseUrl}/`;
+    const url = new URL(`api/agency-hosting/v1/websites/${websiteUid}/files/import-archive`, baseUrl).toString();
+
+    try {
+      const bearerToken = await this.getAuthToken();
+
+      const config: AxiosRequestConfig = {
+        method: 'post',
+        url,
+        headers: {
+          ...this.headers,
+          'Authorization': `Bearer ${bearerToken}`,
+          'Content-Type': 'application/json'
+        },
+        data: {
+          archive_name: archiveName
+        },
+        timeout: 60000,
+        validateStatus: function (status: number): boolean {
+          return status < 500;
+        }
+      };
+
+      const response = await axios(config);
+
+      if (response.status < 200 || response.status >= 300) {
+        throw new Error(`API returned status ${response.status}: ${JSON.stringify(response.data)}`);
+      }
+
+      this.log('info', `Successfully triggered import for website ${websiteUid}`);
+      return response.data;
+
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.log('error', `Failed to trigger import: ${errorMessage}`);
+
+      if (axios.isAxiosError(error)) {
+        const responseData = error.response?.data;
+        const responseStatus = error.response?.status;
+        this.log('error', 'API Error Details:', {
+          status: responseStatus,
+          data: typeof responseData === 'object' ? JSON.stringify(responseData) : responseData
+        });
+      }
+
+      throw error;
+    }
+  }
+
+  private async handlePhpAppDeploy(params: Record<string, any>): Promise<any> {
+    const { domain, archivePath, removeArchive = true } = params;
+
+    this.agencyHosting_validateRequiredParams(params);
+    this.agencyHosting_validateArchiveFile(archivePath);
+
+    this.log('info', `Resolving website UID from domain: ${domain}`);
+    const websiteUid = await this.agencyHosting_resolveWebsiteUid(domain);
+
+    this.log('info', `Starting archive upload for ${domain}`);
+
+    let uploadCredentials: any;
+    try {
+      uploadCredentials = await this.agencyHosting_fetchUploadCredentials(websiteUid);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      throw new Error(`Failed to fetch upload credentials: ${errorMessage}`);
+    }
+
+    const { url: uploadUrl, auth_key: authToken, rest_auth_key: authRestToken } = uploadCredentials;
+
+    if (!uploadUrl || !authToken || !authRestToken) {
+      throw new Error('Invalid upload credentials received from API');
+    }
+
+    const archiveBasename = path.basename(archivePath);
+    let uploadResult: any;
+    try {
+      uploadResult = await this.agencyHosting_uploadFile(
+        archivePath,
+        `.h5g/${archiveBasename}`,
+        uploadUrl,
+        authRestToken,
+        authToken
+      );
+
+      this.log('info', `Successfully uploaded archive: ${archiveBasename}`);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      throw new Error(`Failed to upload archive: ${errorMessage}`);
+    }
+
+    let deployResult: any;
+    try {
+      this.log('info', `Triggering import for ${domain}`);
+      deployResult = await this.agencyHosting_deployPhpApp_triggerImportArchive(websiteUid, archiveBasename);
+    } catch (error) {
+      const errorMessage = error instanceof Error ? error.message : String(error);
+      this.log('error', `Failed to trigger import: ${errorMessage}`);
+      const archiveRemoved = this.agencyHosting_removeArchive(archivePath, removeArchive);
+
+      return {
+        upload: {
+          status: 'success',
+          data: {
+            filename: uploadResult.filename
+          }
+        },
+        deploy: {
+          status: 'error',
+          error: errorMessage
+        },
+        removeArchive: {
+          status: archiveRemoved ? 'success' : 'skipped'
+        }
+      };
+    }
+
+    const archiveRemoved = this.agencyHosting_removeArchive(archivePath, removeArchive);
+
+    return {
+      upload: {
+        status: 'success',
+        data: {
+          filename: uploadResult.filename
+        }
+      },
+      deploy: {
+        status: 'success',
+        data: deployResult
+      },
+      removeArchive: {
+        status: archiveRemoved ? 'success' : 'skipped'
+      }
+    };
+  }
+
   private normalizePath(pathString: string): string {
     return pathString.replace(/\\/g, '/');
   }

package/src/core/tools/agency-hosting.js

@@ -1,5 +1,73 @@
 // Auto-generated tool list for group: agency-hosting
 export default [
+  {
+    "name": "agencyHosting_deployNodeStaticWebsite",
+    "topic": "agency-hosting",
+    "description": "Deploy a node-static Agency Plan (h5g) website from an archive file. WARNING: this overwrites the website's existing contents and cannot be undone — always confirm with the user before proceeding. Use this for Agency Plan websites of type node-static (a Node.js-built static site that requires a build step or a plain simple static site). The tool resolves the website from its domain, uploads the archive to the website's file browser over TUS, and triggers the build-assets process which builds the site and deploys the result to public_html. This operation is synchronous: the build and deployment complete before the tool returns, so the website is live as soon as the tool finishes successfully — there is no separate asynchronous build to wait for or poll. For plain PHP applications that should be extracted as-is, use agencyHosting_deployPhpApplication instead. The website UID is automatically resolved from the domain.",
+    "method": "",
+    "path": "",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "domain": {
+          "type": "string",
+          "description": "Domain name of the Agency Plan website (e.g., example.com)"
+        },
+        "archivePath": {
+          "type": "string",
+          "description": "Absolute or relative path to the website archive file. Supported formats: zip, tar, tar.gz, tgz. The archive must contain the application source files. If user provides a directory path, create an archive from it before proceeding using EXACTLY this naming pattern: directoryname_YYYYMMDD_HHMMSS.zip (e.g., mywebsite_20250115_143022.zip)"
+        },
+        "removeArchive": {
+          "type": "boolean",
+          "description": "Whether to remove the local archive file after successful deployment (default: true)"
+        }
+      },
+      "required": [
+        "domain",
+        "archivePath"
+      ]
+    },
+    "security": [],
+    "custom": true,
+    "templateFile": "deploy-node-static.template.js",
+    "templateFileTS": "deploy-node-static.template.ts",
+    "handlerMethod": "handleNodeStaticDeploy",
+    "group": "agency-hosting"
+  },
+  {
+    "name": "agencyHosting_deployPhpApplication",
+    "topic": "agency-hosting",
+    "description": "Deploy a PHP (or other non-build) Agency Plan (h5g) website from an archive file. WARNING: this overwrites the website's existing contents and cannot be undone — always confirm with the user before proceeding. Use this for Agency Plan websites where the archive contents should be extracted and served as-is with no build step (e.g., PHP applications). The tool resolves the website from its domain, uploads the archive to the website's file browser over TUS, and triggers the import-archive process which overwrites the website contents with the archive contents. This operation is synchronous: the archive is extracted and deployed before the tool returns, so the website is live as soon as the tool finishes successfully — there is no separate asynchronous build to wait for or poll. For node-static websites that require a build step, use agencyHosting_deployNodeStaticWebsite instead. The website UID is automatically resolved from the domain.",
+    "method": "",
+    "path": "",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "domain": {
+          "type": "string",
+          "description": "Domain name of the Agency Plan website (e.g., example.com)"
+        },
+        "archivePath": {
+          "type": "string",
+          "description": "Absolute or relative path to the website archive file. Supported formats: zip, tar, tar.gz, tgz. If user provides a directory path, create an archive from it before proceeding using EXACTLY this naming pattern: directoryname_YYYYMMDD_HHMMSS.zip (e.g., mywebsite_20250115_143022.zip)"
+        },
+        "removeArchive": {
+          "type": "boolean",
+          "description": "Whether to remove the local archive file after successful deployment (default: true)"
+        }
+      },
+      "required": [
+        "domain",
+        "archivePath"
+      ]
+    },
+    "security": [],
+    "custom": true,
+    "templateFile": "deploy-php-app.template.js",
+    "templateFileTS": "deploy-php-app.template.ts",
+    "handlerMethod": "handlePhpAppDeploy",
+    "group": "agency-hosting"
+  },
   {
     "name": "agency-hosting_listAvailableDatacentersForAnAgencyPlanOrderV1",
     "description": "Lists the datacenters available for provisioning a new website on the given Agency Plan\nhosting order.\n\nEach datacenter includes a `pinger_url` you can ping from the client to measure round-trip\nlatency; comparing the results across datacenters lets you pick the nearest one (lowest\nping) before choosing its `code` as the `datacenter_code` when creating a website setup.",