hostinger-api-mcp 0.1.21 → 0.1.23

package/README.md

@@ -919,9 +919,66 @@ The contact will be automatically subscribed to email communications.
 - `email`: email parameter (required)
 - `name`: name parameter 
 - `surname`: surname parameter 
-- `group_uuids`: group_uuids parameter 
 - `note`: note parameter 
 
+### reach_filterSegmentContactsV1
+
+Filter and retrieve contacts based on segmentation criteria.
+
+This endpoint allows filtering contacts using specified conditions and returns a paginated list of matching contacts.
+The results can be filtered using various attributes like email, name, subscription status, etc.
+
+- **Method**: `POST`
+- **Path**: `/api/reach/v1/segmentation/filters/contacts`
+
+**Parameters**:
+
+- `conditions`: conditions parameter (required)
+- `logic`: logic parameter (required)
+- `page`: page parameter 
+- `per_page`: per_page parameter 
+
+### reach_listContactSegmentsV1
+
+Get a list of all contact segments.
+
+This endpoint returns a list of contact segments that can be used to organize contacts.
+
+- **Method**: `GET`
+- **Path**: `/api/reach/v1/segmentation/segments`
+
+
+
+### reach_createANewContactSegmentV1
+
+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.
+
+- **Method**: `POST`
+- **Path**: `/api/reach/v1/segmentation/segments`
+
+**Parameters**:
+
+- `name`: name parameter (required)
+- `conditions`: conditions parameter (required)
+- `logic`: logic parameter (required)
+
+### reach_getSegmentDetailsV1
+
+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.
+
+- **Method**: `GET`
+- **Path**: `/api/reach/v1/segmentation/segments/{segmentUuid}`
+
+**Parameters**:
+
+- `segmentUuid`: Segment uuid parameter (required)
+
 ### VPS_getDataCenterListV1
 
 Retrieve all available data centers.
@@ -1743,7 +1800,7 @@ Snapshots, if there are any, will be deleted.
 ## Password Requirements
 Password will be checked against leaked password databases. 
 Requirements for the password are:
-- At least 8 characters long
+- At least 12 characters long
 - At least one uppercase letter
 - At least one lowercase letter
 - At least one number

package/package.json

@@ -1,7 +1,6 @@
 {
   "name": "hostinger-api-mcp",
-  "version": "0.1.21",
-  "mcpName": "io.github.hostinger/hostinger-api-mcp",
+  "version": "0.1.23",
   "description": "MCP server for Hostinger API",
   "repository": {
     "type": "git",

package/server.js

@@ -1619,21 +1619,261 @@ const TOOLS = [
           "type": "string",
           "description": "surname parameter"
         },
-        "group_uuids": {
+        "note": {
+          "type": "string",
+          "description": "note parameter"
+        }
+      },
+      "required": [
+        "email"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
+  {
+    "name": "reach_filterSegmentContactsV1",
+    "description": "Filter and retrieve contacts based on segmentation criteria.\n\nThis endpoint allows filtering contacts using specified conditions and returns a paginated list of matching contacts.\nThe results can be filtered using various attributes like email, name, subscription status, etc.",
+    "method": "POST",
+    "path": "/api/reach/v1/segmentation/filters/contacts",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "conditions": {
           "type": "array",
-          "description": "group_uuids parameter",
+          "description": "conditions parameter",
           "items": {
-            "type": "string",
-            "description": "Group UUID"
+            "type": "object",
+            "description": "conditions parameter",
+            "properties": {
+              "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",
+                  "opened",
+                  "not_opened",
+                  "clicked",
+                  "not_clicked",
+                  "unsubscribed",
+                  "not_unsubscribed"
+                ]
+              },
+              "value": {
+                "type": "string",
+                "description": "value parameter"
+              },
+              "attribute": {
+                "type": "string",
+                "description": "attribute parameter",
+                "enum": [
+                  "note",
+                  "comment",
+                  "domain",
+                  "integration",
+                  "source",
+                  "name",
+                  "surname",
+                  "email",
+                  "subscribed_at",
+                  "unsubscribed_at",
+                  "subscription_status",
+                  "processed",
+                  "opened",
+                  "clicked",
+                  "delivered",
+                  "bounced",
+                  "unsubscribed",
+                  "dropped",
+                  "tag",
+                  "campaigns"
+                ]
+              }
+            }
           }
         },
-        "note": {
+        "logic": {
           "type": "string",
-          "description": "note parameter"
+          "description": "logic parameter",
+          "enum": [
+            "AND",
+            "OR"
+          ]
+        },
+        "page": {
+          "type": "integer",
+          "description": "page parameter"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "per_page parameter"
         }
       },
       "required": [
-        "email"
+        "conditions",
+        "logic"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
+  {
+    "name": "reach_listContactSegmentsV1",
+    "description": "Get a list of all contact segments.\n\nThis endpoint returns a list of contact segments that can be used to organize contacts.",
+    "method": "GET",
+    "path": "/api/reach/v1/segmentation/segments",
+    "inputSchema": {
+      "type": "object",
+      "properties": {},
+      "required": []
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
+  {
+    "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.",
+    "method": "POST",
+    "path": "/api/reach/v1/segmentation/segments",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "name parameter"
+        },
+        "conditions": {
+          "type": "array",
+          "description": "conditions parameter",
+          "items": {
+            "type": "object",
+            "description": "conditions parameter",
+            "properties": {
+              "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",
+                  "opened",
+                  "not_opened",
+                  "clicked",
+                  "not_clicked",
+                  "unsubscribed",
+                  "not_unsubscribed"
+                ]
+              },
+              "value": {
+                "type": "string",
+                "description": "value parameter"
+              },
+              "attribute": {
+                "type": "string",
+                "description": "attribute parameter",
+                "enum": [
+                  "note",
+                  "comment",
+                  "domain",
+                  "integration",
+                  "source",
+                  "name",
+                  "surname",
+                  "email",
+                  "subscribed_at",
+                  "unsubscribed_at",
+                  "subscription_status",
+                  "processed",
+                  "opened",
+                  "clicked",
+                  "delivered",
+                  "bounced",
+                  "unsubscribed",
+                  "dropped",
+                  "tag",
+                  "campaigns"
+                ]
+              }
+            }
+          }
+        },
+        "logic": {
+          "type": "string",
+          "description": "logic parameter",
+          "enum": [
+            "AND",
+            "OR"
+          ]
+        }
+      },
+      "required": [
+        "name",
+        "conditions",
+        "logic"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
+  {
+    "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.",
+    "method": "GET",
+    "path": "/api/reach/v1/segmentation/segments/{segmentUuid}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "segmentUuid": {
+          "type": "string",
+          "description": "Segment uuid parameter"
+        }
+      },
+      "required": [
+        "segmentUuid"
       ]
     },
     "security": [
@@ -3091,7 +3331,7 @@ const TOOLS = [
   },
   {
     "name": "VPS_recreateVirtualMachineV1",
-    "description": "Recreate a virtual machine from scratch.\n\nThe recreation process involves reinstalling the operating system and resetting the virtual machine to its initial state.\nSnapshots, if there are any, will be deleted.\n\n## Password Requirements\nPassword will be checked against leaked password databases. \nRequirements for the password are:\n- At least 8 characters long\n- At least one uppercase letter\n- At least one lowercase letter\n- At least one number\n- Is not leaked publicly\n\n**This operation is irreversible and will result in the loss of all data stored on the virtual machine!**\n\nUse this endpoint to completely rebuild VPS instances with fresh OS installation.",
+    "description": "Recreate a virtual machine from scratch.\n\nThe recreation process involves reinstalling the operating system and resetting the virtual machine to its initial state.\nSnapshots, if there are any, will be deleted.\n\n## Password Requirements\nPassword will be checked against leaked password databases. \nRequirements for the password are:\n- At least 12 characters long\n- At least one uppercase letter\n- At least one lowercase letter\n- At least one number\n- Is not leaked publicly\n\n**This operation is irreversible and will result in the loss of all data stored on the virtual machine!**\n\nUse this endpoint to completely rebuild VPS instances with fresh OS installation.",
     "method": "POST",
     "path": "/api/vps/v1/virtual-machines/{virtualMachineId}/recreate",
     "inputSchema": {
@@ -3404,7 +3644,7 @@ const SECURITY_SCHEMES = {
 
 /**
  * MCP Server for Hostinger API
- * Generated from OpenAPI spec version 0.9.0
+ * Generated from OpenAPI spec version 0.10.0
  */
 class MCPServer {
   constructor() {
@@ -3422,7 +3662,7 @@ class MCPServer {
     this.server = new Server(
       {
         name: "hostinger-api-mcp",
-        version: "0.1.21",
+        version: "0.1.23",
       },
       {
         capabilities: {
@@ -3447,7 +3687,7 @@ class MCPServer {
       });
     }
     
-    headers['User-Agent'] = 'hostinger-mcp-server/0.1.21';
+    headers['User-Agent'] = 'hostinger-mcp-server/0.1.23';
     
     return headers;
   }
@@ -4639,8 +4879,6 @@ class MCPServer {
       const buildData = {
         ...buildSettings,
         node_version: buildSettings?.node_version || 20,
-        output_directory: buildSettings?.output_directory || 'dist',
-        build_script: buildSettings?.build_script || 'build',
         source_type: 'archive',
         source_options: {
           archive_path: archiveBasename

package/server.ts

@@ -1637,21 +1637,261 @@ const TOOLS: OpenApiTool[] = [
           "type": "string",
           "description": "surname parameter"
         },
-        "group_uuids": {
+        "note": {
+          "type": "string",
+          "description": "note parameter"
+        }
+      },
+      "required": [
+        "email"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
+  {
+    "name": "reach_filterSegmentContactsV1",
+    "description": "Filter and retrieve contacts based on segmentation criteria.\n\nThis endpoint allows filtering contacts using specified conditions and returns a paginated list of matching contacts.\nThe results can be filtered using various attributes like email, name, subscription status, etc.",
+    "method": "POST",
+    "path": "/api/reach/v1/segmentation/filters/contacts",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "conditions": {
           "type": "array",
-          "description": "group_uuids parameter",
+          "description": "conditions parameter",
           "items": {
-            "type": "string",
-            "description": "Group UUID"
+            "type": "object",
+            "description": "conditions parameter",
+            "properties": {
+              "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",
+                  "opened",
+                  "not_opened",
+                  "clicked",
+                  "not_clicked",
+                  "unsubscribed",
+                  "not_unsubscribed"
+                ]
+              },
+              "value": {
+                "type": "string",
+                "description": "value parameter"
+              },
+              "attribute": {
+                "type": "string",
+                "description": "attribute parameter",
+                "enum": [
+                  "note",
+                  "comment",
+                  "domain",
+                  "integration",
+                  "source",
+                  "name",
+                  "surname",
+                  "email",
+                  "subscribed_at",
+                  "unsubscribed_at",
+                  "subscription_status",
+                  "processed",
+                  "opened",
+                  "clicked",
+                  "delivered",
+                  "bounced",
+                  "unsubscribed",
+                  "dropped",
+                  "tag",
+                  "campaigns"
+                ]
+              }
+            }
           }
         },
-        "note": {
+        "logic": {
           "type": "string",
-          "description": "note parameter"
+          "description": "logic parameter",
+          "enum": [
+            "AND",
+            "OR"
+          ]
+        },
+        "page": {
+          "type": "integer",
+          "description": "page parameter"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "per_page parameter"
         }
       },
       "required": [
-        "email"
+        "conditions",
+        "logic"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
+  {
+    "name": "reach_listContactSegmentsV1",
+    "description": "Get a list of all contact segments.\n\nThis endpoint returns a list of contact segments that can be used to organize contacts.",
+    "method": "GET",
+    "path": "/api/reach/v1/segmentation/segments",
+    "inputSchema": {
+      "type": "object",
+      "properties": {},
+      "required": []
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
+  {
+    "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.",
+    "method": "POST",
+    "path": "/api/reach/v1/segmentation/segments",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "name": {
+          "type": "string",
+          "description": "name parameter"
+        },
+        "conditions": {
+          "type": "array",
+          "description": "conditions parameter",
+          "items": {
+            "type": "object",
+            "description": "conditions parameter",
+            "properties": {
+              "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",
+                  "opened",
+                  "not_opened",
+                  "clicked",
+                  "not_clicked",
+                  "unsubscribed",
+                  "not_unsubscribed"
+                ]
+              },
+              "value": {
+                "type": "string",
+                "description": "value parameter"
+              },
+              "attribute": {
+                "type": "string",
+                "description": "attribute parameter",
+                "enum": [
+                  "note",
+                  "comment",
+                  "domain",
+                  "integration",
+                  "source",
+                  "name",
+                  "surname",
+                  "email",
+                  "subscribed_at",
+                  "unsubscribed_at",
+                  "subscription_status",
+                  "processed",
+                  "opened",
+                  "clicked",
+                  "delivered",
+                  "bounced",
+                  "unsubscribed",
+                  "dropped",
+                  "tag",
+                  "campaigns"
+                ]
+              }
+            }
+          }
+        },
+        "logic": {
+          "type": "string",
+          "description": "logic parameter",
+          "enum": [
+            "AND",
+            "OR"
+          ]
+        }
+      },
+      "required": [
+        "name",
+        "conditions",
+        "logic"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
+  {
+    "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.",
+    "method": "GET",
+    "path": "/api/reach/v1/segmentation/segments/{segmentUuid}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "segmentUuid": {
+          "type": "string",
+          "description": "Segment uuid parameter"
+        }
+      },
+      "required": [
+        "segmentUuid"
       ]
     },
     "security": [
@@ -3109,7 +3349,7 @@ const TOOLS: OpenApiTool[] = [
   },
   {
     "name": "VPS_recreateVirtualMachineV1",
-    "description": "Recreate a virtual machine from scratch.\n\nThe recreation process involves reinstalling the operating system and resetting the virtual machine to its initial state.\nSnapshots, if there are any, will be deleted.\n\n## Password Requirements\nPassword will be checked against leaked password databases. \nRequirements for the password are:\n- At least 8 characters long\n- At least one uppercase letter\n- At least one lowercase letter\n- At least one number\n- Is not leaked publicly\n\n**This operation is irreversible and will result in the loss of all data stored on the virtual machine!**\n\nUse this endpoint to completely rebuild VPS instances with fresh OS installation.",
+    "description": "Recreate a virtual machine from scratch.\n\nThe recreation process involves reinstalling the operating system and resetting the virtual machine to its initial state.\nSnapshots, if there are any, will be deleted.\n\n## Password Requirements\nPassword will be checked against leaked password databases. \nRequirements for the password are:\n- At least 12 characters long\n- At least one uppercase letter\n- At least one lowercase letter\n- At least one number\n- Is not leaked publicly\n\n**This operation is irreversible and will result in the loss of all data stored on the virtual machine!**\n\nUse this endpoint to completely rebuild VPS instances with fresh OS installation.",
     "method": "POST",
     "path": "/api/vps/v1/virtual-machines/{virtualMachineId}/recreate",
     "inputSchema": {
@@ -3422,7 +3662,7 @@ const SECURITY_SCHEMES: Record<string, SecurityScheme> = {
 
 /**
  * MCP Server for Hostinger API
- * Generated from OpenAPI spec version 0.9.0
+ * Generated from OpenAPI spec version 0.10.0
  */
 class MCPServer {
   private server: Server;
@@ -3444,7 +3684,7 @@ class MCPServer {
     this.server = new Server(
       {
         name: "hostinger-api-mcp",
-        version: "0.1.21",
+        version: "0.1.23",
       },
       {
         capabilities: {
@@ -3469,7 +3709,7 @@ class MCPServer {
       });
     }
     
-    headers['User-Agent'] = 'hostinger-mcp-server/0.1.21';
+    headers['User-Agent'] = 'hostinger-mcp-server/0.1.23';
     
     return headers;
   }
@@ -4666,8 +4906,6 @@ class MCPServer {
       const buildData = {
         ...buildSettings,
         node_version: buildSettings?.node_version || 20,
-        output_directory: buildSettings?.output_directory || 'dist',
-        build_script: buildSettings?.build_script || 'build',
         source_type: 'archive',
         source_options: {
           archive_path: archiveBasename

package/types.d.ts

@@ -1051,10 +1051,6 @@ The contact will be automatically subscribed to email communications.
        * surname parameter
        */
       surname?: string;
-      /**
-       * group_uuids parameter
-       */
-      group_uuids?: array;
       /**
        * note parameter
        */
@@ -1063,6 +1059,86 @@ The contact will be automatically subscribed to email communications.
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * Filter and retrieve contacts based on segmentation criteria.
+
+This endpoint allows filtering contacts using specified conditions and returns a paginated list of matching contacts.
+The results can be filtered using various attributes like email, name, subscription status, etc.
+   */
+  "reach_filterSegmentContactsV1": {
+    params: {
+      /**
+       * conditions parameter
+       */
+      conditions: array;
+      /**
+       * logic parameter
+       */
+      logic: string;
+      /**
+       * page parameter
+       */
+      page?: number;
+      /**
+       * per_page parameter
+       */
+      per_page?: number;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
+  /**
+   * Get a list of all contact segments.
+
+This endpoint returns a list of contact segments that can be used to organize contacts.
+   */
+  "reach_listContactSegmentsV1": {
+    params: {
+
+    };
+    response: any; // Response structure will depend on the API
+  };
+
+  /**
+   * 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.
+   */
+  "reach_createANewContactSegmentV1": {
+    params: {
+      /**
+       * name parameter
+       */
+      name: string;
+      /**
+       * conditions parameter
+       */
+      conditions: array;
+      /**
+       * logic parameter
+       */
+      logic: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
+  /**
+   * 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.
+   */
+  "reach_getSegmentDetailsV1": {
+    params: {
+      /**
+       * Segment uuid parameter
+       */
+      segmentUuid: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * Retrieve all available data centers.
 
@@ -2128,7 +2204,7 @@ Snapshots, if there are any, will be deleted.
 ## Password Requirements
 Password will be checked against leaked password databases. 
 Requirements for the password are:
-- At least 8 characters long
+- At least 12 characters long
 - At least one uppercase letter
 - At least one lowercase letter
 - At least one number

package/server.json

@@ -1,29 +0,0 @@
-{
-  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-10-17/server.schema.json",
-  "name": "io.github.hostinger/hostinger-api-mcp",
-  "description": "MCP server for Hostinger API",
-  "repository": {
-    "url": "https://github.com/hostinger/api-mcp-server",
-    "source": "github"
-  },
-  "version": "0.1.21",
-  "packages": [
-    {
-      "registryType": "npm",
-      "identifier": "hostinger-api-mcp",
-      "version": "0.1.21",
-      "transport": {
-        "type": "stdio"
-      },
-      "environmentVariables": [
-        {
-          "name": "API_TOKEN",
-          "description": "Hostinger API token",
-          "isRequired": true,
-          "isSecret": true,
-          "format": "string"
-        }
-      ]
-    }
-  ]
-}