hostinger-api-mcp 1.45.4 → 1.46.0

package/README.md

@@ -69,7 +69,7 @@ pnpm update -g hostinger-api-mcp
 
 This package installs the following MCP server commands:
 
-- `hostinger-api-mcp` — unified server with every tool (365 total)
+- `hostinger-api-mcp` — unified server with every tool (369 total)
 - `hostinger-agency-hosting-mcp` — 38 tools for agency-hosting
 - `hostinger-billing-mcp` — 9 tools for billing
 - `hostinger-dns-mcp` — 8 tools for dns
@@ -78,7 +78,7 @@ This package installs the following MCP server commands:
 - `hostinger-horizons-mcp` — 2 tools for horizons
 - `hostinger-hosting-mcp` — 56 tools for hosting
 - `hostinger-mail-mcp` — 38 tools for mail
-- `hostinger-reach-mcp` — 45 tools for reach
+- `hostinger-reach-mcp` — 49 tools for reach
 - `hostinger-vps-mcp` — 62 tools for vps
 - `hostinger-wordpress-mcp` — 38 tools for wordpress
 
@@ -2872,6 +2872,34 @@ Only the segment definition is removed. The contacts that matched it are left un
 - **Method**: `DELETE`
 - **Path**: `/api/reach/v1/profiles/{profileUuid}/segmentation/segments/{segmentUuid}`
 
+#### reach_listSegmentFilterAttributesV1
+
+List every attribute a segment condition can filter on, with the operators each attribute
+accepts, the value format they expect and, where the value is constrained, the allowed
+values.
+
+The list is profile specific: it includes the profile's custom contact fields, its tags and
+its 20 most recently published campaigns, so the valid attributes cannot be hardcoded. Read
+it before creating or updating a segment to discover the valid `attribute`, `operator` and
+`value` combinations.
+
+- **Method**: `GET`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/segmentation/filters/attributes`
+
+#### reach_previewContactsMatchingConditionsV1
+
+Preview the contacts matching a set of conditions without saving a segment.
+
+The body is the same set of conditions accepted when creating or updating a segment, so this
+is how to check who a filter reaches, and how many, before persisting it. Nothing is stored
+and no contact is modified.
+
+Call the segment filter attributes endpoint first to discover the valid `attribute`,
+`operator` and `value` combinations.
+
+- **Method**: `POST`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/segmentation/filters/contacts`
+
 #### reach_listProfileSegmentsV1
 
 Get a paginated list of the segments defined in a profile.
@@ -3046,6 +3074,33 @@ actual records found and the suggested records required for correct email delive
 - **Method**: `GET`
 - **Path**: `/api/reach/v1/profiles/{profileUuid}/domains/dns-status`
 
+#### reach_getConnectedSendingDomainV1
+
+Get the sending domain connected to the profile, its verification status and any suspended
+sender addresses.
+
+Campaigns only go out once a domain is connected and active, so this is the cheapest way to
+check that precondition before building one. A profile with no domain connected returns the
+same shape with every field set to `null`. For the individual MX, SPF, DKIM and DMARC records
+behind the status, use the DNS status endpoint.
+
+- **Method**: `GET`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/domains`
+
+#### reach_listPlanFeatureAccessV1
+
+List which plan features the profile can use.
+
+This is the feature lock matrix, not a usage quota. `available` means the feature can be
+used right now and `locked` means it is not part of the base plan, so an upgrade is needed.
+For remaining emails, recipients and AI credits use the limits endpoint instead.
+
+Worth checking before building something that cannot be activated afterwards, such as an
+automation on a plan without automation activation.
+
+- **Method**: `GET`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/features`
+
 #### reach_getRemainingPlanLimitsV1
 
 Get how much of the plan is left for the current period.

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "hostinger-api-mcp",
-  "version": "1.45.4",
+  "version": "1.46.0",
   "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.45.4",
+  "version": "1.46.0",
   "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.45.4",
+  "version": "1.46.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "hostinger-api-mcp",
-      "version": "1.45.4",
+      "version": "1.46.0",
       "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.42.4
+ * Generated from OpenAPI spec version 1.43.0
  */
 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.42.4
+ * Generated from OpenAPI spec version 1.43.0
  */
 class MCPServer {
   private readonly name: string;

package/src/core/tools/all.js

@@ -8287,6 +8287,14 @@ export default [
         "note": {
           "type": "string",
           "description": "note parameter"
+        },
+        "tag_uuids": {
+          "type": "array",
+          "description": "Existing tags to attach to the created contact",
+          "items": {
+            "type": "string",
+            "description": "tag_uuids parameter"
+          }
         }
       },
       "required": [
@@ -8593,6 +8601,14 @@ export default [
         "note": {
           "type": "string",
           "description": "note parameter"
+        },
+        "tag_uuids": {
+          "type": "array",
+          "description": "Existing tags to attach to the created contact",
+          "items": {
+            "type": "string",
+            "description": "tag_uuids parameter"
+          }
         }
       },
       "required": [
@@ -8951,6 +8967,150 @@ export default [
     ],
     "group": "reach"
   },
+  {
+    "name": "reach_listSegmentFilterAttributesV1",
+    "description": "List every attribute a segment condition can filter on, with the operators each attribute\naccepts, the value format they expect and, where the value is constrained, the allowed\nvalues.\n\nThe list is profile specific: it includes the profile's custom contact fields, its tags and\nits 20 most recently published campaigns, so the valid attributes cannot be hardcoded. Read\nit before creating or updating a segment to discover the valid `attribute`, `operator` and\n`value` combinations.",
+    "method": "GET",
+    "path": "/api/reach/v1/profiles/{profileUuid}/segmentation/filters/attributes",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_previewContactsMatchingConditionsV1",
+    "description": "Preview the contacts matching a set of conditions without saving a segment.\n\nThe body is the same set of conditions accepted when creating or updating a segment, so this\nis how to check who a filter reaches, and how many, before persisting it. Nothing is stored\nand no contact is modified.\n\nCall the segment filter attributes endpoint first to discover the valid `attribute`,\n`operator` and `value` combinations.",
+    "method": "POST",
+    "path": "/api/reach/v1/profiles/{profileUuid}/segmentation/filters/contacts",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "conditions": {
+          "type": "array",
+          "description": "Conditions a contact must satisfy to appear in the preview",
+          "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. Which operators are accepted depends on the attribute,\nso read the segment filter attributes endpoint for the authoritative\nlist."
+              },
+              "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"
+          ]
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "Number of items per page"
+        },
+        "search": {
+          "type": "string",
+          "description": "Narrow the preview to contacts whose email matches"
+        },
+        "sort_by": {
+          "type": "string",
+          "description": "sort_by parameter",
+          "enum": [
+            "email",
+            "name",
+            "surname",
+            "phone",
+            "subscription_status"
+          ]
+        },
+        "sort_direction": {
+          "type": "string",
+          "description": "sort_direction parameter",
+          "enum": [
+            "asc",
+            "desc"
+          ]
+        }
+      },
+      "required": [
+        "profileUuid",
+        "conditions",
+        "logic"
+      ]
+    },
+    "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.",
@@ -9513,6 +9673,54 @@ export default [
     ],
     "group": "reach"
   },
+  {
+    "name": "reach_getConnectedSendingDomainV1",
+    "description": "Get the sending domain connected to the profile, its verification status and any suspended\nsender addresses.\n\nCampaigns only go out once a domain is connected and active, so this is the cheapest way to\ncheck that precondition before building one. A profile with no domain connected returns the\nsame shape with every field set to `null`. For the individual MX, SPF, DKIM and DMARC records\nbehind the status, use the DNS status endpoint.",
+    "method": "GET",
+    "path": "/api/reach/v1/profiles/{profileUuid}/domains",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_listPlanFeatureAccessV1",
+    "description": "List which plan features the profile can use.\n\nThis is the feature lock matrix, not a usage quota. `available` means the feature can be\nused right now and `locked` means it is not part of the base plan, so an upgrade is needed.\nFor remaining emails, recipients and AI credits use the limits endpoint instead.\n\nWorth checking before building something that cannot be activated afterwards, such as an\nautomation on a plan without automation activation.",
+    "method": "GET",
+    "path": "/api/reach/v1/profiles/{profileUuid}/features",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
   {
     "name": "reach_getRemainingPlanLimitsV1",
     "description": "Get how much of the plan is left for the current period.\n\nTwo things to keep in mind before you build alerting on this. The period is a calendar month\nrather than a billing anniversary, so the counters reset on the 1st no matter when the\nsubscription started. And usage is tracked per order, so every profile on the same order shares\none pool and reports the same numbers here. Only the current period is available, past usage is\nnot kept.",

package/src/core/tools/all.ts

@@ -8301,6 +8301,14 @@ const tools: OpenApiTool[] = [
         "note": {
           "type": "string",
           "description": "note parameter"
+        },
+        "tag_uuids": {
+          "type": "array",
+          "description": "Existing tags to attach to the created contact",
+          "items": {
+            "type": "string",
+            "description": "tag_uuids parameter"
+          }
         }
       },
       "required": [
@@ -8607,6 +8615,14 @@ const tools: OpenApiTool[] = [
         "note": {
           "type": "string",
           "description": "note parameter"
+        },
+        "tag_uuids": {
+          "type": "array",
+          "description": "Existing tags to attach to the created contact",
+          "items": {
+            "type": "string",
+            "description": "tag_uuids parameter"
+          }
         }
       },
       "required": [
@@ -8965,6 +8981,150 @@ const tools: OpenApiTool[] = [
     ],
     "group": "reach"
   },
+  {
+    "name": "reach_listSegmentFilterAttributesV1",
+    "description": "List every attribute a segment condition can filter on, with the operators each attribute\naccepts, the value format they expect and, where the value is constrained, the allowed\nvalues.\n\nThe list is profile specific: it includes the profile's custom contact fields, its tags and\nits 20 most recently published campaigns, so the valid attributes cannot be hardcoded. Read\nit before creating or updating a segment to discover the valid `attribute`, `operator` and\n`value` combinations.",
+    "method": "GET",
+    "path": "/api/reach/v1/profiles/{profileUuid}/segmentation/filters/attributes",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_previewContactsMatchingConditionsV1",
+    "description": "Preview the contacts matching a set of conditions without saving a segment.\n\nThe body is the same set of conditions accepted when creating or updating a segment, so this\nis how to check who a filter reaches, and how many, before persisting it. Nothing is stored\nand no contact is modified.\n\nCall the segment filter attributes endpoint first to discover the valid `attribute`,\n`operator` and `value` combinations.",
+    "method": "POST",
+    "path": "/api/reach/v1/profiles/{profileUuid}/segmentation/filters/contacts",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        },
+        "conditions": {
+          "type": "array",
+          "description": "Conditions a contact must satisfy to appear in the preview",
+          "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. Which operators are accepted depends on the attribute,\nso read the segment filter attributes endpoint for the authoritative\nlist."
+              },
+              "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"
+          ]
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "Number of items per page"
+        },
+        "search": {
+          "type": "string",
+          "description": "Narrow the preview to contacts whose email matches"
+        },
+        "sort_by": {
+          "type": "string",
+          "description": "sort_by parameter",
+          "enum": [
+            "email",
+            "name",
+            "surname",
+            "phone",
+            "subscription_status"
+          ]
+        },
+        "sort_direction": {
+          "type": "string",
+          "description": "sort_direction parameter",
+          "enum": [
+            "asc",
+            "desc"
+          ]
+        }
+      },
+      "required": [
+        "profileUuid",
+        "conditions",
+        "logic"
+      ]
+    },
+    "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.",
@@ -9527,6 +9687,54 @@ const tools: OpenApiTool[] = [
     ],
     "group": "reach"
   },
+  {
+    "name": "reach_getConnectedSendingDomainV1",
+    "description": "Get the sending domain connected to the profile, its verification status and any suspended\nsender addresses.\n\nCampaigns only go out once a domain is connected and active, so this is the cheapest way to\ncheck that precondition before building one. A profile with no domain connected returns the\nsame shape with every field set to `null`. For the individual MX, SPF, DKIM and DMARC records\nbehind the status, use the DNS status endpoint.",
+    "method": "GET",
+    "path": "/api/reach/v1/profiles/{profileUuid}/domains",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
+  {
+    "name": "reach_listPlanFeatureAccessV1",
+    "description": "List which plan features the profile can use.\n\nThis is the feature lock matrix, not a usage quota. `available` means the feature can be\nused right now and `locked` means it is not part of the base plan, so an upgrade is needed.\nFor remaining emails, recipients and AI credits use the limits endpoint instead.\n\nWorth checking before building something that cannot be activated afterwards, such as an\nautomation on a plan without automation activation.",
+    "method": "GET",
+    "path": "/api/reach/v1/profiles/{profileUuid}/features",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "profileUuid": {
+          "type": "string",
+          "description": "Profile uuid parameter"
+        }
+      },
+      "required": [
+        "profileUuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "reach"
+  },
   {
     "name": "reach_getRemainingPlanLimitsV1",
     "description": "Get how much of the plan is left for the current period.\n\nTwo things to keep in mind before you build alerting on this. The period is a calendar month\nrather than a billing anniversary, so the counters reset on the 1st no matter when the\nsubscription started. And usage is tracked per order, so every profile on the same order shares\none pool and reports the same numbers here. Only the current period is available, past usage is\nnot kept.",