hostinger-api-mcp 1.22.1 → 1.24.0

package/.github/workflows/build-release.yaml

@@ -117,3 +117,31 @@ jobs:
 
       - name: Publish to MCP Registry
         run: ./mcp-publisher publish
+
+  notify-failure:
+    needs: [release, publish-npmjs, release-github, publish-mcp]
+    if: failure()
+    runs-on: ubuntu-latest
+    steps:
+      - name: Notify Slack on release failure
+        uses: slackapi/slack-github-action@v2.1.0
+        with:
+          errors: true
+          webhook: ${{ secrets.PLATFORM_INCIDENT_SLACK_CHANNEL_WEBHOOK }}
+          webhook-type: incoming-webhook
+          payload: |
+            text: ":rotating_light: Release failed in ${{ github.repository }}"
+            blocks:
+              - type: section
+                text:
+                  type: mrkdwn
+                  text: |
+                    :rotating_light: *Release failed:* `${{ github.repository }}`
+                    *Commit:* <${{ github.server_url }}/${{ github.repository }}/commit/${{ github.sha }}|${{ github.sha }}>
+              - type: actions
+                elements:
+                  - type: button
+                    text:
+                      type: plain_text
+                      text: "View failed run"
+                    url: "${{ github.server_url }}/${{ github.repository }}/actions/runs/${{ github.run_id }}"

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 (268 total)
+- `hostinger-api-mcp` — unified server with every tool (275 total)
 - `hostinger-agency-hosting-mcp` — 27 tools for agency-hosting
 - `hostinger-billing-mcp` — 8 tools for billing
 - `hostinger-dns-mcp` — 8 tools for dns
@@ -57,7 +57,7 @@ This package installs the following MCP server commands:
 - `hostinger-ecommerce-mcp` — 12 tools for ecommerce
 - `hostinger-horizons-mcp` — 2 tools for horizons
 - `hostinger-hosting-mcp` — 48 tools for hosting
-- `hostinger-mail-mcp` — 31 tools for mail
+- `hostinger-mail-mcp` — 38 tools for mail
 - `hostinger-reach-mcp` — 12 tools for reach
 - `hostinger-vps-mcp` — 62 tools for vps
 - `hostinger-wordpress-mcp` — 35 tools for wordpress
@@ -1554,6 +1554,31 @@ complete. The response returns before the removal finishes.
 
 ### `hostinger-mail-mcp`
 
+#### mail_createAliasV1
+
+Create an alias for the given mailbox. The alias address is formed
+from the given local part and the domain of the mailbox. Messages
+sent to the alias are delivered to the mailbox.
+
+- **Method**: `POST`
+- **Path**: `/api/mail/v1/mailboxes/{mailboxId}/aliases`
+
+#### mail_deleteAliasV1
+
+Delete an alias. Messages sent to the alias address are no longer
+delivered to the mailbox.
+
+- **Method**: `DELETE`
+- **Path**: `/api/mail/v1/aliases/{aliasId}`
+
+#### mail_listAliasesV1
+
+Retrieve a paginated list of aliases across all mailboxes of a mail
+order.
+
+- **Method**: `GET`
+- **Path**: `/api/mail/v1/orders/{orderId}/aliases`
+
 #### mail_createAPITokenV1
 
 Create an API token for the given mail order. The token grants access
@@ -1622,6 +1647,40 @@ mail order.
 - **Method**: `GET`
 - **Path**: `/api/mail/v1/orders/{orderId}/autoreplies`
 
+#### mail_createCatchAllV1
+
+Create a catch-all that routes all messages sent to unknown addresses
+of the domain to the given mailbox. The mailbox address receives a
+confirmation email and the catch-all becomes active only after it is
+confirmed. A domain can have only one catch-all.
+
+- **Method**: `POST`
+- **Path**: `/api/mail/v1/mailboxes/{mailboxId}/catchalls`
+
+#### mail_deleteCatchAllV1
+
+Delete a catch-all. Messages sent to unknown addresses of the domain
+are no longer routed to the mailbox.
+
+- **Method**: `DELETE`
+- **Path**: `/api/mail/v1/catchalls/{catchallId}`
+
+#### mail_listCatchAllsV1
+
+Retrieve a paginated list of catch-alls across all mailboxes of a
+mail order.
+
+- **Method**: `GET`
+- **Path**: `/api/mail/v1/orders/{orderId}/catchalls`
+
+#### mail_resendCatchAllConfirmationV1
+
+Resend the confirmation email to the mailbox address of an
+unconfirmed catch-all.
+
+- **Method**: `POST`
+- **Path**: `/api/mail/v1/catchalls/{catchallId}/confirmation/resend`
+
 #### mail_createForwarderV1
 
 Create a forwarder from the given mailbox to the destination address.

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "hostinger-api-mcp",
-  "version": "1.22.1",
+  "version": "1.24.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.22.1",
+  "version": "1.24.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.22.1",
+  "version": "1.24.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "hostinger-api-mcp",
-      "version": "1.22.1",
+      "version": "1.24.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.20.1
+ * Generated from OpenAPI spec version 1.22.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.20.1
+ * Generated from OpenAPI spec version 1.22.0
  */
 class MCPServer {
   private readonly name: string;

package/src/core/tools/all.js

@@ -1197,7 +1197,8 @@ export default [
           "description": "Filter catalog items by category",
           "enum": [
             "DOMAIN",
-            "VPS"
+            "VPS",
+            "EMAIL"
           ]
         },
         "name": {
@@ -4273,6 +4274,91 @@ export default [
     ],
     "group": "hosting"
   },
+  {
+    "name": "mail_createAliasV1",
+    "description": "Create an alias for the given mailbox. The alias address is formed\nfrom the given local part and the domain of the mailbox. Messages\nsent to the alias are delivered to the mailbox.",
+    "method": "POST",
+    "path": "/api/mail/v1/mailboxes/{mailboxId}/aliases",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "mailboxId": {
+          "type": "string",
+          "description": "Mailbox resource ID"
+        },
+        "local_part": {
+          "type": "string",
+          "description": "Local part of the alias address (the part before the @). The domain is taken from the mailbox. Case-insensitive and stored lowercase; must start and end with a letter or digit; single dots, underscores and hyphens are allowed in between."
+        }
+      },
+      "required": [
+        "mailboxId",
+        "local_part"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_deleteAliasV1",
+    "description": "Delete an alias. Messages sent to the alias address are no longer\ndelivered to the mailbox.",
+    "method": "DELETE",
+    "path": "/api/mail/v1/aliases/{aliasId}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "aliasId": {
+          "type": "string",
+          "description": "Alias resource ID"
+        }
+      },
+      "required": [
+        "aliasId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_listAliasesV1",
+    "description": "Retrieve a paginated list of aliases across all mailboxes of a mail\norder.",
+    "method": "GET",
+    "path": "/api/mail/v1/orders/{orderId}/aliases",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "orderId": {
+          "type": "string",
+          "description": "Order resource ID"
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "Number of items per page"
+        }
+      },
+      "required": [
+        "orderId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
   {
     "name": "mail_createAPITokenV1",
     "description": "Create an API token for the given mail order. The token grants access\nto the [Hostinger Email API](https://api.mail.hostinger.com/), where\nyou can provision and manage the mailboxes it is scoped to.\n\nThe plaintext token is returned only in this response, never again.\nA maximum of 10 tokens can exist per order. Use\n`scope.has_all_mailboxes` to cover all current and future mailboxes,\nor list specific mailboxes in `scope.mailbox_ids`.",
@@ -4526,6 +4612,110 @@ export default [
     ],
     "group": "mail"
   },
+  {
+    "name": "mail_createCatchAllV1",
+    "description": "Create a catch-all that routes all messages sent to unknown addresses\nof the domain to the given mailbox. The mailbox address receives a\nconfirmation email and the catch-all becomes active only after it is\nconfirmed. A domain can have only one catch-all.",
+    "method": "POST",
+    "path": "/api/mail/v1/mailboxes/{mailboxId}/catchalls",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "mailboxId": {
+          "type": "string",
+          "description": "Mailbox resource ID"
+        }
+      },
+      "required": [
+        "mailboxId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_deleteCatchAllV1",
+    "description": "Delete a catch-all. Messages sent to unknown addresses of the domain\nare no longer routed to the mailbox.",
+    "method": "DELETE",
+    "path": "/api/mail/v1/catchalls/{catchallId}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "catchallId": {
+          "type": "string",
+          "description": "Catch-all resource ID"
+        }
+      },
+      "required": [
+        "catchallId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_listCatchAllsV1",
+    "description": "Retrieve a paginated list of catch-alls across all mailboxes of a\nmail order.",
+    "method": "GET",
+    "path": "/api/mail/v1/orders/{orderId}/catchalls",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "orderId": {
+          "type": "string",
+          "description": "Order resource ID"
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "Number of items per page"
+        }
+      },
+      "required": [
+        "orderId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_resendCatchAllConfirmationV1",
+    "description": "Resend the confirmation email to the mailbox address of an\nunconfirmed catch-all.",
+    "method": "POST",
+    "path": "/api/mail/v1/catchalls/{catchallId}/confirmation/resend",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "catchallId": {
+          "type": "string",
+          "description": "Catch-all resource ID"
+        }
+      },
+      "required": [
+        "catchallId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
   {
     "name": "mail_createForwarderV1",
     "description": "Create a forwarder from the given mailbox to the destination address.\nThe destination receives a confirmation email and forwarding becomes\nactive only after it is confirmed.",

package/src/core/tools/all.ts

@@ -1211,7 +1211,8 @@ const tools: OpenApiTool[] = [
           "description": "Filter catalog items by category",
           "enum": [
             "DOMAIN",
-            "VPS"
+            "VPS",
+            "EMAIL"
           ]
         },
         "name": {
@@ -4287,6 +4288,91 @@ const tools: OpenApiTool[] = [
     ],
     "group": "hosting"
   },
+  {
+    "name": "mail_createAliasV1",
+    "description": "Create an alias for the given mailbox. The alias address is formed\nfrom the given local part and the domain of the mailbox. Messages\nsent to the alias are delivered to the mailbox.",
+    "method": "POST",
+    "path": "/api/mail/v1/mailboxes/{mailboxId}/aliases",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "mailboxId": {
+          "type": "string",
+          "description": "Mailbox resource ID"
+        },
+        "local_part": {
+          "type": "string",
+          "description": "Local part of the alias address (the part before the @). The domain is taken from the mailbox. Case-insensitive and stored lowercase; must start and end with a letter or digit; single dots, underscores and hyphens are allowed in between."
+        }
+      },
+      "required": [
+        "mailboxId",
+        "local_part"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_deleteAliasV1",
+    "description": "Delete an alias. Messages sent to the alias address are no longer\ndelivered to the mailbox.",
+    "method": "DELETE",
+    "path": "/api/mail/v1/aliases/{aliasId}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "aliasId": {
+          "type": "string",
+          "description": "Alias resource ID"
+        }
+      },
+      "required": [
+        "aliasId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_listAliasesV1",
+    "description": "Retrieve a paginated list of aliases across all mailboxes of a mail\norder.",
+    "method": "GET",
+    "path": "/api/mail/v1/orders/{orderId}/aliases",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "orderId": {
+          "type": "string",
+          "description": "Order resource ID"
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "Number of items per page"
+        }
+      },
+      "required": [
+        "orderId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
   {
     "name": "mail_createAPITokenV1",
     "description": "Create an API token for the given mail order. The token grants access\nto the [Hostinger Email API](https://api.mail.hostinger.com/), where\nyou can provision and manage the mailboxes it is scoped to.\n\nThe plaintext token is returned only in this response, never again.\nA maximum of 10 tokens can exist per order. Use\n`scope.has_all_mailboxes` to cover all current and future mailboxes,\nor list specific mailboxes in `scope.mailbox_ids`.",
@@ -4540,6 +4626,110 @@ const tools: OpenApiTool[] = [
     ],
     "group": "mail"
   },
+  {
+    "name": "mail_createCatchAllV1",
+    "description": "Create a catch-all that routes all messages sent to unknown addresses\nof the domain to the given mailbox. The mailbox address receives a\nconfirmation email and the catch-all becomes active only after it is\nconfirmed. A domain can have only one catch-all.",
+    "method": "POST",
+    "path": "/api/mail/v1/mailboxes/{mailboxId}/catchalls",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "mailboxId": {
+          "type": "string",
+          "description": "Mailbox resource ID"
+        }
+      },
+      "required": [
+        "mailboxId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_deleteCatchAllV1",
+    "description": "Delete a catch-all. Messages sent to unknown addresses of the domain\nare no longer routed to the mailbox.",
+    "method": "DELETE",
+    "path": "/api/mail/v1/catchalls/{catchallId}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "catchallId": {
+          "type": "string",
+          "description": "Catch-all resource ID"
+        }
+      },
+      "required": [
+        "catchallId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_listCatchAllsV1",
+    "description": "Retrieve a paginated list of catch-alls across all mailboxes of a\nmail order.",
+    "method": "GET",
+    "path": "/api/mail/v1/orders/{orderId}/catchalls",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "orderId": {
+          "type": "string",
+          "description": "Order resource ID"
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "Number of items per page"
+        }
+      },
+      "required": [
+        "orderId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_resendCatchAllConfirmationV1",
+    "description": "Resend the confirmation email to the mailbox address of an\nunconfirmed catch-all.",
+    "method": "POST",
+    "path": "/api/mail/v1/catchalls/{catchallId}/confirmation/resend",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "catchallId": {
+          "type": "string",
+          "description": "Catch-all resource ID"
+        }
+      },
+      "required": [
+        "catchallId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
   {
     "name": "mail_createForwarderV1",
     "description": "Create a forwarder from the given mailbox to the destination address.\nThe destination receives a confirmation email and forwarding becomes\nactive only after it is confirmed.",

package/src/core/tools/billing.js

@@ -13,7 +13,8 @@ export default [
           "description": "Filter catalog items by category",
           "enum": [
             "DOMAIN",
-            "VPS"
+            "VPS",
+            "EMAIL"
           ]
         },
         "name": {

package/src/core/tools/billing.ts

@@ -27,7 +27,8 @@ const tools: OpenApiTool[] = [
           "description": "Filter catalog items by category",
           "enum": [
             "DOMAIN",
-            "VPS"
+            "VPS",
+            "EMAIL"
           ]
         },
         "name": {