@hostinger/mcp 3.1.0 → 3.2.1

package/src/core/tools/hosting.js

@@ -1,5 +1,165 @@
 // Auto-generated tool list for group: hosting
 export default [
+  {
+    "name": "hosting_deploy",
+    "title": "Deploy website, nodejs app, WordPress plugin or theme",
+    "annotations": {
+      "title": "Deploy website, nodejs app, WordPress plugin or theme",
+      "readOnlyHint": false,
+      "destructiveHint": true
+    },
+    "topic": "hosting",
+    "description": "Deploy, publish or upload a website to Hostinger web hosting (Shared, Cloud): static HTML, PHP, a nodejs (Node.js) app, a whole WordPress site, or a WordPress plugin or theme, from a local directory, an archive or a GitHub or GitLab repository. It detects what the project is and does the upload, build and Git setup itself: do not call upload or build operations, and do not archive the directory yourself. WARNING: it overwrites the website's contents and cannot be undone; confirm the domain with the user before deploying to a site that already has content. A Node.js build runs on the server: this returns a buildUuid at once, then call hosting_get-deployment until the build state is completed or failed. Static, PHP, plugin and theme deploys are done when this returns; a WordPress site import only starts, and its files are extracted a few minutes later. From Git, pass type (static or nodejs) unless the site already runs a Node.js app or you pass Node.js settings; a static or PHP site deploys the branch now and again on every push; a Node.js site builds the branch now and on every later push, with the settings stored for the site (when none are stored, pass appType and nodeVersion from the project's engines, plus outputDirectory and buildScript if the app has a build step). Git needs GitHub or GitLab connected once in hPanel.",
+    "method": "",
+    "path": "",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "domain": {
+          "type": "string",
+          "description": "Domain name of the website to deploy to (e.g., example.com)"
+        },
+        "path": {
+          "type": "string",
+          "description": "Local directory (preferred; it is archived for you, skipping node_modules, .git and .env files, but not reading .gitignore, so keep build output out) or archive (zip, tar, tar.gz, tgz, 7z, gz, gzip). Not together with git."
+        },
+        "git": {
+          "type": "object",
+          "description": "Deploy a repository branch instead of local files. Not together with path.",
+          "properties": {
+            "repository": {
+              "type": "string",
+              "description": "owner/name, e.g. hostinger/my-site (GitLab group paths may have more slashes)"
+            },
+            "branch": {
+              "type": "string",
+              "description": "Branch to deploy, e.g. main"
+            },
+            "directory": {
+              "type": "string",
+              "description": "Folder under the website's document root to deploy into (static deploys only; default the document root), e.g. my-api"
+            }
+          },
+          "required": [
+            "repository",
+            "branch"
+          ]
+        },
+        "type": {
+          "type": "string",
+          "enum": [
+            "static",
+            "nodejs",
+            "wordpress-site",
+            "wordpress-plugin",
+            "wordpress-theme"
+          ],
+          "description": "What is deployed. Detected for a directory (a Plugin Name: or Theme Name: header, wp-config.php or wp-content, a package.json with a build or start script); required for an archive, when detection reports ambiguity, and for a Git deploy unless the site already runs a Node.js app or Node.js settings are passed. static also covers PHP."
+        },
+        "slug": {
+          "type": "string",
+          "description": "WordPress plugin or theme slug: lower-case letters, digits, - and _ (default: the directory name)"
+        },
+        "activate": {
+          "type": "boolean",
+          "description": "Activate the theme after deployment (WordPress themes only, default: false)"
+        },
+        "databaseDump": {
+          "type": "string",
+          "description": "Path to a .sql dump; required for a WordPress site import"
+        },
+        "nodeVersion": {
+          "type": "integer",
+          "enum": [
+            18,
+            20,
+            22,
+            24
+          ],
+          "description": "Node.js major version (default: detected from an archive, or stored for the site, else 22; set it from the project's engines for a Git deploy)"
+        },
+        "appType": {
+          "type": "string",
+          "description": "Node.js framework, e.g. next, nuxt, vite, express, react, vue, astro; overrides detection or stored settings"
+        },
+        "rootDirectory": {
+          "type": "string",
+          "description": "Directory with the package.json, relative to the site root (default .)"
+        },
+        "outputDirectory": {
+          "type": "string",
+          "description": "Build output directory relative to the root directory, e.g. dist"
+        },
+        "buildScript": {
+          "type": "string",
+          "description": "The package.json script that builds the app, e.g. build"
+        },
+        "entryFile": {
+          "type": "string",
+          "description": "Entry file of a server app. Relative to the root directory for express, fastify, hono, react-router and other; for a compiled (TypeScript) app give the built file, e.g. dist/server.js, because detection guesses a root-level file. Relative to the output directory for nest, nuxt, nitro, astro and svelte-kit (main.js, not dist/main.js). Ignored for next."
+        },
+        "packageManager": {
+          "type": "string",
+          "enum": [
+            "npm",
+            "yarn",
+            "pnpm"
+          ],
+          "description": "Package manager used to install dependencies"
+        }
+      },
+      "required": [
+        "domain"
+      ]
+    },
+    "security": [],
+    "custom": true,
+    "replacesHidden": true,
+    "templateFile": "deploy.template.js",
+    "templateFileTS": "deploy.template.ts",
+    "handlerMethod": "handleHostingDeploy",
+    "group": "hosting"
+  },
+  {
+    "name": "hosting_get-deployment",
+    "title": "Get deployment status, build status, build logs and failure analysis",
+    "annotations": {
+      "title": "Get deployment status, build status, build logs and failure analysis",
+      "readOnlyHint": true,
+      "destructiveHint": false
+    },
+    "topic": "hosting",
+    "description": "Check deployment status, build status, build logs and why a build failed (failure analysis) for a website's nodejs (Node.js) deployment: the state of its latest build (or of buildUuid), the end of the build log, the failure analysis when the build failed, and the build settings and Git auto-deployment settings stored for the site. Use it after hosting_deploy starts a Node.js build, and to find out why a deployment failed. Poll until the build state is completed or failed, with growing pauses. The log comes back in full; pass fromLine (the lines count from the previous call) to read only new output. A website without Node.js builds returns build: null with an explanation, because static, PHP, plugin and theme deploys are complete when hosting_deploy returns, and a WordPress site import is ready a few minutes after it starts.",
+    "method": "",
+    "path": "",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "domain": {
+          "type": "string",
+          "description": "Domain name of the website (e.g., example.com)"
+        },
+        "buildUuid": {
+          "type": "string",
+          "description": "Build to inspect, as returned by hosting_deploy (default: the latest build)"
+        },
+        "fromLine": {
+          "type": "integer",
+          "description": "Read the build log from this line on (default 0, the whole log). Pass the lines count returned by the previous call to get only new output."
+        }
+      },
+      "required": [
+        "domain"
+      ]
+    },
+    "security": [],
+    "custom": true,
+    "replacesHidden": true,
+    "templateFile": "get-deployment.template.js",
+    "templateFileTS": "get-deployment.template.ts",
+    "handlerMethod": "handleHostingGetDeployment",
+    "group": "hosting"
+  },
   {
     "name": "hosting_import-wordpress-website",
     "title": "Import WordPress website",
@@ -39,7 +199,8 @@ export default [
     "templateFile": "import-wordpress.template.js",
     "templateFileTS": "import-wordpress.template.ts",
     "handlerMethod": "handleWordpressWebsiteImport",
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_deploy-wordpress-plugin",
@@ -80,7 +241,8 @@ export default [
     "templateFile": "deploy-wordpress-plugin.template.js",
     "templateFileTS": "deploy-wordpress-plugin.template.ts",
     "handlerMethod": "handleWordpressPluginDeploy",
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_deploy-wordpress-theme",
@@ -125,7 +287,8 @@ export default [
     "templateFile": "deploy-wordpress-theme.template.js",
     "templateFileTS": "deploy-wordpress-theme.template.ts",
     "handlerMethod": "handleWordpressThemeDeploy",
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_deploy-js-application",
@@ -165,7 +328,8 @@ export default [
     "templateFile": "deploy-javascript-app.template.js",
     "templateFileTS": "deploy-javascript-app.template.ts",
     "handlerMethod": "handleJavascriptApplicationDeploy",
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_deploy-static-website",
@@ -205,7 +369,8 @@ export default [
     "templateFile": "deploy-static-website.template.js",
     "templateFileTS": "deploy-static-website.template.ts",
     "handlerMethod": "handleStaticWebsiteDeploy",
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_list-js-deployments",
@@ -257,7 +422,8 @@ export default [
     "templateFile": "list-javascript-deployments.template.js",
     "templateFileTS": "list-javascript-deployments.template.ts",
     "handlerMethod": "handleListJavascriptDeployments",
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_show-js-deployment-logs",
@@ -297,7 +463,8 @@ export default [
     "templateFile": "show-javascript-deployment-logs.template.js",
     "templateFileTS": "show-javascript-deployment-logs.template.ts",
     "handlerMethod": "handleShowJsDeploymentLogs",
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_cache_clear-website",
@@ -1324,7 +1491,8 @@ export default [
         "apiToken": []
       }
     ],
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_files_list-website-and-directories",
@@ -1472,7 +1640,8 @@ export default [
         "apiToken": []
       }
     ],
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_git_update-auto-deployment-settings",
@@ -1536,7 +1705,8 @@ export default [
         "apiToken": []
       }
     ],
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_git_delete-auto-deployment-settings",
@@ -1614,7 +1784,8 @@ export default [
         "apiToken": []
       }
     ],
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_git_list-installation-repositories",
@@ -1644,7 +1815,8 @@ export default [
         "apiToken": []
       }
     ],
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_git_deploy-website-repository",
@@ -2068,7 +2240,8 @@ export default [
         "apiToken": []
       }
     ],
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_nodejs_start-build",
@@ -2204,7 +2377,8 @@ export default [
         "apiToken": []
       }
     ],
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_nodejs_build-settings",
@@ -2239,7 +2413,8 @@ export default [
         "apiToken": []
       }
     ],
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_nodejs_update-build-settings",
@@ -2336,7 +2511,8 @@ export default [
         "apiToken": []
       }
     ],
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_nodejs_build-settings-from-archive",
@@ -2376,7 +2552,8 @@ export default [
         "apiToken": []
       }
     ],
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_nodejs_list-environment-variables",
@@ -2510,7 +2687,8 @@ export default [
         "apiToken": []
       }
     ],
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_nodejs_build",
@@ -2550,7 +2728,8 @@ export default [
         "apiToken": []
       }
     ],
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_nodejs_build-logs",
@@ -2594,7 +2773,8 @@ export default [
         "apiToken": []
       }
     ],
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_nodejs_runtime-logs",
@@ -2838,7 +3018,7 @@ export default [
       "readOnlyHint": true,
       "destructiveHint": false
     },
-    "description": "Returns the website setups started in the last 24 hours for the hosting accounts\naccessible to the authenticated client, newest first. Narrow the list with the\n`order_id`, `subscription_id` or `domain` filters.\n\nMeant for polling right after creating a website or starting a website setup: the\nwebsite shows up in the websites list before its server-side setup has finished, and\nwhile the setup is `running` endpoints that operate on that website may respond with\n`404` or `409`. Poll this endpoint with the `domain` filter every 10 to 15 seconds and\nwait for `status: completed` before uploading files, deploying or creating databases.\n`failed` means the setup stopped before finishing or has not reported progress for\nover an hour. Setups older than 24 hours are not listed.\n\n`type` is the website type the setup was started with (`wordpress`, `headless_wordpress`,\n`headless_ecommerce`, `headless_pocketbase`), or `null` for an empty website.",
+    "description": "Returns the website setups started in the last 24 hours for the hosting accounts\naccessible to the authenticated client, newest first. Narrow the list with the\n`order_id`, `subscription_id` or `domain` filters.\n\nMeant for polling right after creating a website or starting a website setup: the\nwebsite shows up in the websites list before its server-side setup has finished, and\nwhile the setup is `running` endpoints that operate on that website may respond with\n`404` or `409`. Poll this endpoint with the `domain` filter every 10 to 15 seconds and\nwait for `status: completed` before uploading files, deploying or creating databases.\n`failed` means the setup stopped before finishing or has not reported progress for\nover an hour. Setups older than 24 hours are not listed.\n\n`type` is the website type the setup was started with (`wordpress`, `headless_empty`,\n`headless_wordpress`, `headless_ecommerce`, `headless_pocketbase`), or `null` for an empty\nwebsite.",
     "method": "GET",
     "path": "/api/hosting/v1/onboardings",
     "inputSchema": {
@@ -2874,7 +3054,7 @@ export default [
       "readOnlyHint": false,
       "destructiveHint": false
     },
-    "description": "Starts a website setup on a Web or Cloud hosting order and returns the created setup\nright away; the website itself is provisioned asynchronously. Poll the list website\nsetups endpoint with the `domain` filter every 10 to 15 seconds and wait for\n`status: completed` before uploading files, deploying or creating databases.\n\nOmit `type` for an empty website. `type: wordpress` installs WordPress in the website\nroot with the admin user, email and password from `wordpress`, the domain as the site\ntitle, and `en_US` when `wordpress.language` is omitted. The headless types\n(`headless_wordpress`, `headless_ecommerce`, `headless_pocketbase`) create a headless\nwebsite; `headless_wordpress` additionally installs WordPress into the `cms` directory\nof the website root with generated credentials.\n\nOmit `domain` to set the website up on a generated temporary free subdomain.\n\nWhen the order has no hosting account yet, the setup creates one first, in the datacenter\ngiven by `datacenter_code` or the order's default datacenter when it is omitted.\nReturns 404 when the order does not exist or is not accessible to the authenticated\nclient, and 409 with a `Retry-After` header while a setup for the same domain is still\nrunning.",
+    "description": "Starts a website setup on a Web or Cloud hosting order and returns the created setup\nright away; the website itself is provisioned asynchronously. Poll the list website\nsetups endpoint (`hosting_websites_list-setups`) with the `domain` filter every 10 to 15\nseconds and wait for `status: completed` before uploading files, deploying or creating\ndatabases.\n\nOmit `type` for an empty website. `type: wordpress` installs WordPress in the website\nroot with the admin user, email and password from `wordpress`, the domain as the site\ntitle, and `en_US` when `wordpress.language` is omitted. The headless types\n(`headless_empty`, `headless_wordpress`, `headless_ecommerce`, `headless_pocketbase`)\ncreate a headless website; `headless_wordpress` additionally installs WordPress into the\n`cms` directory of the website root with generated credentials. `headless_empty` installs\nnothing: WordPress can be added later through\n`POST /api/hosting/v1/accounts/{username}/wordpress/installations`\n(`wordpress_installations_install`) with `type: headless`.\n\nOmit `domain` to set the website up on a generated temporary free subdomain. To know the\nfree subdomain before the call, so a timed-out call can be looked up and retried on the\nsame domain, generate one through `POST /api/hosting/v1/domains/free-subdomains`\n(`hosting_domains_generate-free-subdomain`) and send it as `domain`. It is accepted for\n24 hours, only from the client that generated it.\n\nWhen the order has no hosting account yet, the setup creates one first, in the datacenter\ngiven by `datacenter_code` or the order's default datacenter when it is omitted.\nReturns 404 when the order does not exist or is not accessible to the authenticated\nclient, and 409 with a `Retry-After` header while a setup for the same domain is still\nrunning.",
     "method": "POST",
     "path": "/api/hosting/v1/orders/{order_id}/onboardings",
     "inputSchema": {
@@ -2886,9 +3066,10 @@ export default [
         },
         "type": {
           "type": "string",
-          "description": "Website type. Omit or `null` for an empty website. `wordpress` installs WordPress in the website root and requires `wordpress`. The headless types (`headless_wordpress`, `headless_ecommerce`, `headless_pocketbase`) create a headless website; `headless_wordpress` additionally installs WordPress into the `cms` directory with generated credentials.",
+          "description": "Website type. Omit or `null` for an empty website. `wordpress` installs WordPress in the website root and requires `wordpress`. The headless types (`headless_empty`, `headless_wordpress`, `headless_ecommerce`, `headless_pocketbase`) create a headless website; `headless_wordpress` additionally installs WordPress into the `cms` directory with generated credentials. `headless_empty` installs nothing, so WordPress can be added later through `POST /api/hosting/v1/accounts/{username}/wordpress/installations` (`wordpress_installations_install`) with `type: headless`.",
           "enum": [
             "wordpress",
+            "headless_empty",
             "headless_wordpress",
             "headless_ecommerce",
             "headless_pocketbase"
@@ -2896,7 +3077,7 @@ export default [
         },
         "domain": {
           "type": "string",
-          "description": "Customer-owned domain. Cannot start with \"www.\" and can have at most one subdomain level, e.g. `blog.example.com`. Omit or `null` to set the website up on a generated temporary free subdomain."
+          "description": "Customer-owned domain, or a free subdomain you generated through `POST /api/hosting/v1/domains/free-subdomains` (`hosting_domains_generate-free-subdomain`) in the last 24 hours. Cannot start with \"www.\" and can have at most one subdomain level, e.g. `blog.example.com`. Omit or `null` to set the website up on a generated temporary free subdomain."
         },
         "datacenter_code": {
           "type": "string",
@@ -3665,7 +3846,8 @@ export default [
         "apiToken": []
       }
     ],
-    "group": "hosting"
+    "group": "hosting",
+    "hidden": true
   },
   {
     "name": "hosting_websites_delete",