@hostinger/mcp 3.4.0 → 3.4.1

package/CHANGELOG.md

@@ -4,6 +4,25 @@ Generated at release time from the diff between the previous and current
 build. Tool changes are listed individually; everything else is summarised
 by area.
 
+## v3.4.1 — 2026-10-21
+
+### Operations
+
+- Added `reach_forms_update` — Update form
+- Added `reach_forms_duplicate` — Duplicate form
+- Added `reach_forms_create` — Create form
+- Added `reach_forms_add-submitter-tags` — Add form submitter tags
+- Added `reach_forms_remove-submitter-tag` — Remove form submitter tag
+- Added `reach_forms_update-template` — Update form template
+- Changed the input schema of `reach_forms_list`
+
+### Also in this release
+
+- Documentation: `README.md`
+- Dependencies: `package-lock.json`
+- Request handling and authentication: `src/core/runtime.js`, `src/core/runtime.ts`
+- Build and packaging: `types.d.ts`
+
 ## v3.4.0 — 2026-10-20
 
 ### Operations

package/README.md

@@ -69,7 +69,7 @@ pnpm update -g @hostinger/mcp
 
 This package installs the following MCP server commands:
 
-- `hostinger-api-mcp` — unified server over every operation (403 total)
+- `hostinger-api-mcp` — unified server over every operation (409 total)
 - `hostinger-agency-hosting-mcp` — 42 operations for agency-hosting
 - `hostinger-agent-readiness-mcp` — 3 operations for agent-readiness
 - `hostinger-billing-mcp` — 9 operations for billing
@@ -79,7 +79,7 @@ This package installs the following MCP server commands:
 - `hostinger-horizons-mcp` — 6 operations for horizons
 - `hostinger-hosting-mcp` — 66 operations for hosting
 - `hostinger-mail-mcp` — 38 operations for mail
-- `hostinger-reach-mcp` — 56 operations for reach
+- `hostinger-reach-mcp` — 62 operations for reach
 - `hostinger-vps-mcp` — 67 operations for vps
 - `hostinger-wordpress-mcp` — 40 operations for wordpress
 
@@ -3490,6 +3490,29 @@ do not block deletion.
 - **Method**: `DELETE`
 - **Path**: `/api/reach/v1/profiles/{profileUuid}/forms/{formUuid}`
 
+#### reach_forms_update
+
+Rename a form and/or change its status.
+
+Setting a `draft` or `paused` form to `active` takes it live: its latest saved design is published
+and visitors can submit it. `paused` and `draft` stop the form from accepting submissions. A form is
+not reachable by visitors until it is taken live. Design changes saved while the form is already
+`active` stay unpublished until the form is paused and set to `active` again. Renaming does not rename
+the automatic `form:{name}` tag.
+
+- **Method**: `PATCH`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/forms/{formUuid}`
+
+#### reach_forms_duplicate
+
+Copy a form into a new draft form with the same name and design.
+
+The copy shares the source's automatic `form:{name}` tag; other submitter tags are not copied. The
+copy is not live until its status is set to `active`.
+
+- **Method**: `POST`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/forms/{formUuid}/duplicate`
+
 #### reach_forms_list
 
 Get a paginated list of the signup forms in a profile.
@@ -3500,6 +3523,56 @@ directly usable template URL and for the tags the form puts on the contacts it c
 - **Method**: `GET`
 - **Path**: `/api/reach/v1/profiles/{profileUuid}/forms`
 
+#### reach_forms_create
+
+Create an empty draft form.
+
+Reach also adds an automatic `form:{name}` tag that every submitter receives. A draft has no design
+and is not reachable by visitors: save a design with the update form template operation, then take
+the form live by setting its status to `active`. Creating a form does not consume AI credits.
+
+- **Method**: `POST`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/forms`
+
+#### reach_forms_add-submitter-tags
+
+Add tags to a form so that every contact who submits it from now on receives them.
+
+A tag the form already has is skipped; an unknown tag is rejected. Contacts who submitted earlier are
+not tagged.
+
+- **Method**: `POST`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/forms/{formUuid}/tags`
+
+#### reach_forms_remove-submitter-tag
+
+Stop a form from applying a tag to its future submitters.
+
+Succeeds also when the form did not have the tag. Contacts who already received the tag keep it, and
+the tag itself is not deleted. The automatic `form:{name}` tag cannot be removed and is rejected with
+a conflict.
+
+- **Method**: `DELETE`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/forms/{formUuid}/tags`
+
+#### reach_forms_update-template
+
+Save `content` as the latest design of a form and return the stored version.
+
+The HTML is sanitized and, unless the plan allows removing it, the Reach signature is added. Visitors
+submit the form with an `email` field (required) and optional `name`, `surname` and `phone`. After
+sanitizing, the design must contain a form container (`data-reach-form`), an email input
+(`data-reach-field="email"`) and a submit button (`data-reach-submit`); otherwise the request fails
+with `422` and `errors.content` lists `missing_form_container`, `missing_email_field` and/or
+`missing_submit_button`.
+
+A `draft` or `paused` form stays unreachable until its status is set to `active`, which publishes this
+design. On a form that is already `active` the saved design is not public until the form is paused and
+set to `active` again. Saving a design does not consume AI credits.
+
+- **Method**: `PATCH`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/forms/{formUuid}/template`
+
 #### reach_profiles_connected-sending-domain
 
 Get the sending domain connected to the profile, its verification status and any suspended

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "hostinger-api-mcp",
-  "version": "3.4.0",
+  "version": "3.4.1",
   "description": "Hostinger API — manage domains, DNS, hosting, VPS, billing and more from Gemini CLI.",
   "mcpServers": {
     "hostinger": {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hostinger/mcp",
-  "version": "3.4.0",
+  "version": "3.4.1",
   "mcpName": "io.github.hostinger/hostinger-api-mcp",
   "description": "MCP server for Hostinger API",
   "repository": {

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/hostinger/api-mcp-server",
     "source": "github"
   },
-  "version": "3.4.0",
+  "version": "3.4.1",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@hostinger/mcp",
-      "version": "3.4.0",
+      "version": "3.4.1",
       "transport": {
         "type": "stdio"
       },

package/src/core/runtime.js

@@ -66,7 +66,7 @@ const GetSkillRequestSchema = z.object({
 
 /**
  * MCP Server for Hostinger API
- * Generated from OpenAPI spec version 2.1.2
+ * Generated from OpenAPI spec version 2.1.3
  */
 class MCPServer {
   constructor({ name, version, tools, instructions, skills = [] }) {

package/src/core/runtime.ts

@@ -97,7 +97,7 @@ interface Skill { uri: string; frontmatter: Record<string, unknown>; resources:
 
 /**
  * MCP Server for Hostinger API
- * Generated from OpenAPI spec version 2.1.2
+ * Generated from OpenAPI spec version 2.1.3
  */
 class MCPServer {
   private readonly name: string;

package/src/core/tools/all.js

@@ -13505,6 +13505,90 @@ export default [
     ],
     "group": "reach"
   },
+  {
+    "name": "reach_forms_update",
+    "title": "Update form",
+    "annotations": {
+      "title": "Update form",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": true
+    },
+    "description": "Rename a form and/or change its status.\n\nSetting a `draft` or `paused` form to `active` takes it live: its latest saved design is published\nand visitors can submit it. `paused` and `draft` stop the form from accepting submissions. A form is\nnot reachable by visitors until it is taken live. Design changes saved while the form is already\n`active` stay unpublished until the form is paused and set to `active` again. Renaming does not rename\nthe automatic `form:{name}` tag.",
+    "method": "PATCH",
+    "path": "/api/reach/v1/profiles/{profileUuid}/forms/{formUuid}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "formUuid": {
+          "type": "string",
+          "description": "Form uuid parameter"
+        },
+        "name": {
+          "type": "string",
+          "description": "Form name. Letters, digits, spaces and - . ' _ only."
+        },
+        "status": {
+          "type": "string",
+          "description": "`active` takes the form live, `paused` and `draft` stop it accepting submissions.",
+          "enum": [
+            "active",
+            "paused",
+            "draft"
+          ]
+        }
+      },
+      "required": [
+        "profileUuid",
+        "formUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_forms_duplicate",
+    "title": "Duplicate form",
+    "annotations": {
+      "title": "Duplicate form",
+      "readOnlyHint": false,
+      "destructiveHint": false
+    },
+    "description": "Copy a form into a new draft form with the same name and design.\n\nThe copy shares the source's automatic `form:{name}` tag; other submitter tags are not copied. The\ncopy is not live until its status is set to `active`.",
+    "method": "POST",
+    "path": "/api/reach/v1/profiles/{profileUuid}/forms/{formUuid}/duplicate",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "formUuid": {
+          "type": "string",
+          "description": "Form uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid",
+        "formUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
   {
     "name": "reach_forms_list",
     "title": "List forms",
@@ -13530,6 +13614,15 @@ export default [
         "per_page": {
           "type": "integer",
           "description": "Number of items per page"
+        },
+        "status": {
+          "type": "string",
+          "description": "Return only forms with this status.",
+          "enum": [
+            "active",
+            "paused",
+            "draft"
+          ]
         }
       },
       "required": [
@@ -13543,6 +13636,162 @@ export default [
     ],
     "group": "reach"
   },
+  {
+    "name": "reach_forms_create",
+    "title": "Create form",
+    "annotations": {
+      "title": "Create form",
+      "readOnlyHint": false,
+      "destructiveHint": false
+    },
+    "description": "Create an empty draft form.\n\nReach also adds an automatic `form:{name}` tag that every submitter receives. A draft has no design\nand is not reachable by visitors: save a design with the update form template operation, then take\nthe form live by setting its status to `active`. Creating a form does not consume AI credits.",
+    "method": "POST",
+    "path": "/api/reach/v1/profiles/{profileUuid}/forms",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "name": {
+          "type": "string",
+          "description": "Form name. Letters, digits, spaces and - . ' _ only."
+        }
+      },
+      "required": [
+        "profileUuid",
+        "name"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_forms_add-submitter-tags",
+    "title": "Add form submitter tags",
+    "annotations": {
+      "title": "Add form submitter tags",
+      "readOnlyHint": false,
+      "destructiveHint": false
+    },
+    "description": "Add tags to a form so that every contact who submits it from now on receives them.\n\nA tag the form already has is skipped; an unknown tag is rejected. Contacts who submitted earlier are\nnot tagged.",
+    "method": "POST",
+    "path": "/api/reach/v1/profiles/{profileUuid}/forms/{formUuid}/tags",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "formUuid": {
+          "type": "string",
+          "description": "Form uuid parameter"
+        },
+        "tag_uuids": {
+          "type": "array",
+          "description": "tag_uuids parameter",
+          "items": {
+            "type": "string",
+            "description": "tag_uuids parameter"
+          }
+        }
+      },
+      "required": [
+        "profileUuid",
+        "formUuid",
+        "tag_uuids"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_forms_remove-submitter-tag",
+    "title": "Remove form submitter tag",
+    "annotations": {
+      "title": "Remove form submitter tag",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": true
+    },
+    "description": "Stop a form from applying a tag to its future submitters.\n\nSucceeds also when the form did not have the tag. Contacts who already received the tag keep it, and\nthe tag itself is not deleted. The automatic `form:{name}` tag cannot be removed and is rejected with\na conflict.",
+    "method": "DELETE",
+    "path": "/api/reach/v1/profiles/{profileUuid}/forms/{formUuid}/tags",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "formUuid": {
+          "type": "string",
+          "description": "Form uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid",
+        "formUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_forms_update-template",
+    "title": "Update form template",
+    "annotations": {
+      "title": "Update form template",
+      "readOnlyHint": false,
+      "destructiveHint": true,
+      "idempotentHint": true
+    },
+    "description": "Save `content` as the latest design of a form and return the stored version.\n\nThe HTML is sanitized and, unless the plan allows removing it, the Reach signature is added. Visitors\nsubmit the form with an `email` field (required) and optional `name`, `surname` and `phone`. After\nsanitizing, the design must contain a form container (`data-reach-form`), an email input\n(`data-reach-field=\"email\"`) and a submit button (`data-reach-submit`); otherwise the request fails\nwith `422` and `errors.content` lists `missing_form_container`, `missing_email_field` and/or\n`missing_submit_button`.\n\nA `draft` or `paused` form stays unreachable until its status is set to `active`, which publishes this\ndesign. On a form that is already `active` the saved design is not public until the form is paused and\nset to `active` again. Saving a design does not consume AI credits.",
+    "method": "PATCH",
+    "path": "/api/reach/v1/profiles/{profileUuid}/forms/{formUuid}/template",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "formUuid": {
+          "type": "string",
+          "description": "Form uuid parameter"
+        },
+        "content": {
+          "type": "string",
+          "description": "HTML of the form design. After sanitizing it must still contain a form container\n(`data-reach-form`), an email input (`data-reach-field=\"email\"`) and a submit button\n(`data-reach-submit`)."
+        }
+      },
+      "required": [
+        "profileUuid",
+        "formUuid",
+        "content"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
   {
     "name": "reach_profiles_connected-sending-domain",
     "title": "Get connected sending domain",