hostinger-api-mcp 0.1.7 → 0.1.10

package/.github/ISSUE_TEMPLATE/bug_report.md

@@ -0,0 +1,36 @@
+---
+name: Bug Report
+about: Create a report to help us improve
+title: '[BUG] '
+labels: 'bug'
+assignees: ''
+
+---
+
+## Bug Description
+<!-- Provide a clear and concise description of what the bug is -->
+
+## Steps to Reproduce
+<!-- List the steps to reproduce the behavior -->
+1. Go to '...'
+2. Click on '...'
+3. Scroll down to '...'
+4. See error
+
+## Expected Behavior
+<!-- Describe what you expected to happen -->
+
+## Actual Behavior
+<!-- Describe what actually happened -->
+
+## Screenshots
+<!-- If applicable, add screenshots to help explain your problem -->
+
+## Error Messages / Stack Trace
+<!-- If applicable, paste any error messages or stack traces here -->
+```
+[Paste error message or stack trace here]
+```
+
+## Additional Context
+<!-- Add any other context about the problem here -->

package/README.md

@@ -637,6 +637,66 @@ Use this endpoint to view which domains use specific contact profiles.
 
 - `whoisId`: WHOIS ID (required)
 
+### reach_deleteAContactV1
+
+Delete a contact with the specified UUID.
+
+This endpoint permanently removes a contact from the email marketing system.
+
+- **Method**: `DELETE`
+- **Path**: `/api/reach/v1/contacts/{uuid}`
+
+**Parameters**:
+
+- `uuid`: UUID of the contact to delete (required)
+
+### reach_listContactGroupsV1
+
+Get a list of all contact groups.
+
+This endpoint returns a list of contact groups that can be used to organize contacts.
+
+- **Method**: `GET`
+- **Path**: `/api/reach/v1/contacts/groups`
+
+
+
+### reach_listContactsV1
+
+Get a list of contacts, optionally filtered by group and subscription status.
+
+This endpoint returns a paginated list of contacts with their basic information.
+You can filter contacts by group UUID and subscription status.
+
+- **Method**: `GET`
+- **Path**: `/api/reach/v1/contacts`
+
+**Parameters**:
+
+- `group_uuid`: Filter contacts by group UUID 
+- `subscription_status`: Filter contacts by subscription status 
+- `page`: Page number 
+
+### reach_createANewContactV1
+
+Create a new contact in the email marketing system.
+
+This endpoint allows you to create a new contact with basic information like name, email, and surname.
+You can optionally assign the contact to specific groups and add notes.
+
+The contact will be automatically subscribed to email communications.
+
+- **Method**: `POST`
+- **Path**: `/api/reach/v1/contacts`
+
+**Parameters**:
+
+- `email`: email parameter (required)
+- `name`: name parameter 
+- `surname`: surname parameter 
+- `group_uuids`: group_uuids parameter 
+- `note`: note parameter 
+
 ### VPS_getDataCenterListV1
 
 Retrieve all available data centers.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hostinger-api-mcp",
-  "version": "0.1.7",
+  "version": "0.1.10",
   "description": "MCP server for Hostinger API",
   "repository": {
     "type": "git",

package/server.js

@@ -1030,6 +1030,121 @@ const TOOLS = [
       }
     ]
   },
+  {
+    "name": "reach_deleteAContactV1",
+    "description": "Delete a contact with the specified UUID.\n\nThis endpoint permanently removes a contact from the email marketing system.",
+    "method": "DELETE",
+    "path": "/api/reach/v1/contacts/{uuid}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "uuid": {
+          "type": "string",
+          "description": "UUID of the contact to delete"
+        }
+      },
+      "required": [
+        "uuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
+  {
+    "name": "reach_listContactGroupsV1",
+    "description": "Get a list of all contact groups.\n\nThis endpoint returns a list of contact groups that can be used to organize contacts.",
+    "method": "GET",
+    "path": "/api/reach/v1/contacts/groups",
+    "inputSchema": {
+      "type": "object",
+      "properties": {},
+      "required": []
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
+  {
+    "name": "reach_listContactsV1",
+    "description": "Get a list of contacts, optionally filtered by group and subscription status.\n\nThis endpoint returns a paginated list of contacts with their basic information.\nYou can filter contacts by group UUID and subscription status.",
+    "method": "GET",
+    "path": "/api/reach/v1/contacts",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "group_uuid": {
+          "type": "string",
+          "description": "Filter contacts by group UUID"
+        },
+        "subscription_status": {
+          "type": "string",
+          "description": "Filter contacts by subscription status",
+          "enum": [
+            "subscribed",
+            "unsubscribed"
+          ]
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        }
+      },
+      "required": []
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
+  {
+    "name": "reach_createANewContactV1",
+    "description": "Create a new contact in the email marketing system.\n\nThis endpoint allows you to create a new contact with basic information like name, email, and surname.\nYou can optionally assign the contact to specific groups and add notes.\n\nThe contact will be automatically subscribed to email communications.",
+    "method": "POST",
+    "path": "/api/reach/v1/contacts",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "email": {
+          "type": "string",
+          "description": "email parameter"
+        },
+        "name": {
+          "type": "string",
+          "description": "name parameter"
+        },
+        "surname": {
+          "type": "string",
+          "description": "surname parameter"
+        },
+        "group_uuids": {
+          "type": "array",
+          "description": "group_uuids parameter",
+          "items": {
+            "type": "string",
+            "description": "Group UUID"
+          }
+        },
+        "note": {
+          "type": "string",
+          "description": "note parameter"
+        }
+      },
+      "required": [
+        "email"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
   {
     "name": "VPS_getDataCenterListV1",
     "description": "Retrieve all available data centers.\n\nUse this endpoint to view location options before deploying VPS instances.",
@@ -2792,7 +2907,7 @@ const SECURITY_SCHEMES = {
 
 /**
  * MCP Server for Hostinger API
- * Generated from OpenAPI spec version 0.0.101
+ * Generated from OpenAPI spec version 0.1.7
  */
 class MCPServer {
   constructor() {
@@ -2810,7 +2925,7 @@ class MCPServer {
     this.server = new Server(
       {
         name: "hostinger-api-mcp",
-        version: "0.1.7",
+        version: "0.1.10",
       },
       {
         capabilities: {
@@ -2835,7 +2950,7 @@ class MCPServer {
       });
     }
     
-    headers['User-Agent'] = 'hostinger-mcp-server/0.1.7';
+    headers['User-Agent'] = 'hostinger-mcp-server/0.1.10';
     
     return headers;
   }

package/server.ts

@@ -1047,6 +1047,121 @@ const TOOLS: OpenApiTool[] = [
       }
     ]
   },
+  {
+    "name": "reach_deleteAContactV1",
+    "description": "Delete a contact with the specified UUID.\n\nThis endpoint permanently removes a contact from the email marketing system.",
+    "method": "DELETE",
+    "path": "/api/reach/v1/contacts/{uuid}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "uuid": {
+          "type": "string",
+          "description": "UUID of the contact to delete"
+        }
+      },
+      "required": [
+        "uuid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
+  {
+    "name": "reach_listContactGroupsV1",
+    "description": "Get a list of all contact groups.\n\nThis endpoint returns a list of contact groups that can be used to organize contacts.",
+    "method": "GET",
+    "path": "/api/reach/v1/contacts/groups",
+    "inputSchema": {
+      "type": "object",
+      "properties": {},
+      "required": []
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
+  {
+    "name": "reach_listContactsV1",
+    "description": "Get a list of contacts, optionally filtered by group and subscription status.\n\nThis endpoint returns a paginated list of contacts with their basic information.\nYou can filter contacts by group UUID and subscription status.",
+    "method": "GET",
+    "path": "/api/reach/v1/contacts",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "group_uuid": {
+          "type": "string",
+          "description": "Filter contacts by group UUID"
+        },
+        "subscription_status": {
+          "type": "string",
+          "description": "Filter contacts by subscription status",
+          "enum": [
+            "subscribed",
+            "unsubscribed"
+          ]
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        }
+      },
+      "required": []
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
+  {
+    "name": "reach_createANewContactV1",
+    "description": "Create a new contact in the email marketing system.\n\nThis endpoint allows you to create a new contact with basic information like name, email, and surname.\nYou can optionally assign the contact to specific groups and add notes.\n\nThe contact will be automatically subscribed to email communications.",
+    "method": "POST",
+    "path": "/api/reach/v1/contacts",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "email": {
+          "type": "string",
+          "description": "email parameter"
+        },
+        "name": {
+          "type": "string",
+          "description": "name parameter"
+        },
+        "surname": {
+          "type": "string",
+          "description": "surname parameter"
+        },
+        "group_uuids": {
+          "type": "array",
+          "description": "group_uuids parameter",
+          "items": {
+            "type": "string",
+            "description": "Group UUID"
+          }
+        },
+        "note": {
+          "type": "string",
+          "description": "note parameter"
+        }
+      },
+      "required": [
+        "email"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
   {
     "name": "VPS_getDataCenterListV1",
     "description": "Retrieve all available data centers.\n\nUse this endpoint to view location options before deploying VPS instances.",
@@ -2809,7 +2924,7 @@ const SECURITY_SCHEMES: Record<string, SecurityScheme> = {
 
 /**
  * MCP Server for Hostinger API
- * Generated from OpenAPI spec version 0.0.101
+ * Generated from OpenAPI spec version 0.1.7
  */
 class MCPServer {
   private server: Server;
@@ -2831,7 +2946,7 @@ class MCPServer {
     this.server = new Server(
       {
         name: "hostinger-api-mcp",
-        version: "0.1.7",
+        version: "0.1.10",
       },
       {
         capabilities: {
@@ -2856,7 +2971,7 @@ class MCPServer {
       });
     }
     
-    headers['User-Agent'] = 'hostinger-mcp-server/0.1.7';
+    headers['User-Agent'] = 'hostinger-mcp-server/0.1.10';
     
     return headers;
   }

package/types.d.ts

@@ -645,6 +645,91 @@ Use this endpoint to view which domains use specific contact profiles.
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * Delete a contact with the specified UUID.
+
+This endpoint permanently removes a contact from the email marketing system.
+   */
+  "undefined": {
+    params: {
+      /**
+       * UUID of the contact to delete
+       */
+      uuid: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
+  /**
+   * Get a list of all contact groups.
+
+This endpoint returns a list of contact groups that can be used to organize contacts.
+   */
+  "undefined": {
+    params: {
+
+    };
+    response: any; // Response structure will depend on the API
+  };
+
+  /**
+   * Get a list of contacts, optionally filtered by group and subscription status.
+
+This endpoint returns a paginated list of contacts with their basic information.
+You can filter contacts by group UUID and subscription status.
+   */
+  "undefined": {
+    params: {
+      /**
+       * Filter contacts by group UUID
+       */
+      group_uuid?: string;
+      /**
+       * Filter contacts by subscription status
+       */
+      subscription_status?: string;
+      /**
+       * Page number
+       */
+      page?: number;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
+  /**
+   * Create a new contact in the email marketing system.
+
+This endpoint allows you to create a new contact with basic information like name, email, and surname.
+You can optionally assign the contact to specific groups and add notes.
+
+The contact will be automatically subscribed to email communications.
+   */
+  "undefined": {
+    params: {
+      /**
+       * email parameter
+       */
+      email: string;
+      /**
+       * name parameter
+       */
+      name?: string;
+      /**
+       * surname parameter
+       */
+      surname?: string;
+      /**
+       * group_uuids parameter
+       */
+      group_uuids?: array;
+      /**
+       * note parameter
+       */
+      note?: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * Retrieve all available data centers.