hostinger-api-mcp 1.32.0 → 1.33.1

package/README.md

@@ -49,7 +49,7 @@ pnpm update -g hostinger-api-mcp
 
 This package installs the following MCP server commands:
 
-- `hostinger-api-mcp` — unified server with every tool (308 total)
+- `hostinger-api-mcp` — unified server with every tool (314 total)
 - `hostinger-agency-hosting-mcp` — 27 tools for agency-hosting
 - `hostinger-billing-mcp` — 9 tools for billing
 - `hostinger-dns-mcp` — 8 tools for dns
@@ -58,7 +58,7 @@ This package installs the following MCP server commands:
 - `hostinger-horizons-mcp` — 2 tools for horizons
 - `hostinger-hosting-mcp` — 48 tools for hosting
 - `hostinger-mail-mcp` — 38 tools for mail
-- `hostinger-reach-mcp` — 29 tools for reach
+- `hostinger-reach-mcp` — 35 tools for reach
 - `hostinger-vps-mcp` — 62 tools for vps
 - `hostinger-wordpress-mcp` — 35 tools for wordpress
 
@@ -422,9 +422,9 @@ status, metadata, hosting plan details, and resource quotas.
 
 #### agency-hosting_deleteAgencyPlanWebsiteV1
 
-Deletes an Agency Plan website and schedules cleanup of its resources.
-
-This action is irreversible. Website files, databases, and linked domains are removed.
+Permanently deletes an Agency Plan website. Deletion is processed asynchronously: the
+website is immediately transitioned to a deleting state and the underlying server
+resources are removed in the background.
 
 - **Method**: `DELETE`
 - **Path**: `/api/agency-hosting/v1/websites/{website_uid}`
@@ -2290,6 +2290,10 @@ Get a list of all contact segments.
 
 This endpoint returns a list of contact segments that can be used to organize contacts.
 
+**Deprecated.** This endpoint cannot target a profile, so it always falls back to
+the client's default profile and cannot list the segments of any other profile. Use
+`GET /api/reach/v1/profiles/{profileUuid}/segmentation/segments` instead.
+
 - **Method**: `GET`
 - **Path**: `/api/reach/v1/segmentation/segments`
 
@@ -2300,9 +2304,22 @@ Create a new contact segment.
 This endpoint allows creating a new contact segment that can be used to organize contacts.
 The segment can be configured with specific criteria like email, name, subscription status, etc.
 
+**Deprecated.** This endpoint cannot target a profile, so it always falls back to
+the client's default profile and cannot create segments in any other profile. Use
+`POST /api/reach/v1/profiles/{profileUuid}/segmentation/segments` instead.
+
 - **Method**: `POST`
 - **Path**: `/api/reach/v1/segmentation/segments`
 
+#### reach_countProfileSegmentContactsV1
+
+Count the contacts currently matching a segment without listing them.
+
+Cheaper than paging through the segment contacts endpoint when only the size is needed.
+
+- **Method**: `GET`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}/count`
+
 #### reach_listProfileSegmentContactsV1
 
 Retrieve contacts associated with a specific segment for a given profile.
@@ -2313,6 +2330,57 @@ identified by its UUID, scoped to a specific profile.
 - **Method**: `GET`
 - **Path**: `/api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}/contacts`
 
+#### reach_getProfileSegmentDetailsV1
+
+Get a single segment of a profile, including the conditions that define it.
+
+To retrieve the contacts currently matching those conditions, use the segment contacts
+endpoint instead.
+
+- **Method**: `GET`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}`
+
+#### reach_updateAProfileSegmentV1
+
+Rename a segment and/or replace the conditions that define it.
+
+`name` is always required. Omit `conditions` to rename without touching the conditions;
+supply them and they replace the existing set entirely rather than being merged into it.
+Contacts are never modified, but which of them match the segment can change immediately.
+
+- **Method**: `PUT`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}`
+
+#### reach_deleteAProfileSegmentV1
+
+Delete a segment.
+
+Only the segment definition is removed. The contacts that matched it are left untouched.
+
+- **Method**: `DELETE`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}`
+
+#### reach_listProfileSegmentsV1
+
+Get a paginated list of the segments defined in a profile.
+
+Each entry carries the number of contacts currently matching it, which is recalculated on
+read rather than stored. Use `count_type` to count either every matching contact or only
+the subscribed ones.
+
+- **Method**: `GET`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/segmentation/segments`
+
+#### reach_createAProfileSegmentV1
+
+Create a segment in a profile.
+
+A segment is a saved set of conditions rather than a fixed list, so its membership changes
+as contacts change. Creating one does not modify any contact.
+
+- **Method**: `POST`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/segmentation/segments`
+
 #### reach_listSegmentContactsV1
 
 Retrieve contacts associated with a specific segment.
@@ -2320,6 +2388,10 @@ Retrieve contacts associated with a specific segment.
 This endpoint allows you to fetch and filter contacts that belong to a particular segment,
 identified by its UUID.
 
+**Deprecated.** This endpoint cannot target a profile, so it always falls back to
+the client's default profile and cannot read segments of any other profile. Use
+`GET /api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}/contacts` instead.
+
 - **Method**: `GET`
 - **Path**: `/api/reach/v1/segmentation/segments/{segmentUuid}/contacts`
 
@@ -2330,6 +2402,10 @@ Get details of a specific segment.
 This endpoint retrieves information about a single segment identified by UUID.
 Segments are used to organize and group contacts based on specific criteria.
 
+**Deprecated.** This endpoint cannot target a profile, so it always falls back to
+the client's default profile and cannot read segments of any other profile. Use
+`GET /api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}` instead.
+
 - **Method**: `GET`
 - **Path**: `/api/reach/v1/segmentation/segments/{segmentUuid}`
 

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "hostinger-api-mcp",
-  "version": "1.32.0",
+  "version": "1.33.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-api-mcp",
-  "version": "1.32.0",
+  "version": "1.33.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": "1.32.0",
+  "version": "1.33.1",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "hostinger-api-mcp",
-      "version": "1.32.0",
+      "version": "1.33.1",
       "transport": {
         "type": "stdio"
       },

package/src/core/runtime.js

@@ -29,7 +29,7 @@ const SECURITY_SCHEMES = {
 
 /**
  * MCP Server for Hostinger API
- * Generated from OpenAPI spec version 1.29.0
+ * Generated from OpenAPI spec version 1.30.1
  */
 class MCPServer {
   constructor({ name, version, tools }) {

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.29.0
+ * Generated from OpenAPI spec version 1.30.1
  */
 class MCPServer {
   private readonly name: string;

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

@@ -804,7 +804,7 @@ export default [
   },
   {
     "name": "agency-hosting_deleteAgencyPlanWebsiteV1",
-    "description": "Deletes an Agency Plan website and schedules cleanup of its resources.\n\nThis action is irreversible. Website files, databases, and linked domains are removed.",
+    "description": "Permanently deletes an Agency Plan website. Deletion is processed asynchronously: the\nwebsite is immediately transitioned to a deleting state and the underlying server\nresources are removed in the background.",
     "method": "DELETE",
     "path": "/api/agency-hosting/v1/websites/{website_uid}",
     "inputSchema": {

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

@@ -818,7 +818,7 @@ const tools: OpenApiTool[] = [
   },
   {
     "name": "agency-hosting_deleteAgencyPlanWebsiteV1",
-    "description": "Deletes an Agency Plan website and schedules cleanup of its resources.\n\nThis action is irreversible. Website files, databases, and linked domains are removed.",
+    "description": "Permanently deletes an Agency Plan website. Deletion is processed asynchronously: the\nwebsite is immediately transitioned to a deleting state and the underlying server\nresources are removed in the background.",
     "method": "DELETE",
     "path": "/api/agency-hosting/v1/websites/{website_uid}",
     "inputSchema": {

package/src/core/tools/all.js

@@ -1061,7 +1061,7 @@ export default [
   },
   {
     "name": "agency-hosting_deleteAgencyPlanWebsiteV1",
-    "description": "Deletes an Agency Plan website and schedules cleanup of its resources.\n\nThis action is irreversible. Website files, databases, and linked domains are removed.",
+    "description": "Permanently deletes an Agency Plan website. Deletion is processed asynchronously: the\nwebsite is immediately transitioned to a deleting state and the underlying server\nresources are removed in the background.",
     "method": "DELETE",
     "path": "/api/agency-hosting/v1/websites/{website_uid}",
     "inputSchema": {
@@ -6754,7 +6754,7 @@ export default [
   },
   {
     "name": "reach_listSegmentsV1",
-    "description": "Get a list of all contact segments.\n\nThis endpoint returns a list of contact segments that can be used to organize contacts.",
+    "description": "Get a list of all contact segments.\n\nThis endpoint returns a list of contact segments that can be used to organize contacts.\n\n**Deprecated.** This endpoint cannot target a profile, so it always falls back to\nthe client's default profile and cannot list the segments of any other profile. Use\n`GET /api/reach/v1/profiles/{profileUuid}/segmentation/segments` instead.",
     "method": "GET",
     "path": "/api/reach/v1/segmentation/segments",
     "inputSchema": {
@@ -6771,7 +6771,7 @@ export default [
   },
   {
     "name": "reach_createANewContactSegmentV1",
-    "description": "Create a new contact segment.\n\nThis endpoint allows creating a new contact segment that can be used to organize contacts.\nThe segment can be configured with specific criteria like email, name, subscription status, etc.",
+    "description": "Create a new contact segment.\n\nThis endpoint allows creating a new contact segment that can be used to organize contacts.\nThe segment can be configured with specific criteria like email, name, subscription status, etc.\n\n**Deprecated.** This endpoint cannot target a profile, so it always falls back to\nthe client's default profile and cannot create segments in any other profile. Use\n`POST /api/reach/v1/profiles/{profileUuid}/segmentation/segments` instead.",
     "method": "POST",
     "path": "/api/reach/v1/segmentation/segments",
     "inputSchema": {
@@ -6810,6 +6810,8 @@ export default [
                   "not_dropped",
                   "bounced",
                   "not_bounced",
+                  "soft_bounced",
+                  "not_soft_bounced",
                   "opened",
                   "not_opened",
                   "clicked",
@@ -6873,6 +6875,35 @@ export default [
     ],
     "group": "reach"
   },
+  {
+    "name": "reach_countProfileSegmentContactsV1",
+    "description": "Count the contacts currently matching a segment without listing them.\n\nCheaper than paging through the segment contacts endpoint when only the size is needed.",
+    "method": "GET",
+    "path": "/api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}/count",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "segmentUuid": {
+          "type": "string",
+          "description": "Segment uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid",
+        "segmentUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
   {
     "name": "reach_listProfileSegmentContactsV1",
     "description": "Retrieve contacts associated with a specific segment for a given profile.\n\nThis endpoint allows you to fetch and filter contacts that belong to a particular segment,\nidentified by its UUID, scoped to a specific profile.",
@@ -6910,9 +6941,298 @@ export default [
     ],
     "group": "reach"
   },
+  {
+    "name": "reach_getProfileSegmentDetailsV1",
+    "description": "Get a single segment of a profile, including the conditions that define it.\n\nTo retrieve the contacts currently matching those conditions, use the segment contacts\nendpoint instead.",
+    "method": "GET",
+    "path": "/api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "segmentUuid": {
+          "type": "string",
+          "description": "Segment uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid",
+        "segmentUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_updateAProfileSegmentV1",
+    "description": "Rename a segment and/or replace the conditions that define it.\n\n`name` is always required. Omit `conditions` to rename without touching the conditions;\nsupply them and they replace the existing set entirely rather than being merged into it.\nContacts are never modified, but which of them match the segment can change immediately.",
+    "method": "PUT",
+    "path": "/api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "segmentUuid": {
+          "type": "string",
+          "description": "Segment uuid parameter"
+        },
+        "name": {
+          "type": "string",
+          "description": "name parameter"
+        },
+        "conditions": {
+          "type": "array",
+          "description": "Replaces the existing conditions entirely. Omit to keep the current ones.",
+          "items": {
+            "type": "object",
+            "description": "conditions parameter",
+            "properties": {
+              "attribute": {
+                "type": "string",
+                "description": "A built-in contact attribute, or `cf:{fieldUuid}` to target a custom\ncontact field. Custom fields are addressed by field UUID; their slug\nis not accepted.\n\nBuilt-in attributes: `email`, `note`, `domain`, `source`,\n`opt_in_method`, `subscription_status`, `subscribed_at`,\n`unsubscribed_at`, `created_at`, `tag`, `campaigns`, `processed`,\n`opened`, `clicked`, `delivered`, `bounced`, `soft_bounced`,\n`dropped`.\n\nWhich operators are accepted depends on the attribute."
+              },
+              "operator": {
+                "type": "string",
+                "description": "operator parameter",
+                "enum": [
+                  "equals",
+                  "not_equals",
+                  "contains",
+                  "not_contains",
+                  "gte",
+                  "lte",
+                  "exists",
+                  "within_last_days",
+                  "not_within_last_days",
+                  "older_than_days",
+                  "processed",
+                  "not_processed",
+                  "delivered",
+                  "not_delivered",
+                  "dropped",
+                  "not_dropped",
+                  "bounced",
+                  "not_bounced",
+                  "soft_bounced",
+                  "not_soft_bounced",
+                  "opened",
+                  "not_opened",
+                  "clicked",
+                  "not_clicked",
+                  "unsubscribed",
+                  "not_unsubscribed"
+                ]
+              },
+              "value": {
+                "type": "string",
+                "description": "Always a string, including for numeric and date comparisons"
+              }
+            },
+            "required": [
+              "attribute",
+              "operator",
+              "value"
+            ]
+          }
+        },
+        "logic": {
+          "type": "string",
+          "description": "How to combine multiple conditions. Required when conditions are given.",
+          "enum": [
+            "AND",
+            "OR"
+          ]
+        }
+      },
+      "required": [
+        "profileUuid",
+        "segmentUuid",
+        "name"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_deleteAProfileSegmentV1",
+    "description": "Delete a segment.\n\nOnly the segment definition is removed. The contacts that matched it are left untouched.",
+    "method": "DELETE",
+    "path": "/api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "segmentUuid": {
+          "type": "string",
+          "description": "Segment uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid",
+        "segmentUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_listProfileSegmentsV1",
+    "description": "Get a paginated list of the segments defined in a profile.\n\nEach entry carries the number of contacts currently matching it, which is recalculated on\nread rather than stored. Use `count_type` to count either every matching contact or only\nthe subscribed ones.",
+    "method": "GET",
+    "path": "/api/reach/v1/profiles/{profileUuid}/segmentation/segments",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "count_type": {
+          "type": "string",
+          "description": "Which matching contacts to count for each segment",
+          "enum": [
+            "all",
+            "subscribed"
+          ]
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "Number of items per page"
+        }
+      },
+      "required": [
+        "profileUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_createAProfileSegmentV1",
+    "description": "Create a segment in a profile.\n\nA segment is a saved set of conditions rather than a fixed list, so its membership changes\nas contacts change. Creating one does not modify any contact.",
+    "method": "POST",
+    "path": "/api/reach/v1/profiles/{profileUuid}/segmentation/segments",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "name": {
+          "type": "string",
+          "description": "name parameter"
+        },
+        "conditions": {
+          "type": "array",
+          "description": "Conditions a contact must satisfy to fall into the segment",
+          "items": {
+            "type": "object",
+            "description": "conditions parameter",
+            "properties": {
+              "attribute": {
+                "type": "string",
+                "description": "A built-in contact attribute, or `cf:{fieldUuid}` to target a custom\ncontact field. Custom fields are addressed by field UUID; their slug\nis not accepted.\n\nBuilt-in attributes: `email`, `note`, `domain`, `source`,\n`opt_in_method`, `subscription_status`, `subscribed_at`,\n`unsubscribed_at`, `created_at`, `tag`, `campaigns`, `processed`,\n`opened`, `clicked`, `delivered`, `bounced`, `soft_bounced`,\n`dropped`.\n\nWhich operators are accepted depends on the attribute."
+              },
+              "operator": {
+                "type": "string",
+                "description": "operator parameter",
+                "enum": [
+                  "equals",
+                  "not_equals",
+                  "contains",
+                  "not_contains",
+                  "gte",
+                  "lte",
+                  "exists",
+                  "within_last_days",
+                  "not_within_last_days",
+                  "older_than_days",
+                  "processed",
+                  "not_processed",
+                  "delivered",
+                  "not_delivered",
+                  "dropped",
+                  "not_dropped",
+                  "bounced",
+                  "not_bounced",
+                  "soft_bounced",
+                  "not_soft_bounced",
+                  "opened",
+                  "not_opened",
+                  "clicked",
+                  "not_clicked",
+                  "unsubscribed",
+                  "not_unsubscribed"
+                ]
+              },
+              "value": {
+                "type": "string",
+                "description": "Always a string, including for numeric and date comparisons"
+              }
+            },
+            "required": [
+              "attribute",
+              "operator",
+              "value"
+            ]
+          }
+        },
+        "logic": {
+          "type": "string",
+          "description": "How to combine multiple conditions",
+          "enum": [
+            "AND",
+            "OR"
+          ]
+        }
+      },
+      "required": [
+        "profileUuid",
+        "name",
+        "conditions",
+        "logic"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
   {
     "name": "reach_listSegmentContactsV1",
-    "description": "Retrieve contacts associated with a specific segment.\n\nThis endpoint allows you to fetch and filter contacts that belong to a particular segment,\nidentified by its UUID.",
+    "description": "Retrieve contacts associated with a specific segment.\n\nThis endpoint allows you to fetch and filter contacts that belong to a particular segment,\nidentified by its UUID.\n\n**Deprecated.** This endpoint cannot target a profile, so it always falls back to\nthe client's default profile and cannot read segments of any other profile. Use\n`GET /api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}/contacts` instead.",
     "method": "GET",
     "path": "/api/reach/v1/segmentation/segments/{segmentUuid}/contacts",
     "inputSchema": {
@@ -6944,7 +7264,7 @@ export default [
   },
   {
     "name": "reach_getSegmentDetailsV1",
-    "description": "Get details of a specific segment.\n\nThis endpoint retrieves information about a single segment identified by UUID.\nSegments are used to organize and group contacts based on specific criteria.",
+    "description": "Get details of a specific segment.\n\nThis endpoint retrieves information about a single segment identified by UUID.\nSegments are used to organize and group contacts based on specific criteria.\n\n**Deprecated.** This endpoint cannot target a profile, so it always falls back to\nthe client's default profile and cannot read segments of any other profile. Use\n`GET /api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}` instead.",
     "method": "GET",
     "path": "/api/reach/v1/segmentation/segments/{segmentUuid}",
     "inputSchema": {