hostinger-api-mcp 1.18.0 → 1.20.0

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 (248 total)
+- `hostinger-api-mcp` — unified server with every tool (258 total)
 - `hostinger-agency-hosting-mcp` — 26 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` — 12 tools for mail
+- `hostinger-mail-mcp` — 22 tools for mail
 - `hostinger-reach-mcp` — 12 tools for reach
 - `hostinger-vps-mcp` — 62 tools for vps
 - `hostinger-wordpress-mcp` — 35 tools for wordpress
@@ -1547,6 +1547,39 @@ complete. The response returns before the removal finishes.
 
 ### `hostinger-mail-mcp`
 
+#### mail_createAPITokenV1
+
+Create an API token for the given mail order. The token grants access
+to the [Hostinger Email API](https://api.mail.hostinger.com/), where
+you can provision and manage the mailboxes it is scoped to.
+
+The plaintext token is returned only in this response, never again.
+A maximum of 10 tokens can exist per order. Use
+`scope.has_all_mailboxes` to cover all current and future mailboxes,
+or list specific mailboxes in `scope.mailbox_ids`.
+
+- **Method**: `POST`
+- **Path**: `/api/mail/v1/orders/{orderId}/api-tokens`
+
+#### mail_revokeAPITokenV1
+
+Revoke an API token. The token immediately loses access to the
+[Hostinger Email API](https://api.mail.hostinger.com/). This action
+cannot be undone.
+
+- **Method**: `DELETE`
+- **Path**: `/api/mail/v1/api-tokens/{tokenId}`
+
+#### mail_listAPITokensV1
+
+Retrieve a paginated list of
+[Hostinger Email API](https://api.mail.hostinger.com/) tokens across
+all your mail orders, optionally filtered by order. Plaintext tokens
+are never included; they are returned only when a token is created.
+
+- **Method**: `GET`
+- **Path**: `/api/mail/v1/api-tokens`
+
 #### mail_listAccessLogsV1
 
 Retrieve paginated access logs for the domain attached to the given
@@ -1657,6 +1690,68 @@ every delivery.
 - **Method**: `POST`
 - **Path**: `/api/mail/v1/mailboxes/{mailboxId}/webhooks`
 
+#### mail_listWebhookDeliveryLogsV1
+
+Retrieve a paginated list of webhook delivery logs for the given mail
+order, including delivery outcome, duration, and retry counts.
+Supports filtering by mailbox.
+
+- **Method**: `GET`
+- **Path**: `/api/mail/v1/orders/{orderId}/webhooks/delivery-logs`
+
+#### mail_getWebhookV1
+
+Retrieve the details of a single webhook. The webhook secret is never
+included; it is returned only when a webhook is created or its secret
+is regenerated.
+
+- **Method**: `GET`
+- **Path**: `/api/mail/v1/webhooks/{webhookId}`
+
+#### mail_deleteWebhookV1
+
+Permanently delete a webhook. This action cannot be undone. After
+deletion the URL no longer receives event notifications.
+
+- **Method**: `DELETE`
+- **Path**: `/api/mail/v1/webhooks/{webhookId}`
+
+#### mail_updateWebhookV1
+
+Partially update a webhook. Only the fields included in the request
+body are changed; omitted fields retain their current values. Pass
+`"description": null` to clear the description.
+
+- **Method**: `PATCH`
+- **Path**: `/api/mail/v1/webhooks/{webhookId}`
+
+#### mail_listWebhooksV1
+
+Retrieve a paginated list of webhooks belonging to the given mail
+order. Supports filtering by mailbox and status. The webhook secret
+is never included; it is returned only when a webhook is created or
+its secret is regenerated.
+
+- **Method**: `GET`
+- **Path**: `/api/mail/v1/orders/{orderId}/webhooks`
+
+#### mail_regenerateWebhookSecretV1
+
+Regenerate the secret of a webhook. The previous secret is
+immediately invalidated. The new secret is returned only in this
+response and is sent as a bearer token with every delivery.
+
+- **Method**: `POST`
+- **Path**: `/api/mail/v1/webhooks/{webhookId}/regenerate-secret`
+
+#### mail_testWebhookV1
+
+Send a test delivery to the webhook URL and return the result. Test
+requests are rate limited upstream.
+
+- **Method**: `POST`
+- **Path**: `/api/mail/v1/webhooks/{webhookId}/test`
+
 ### `hostinger-reach-mcp`
 
 #### reach_deleteAContactV1

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "hostinger-api-mcp",
-  "version": "1.18.0",
+  "version": "1.20.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.18.0",
+  "version": "1.20.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.18.0",
+  "version": "1.20.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "hostinger-api-mcp",
-      "version": "1.18.0",
+      "version": "1.20.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.16.0
+ * Generated from OpenAPI spec version 1.18.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.16.0
+ * Generated from OpenAPI spec version 1.18.0
  */
 class MCPServer {
   private readonly name: string;

package/src/core/tools/all.js

@@ -4247,6 +4247,111 @@ export default [
     ],
     "group": "hosting"
   },
+  {
+    "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`.",
+    "method": "POST",
+    "path": "/api/mail/v1/orders/{orderId}/api-tokens",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "orderId": {
+          "type": "string",
+          "description": "Order resource ID"
+        },
+        "name": {
+          "type": "string",
+          "description": "Human-readable label for this token"
+        },
+        "scope": {
+          "type": "object",
+          "description": "Mailbox scope this token can access",
+          "properties": {
+            "has_all_mailboxes": {
+              "type": "boolean",
+              "description": "Grant access to all current and future mailboxes of the order"
+            },
+            "mailbox_ids": {
+              "type": "array",
+              "description": "Required when `has_all_mailboxes` is false. Mailbox resource IDs of this order.",
+              "items": {
+                "type": "string",
+                "description": "mailbox_ids parameter"
+              }
+            }
+          },
+          "required": [
+            "has_all_mailboxes"
+          ]
+        }
+      },
+      "required": [
+        "orderId",
+        "name",
+        "scope"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_revokeAPITokenV1",
+    "description": "Revoke an API token. The token immediately loses access to the\n[Hostinger Email API](https://api.mail.hostinger.com/). This action\ncannot be undone.",
+    "method": "DELETE",
+    "path": "/api/mail/v1/api-tokens/{tokenId}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "tokenId": {
+          "type": "string",
+          "description": "API token ID (returned when the token was created)"
+        }
+      },
+      "required": [
+        "tokenId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_listAPITokensV1",
+    "description": "Retrieve a paginated list of\n[Hostinger Email API](https://api.mail.hostinger.com/) tokens across\nall your mail orders, optionally filtered by order. Plaintext tokens\nare never included; they are returned only when a token is created.",
+    "method": "GET",
+    "path": "/api/mail/v1/api-tokens",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "order_id": {
+          "type": "string",
+          "description": "Filter tokens by order resource ID. Single value or comma-separated list."
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "Number of items per page"
+        }
+      },
+      "required": []
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
   {
     "name": "mail_listAccessLogsV1",
     "description": "Retrieve paginated access logs for the domain attached to the given\nmail order. Supports filtering by account, date range, protocol,\nstatus, and deletion flag. Results are sorted by timestamp descending.",
@@ -4829,6 +4934,239 @@ export default [
     ],
     "group": "mail"
   },
+  {
+    "name": "mail_listWebhookDeliveryLogsV1",
+    "description": "Retrieve a paginated list of webhook delivery logs for the given mail\norder, including delivery outcome, duration, and retry counts.\nSupports filtering by mailbox.",
+    "method": "GET",
+    "path": "/api/mail/v1/orders/{orderId}/webhooks/delivery-logs",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "orderId": {
+          "type": "string",
+          "description": "Order resource ID"
+        },
+        "mailbox_id": {
+          "type": "string",
+          "description": "Filter by the mailbox resource ID the webhooks are attached to"
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "Number of items per page"
+        }
+      },
+      "required": [
+        "orderId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_getWebhookV1",
+    "description": "Retrieve the details of a single webhook. The webhook secret is never\nincluded; it is returned only when a webhook is created or its secret\nis regenerated.",
+    "method": "GET",
+    "path": "/api/mail/v1/webhooks/{webhookId}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "webhookId": {
+          "type": "string",
+          "description": "Webhook ID (returned when the webhook was created)"
+        }
+      },
+      "required": [
+        "webhookId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_deleteWebhookV1",
+    "description": "Permanently delete a webhook. This action cannot be undone. After\ndeletion the URL no longer receives event notifications.",
+    "method": "DELETE",
+    "path": "/api/mail/v1/webhooks/{webhookId}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "webhookId": {
+          "type": "string",
+          "description": "Webhook ID (returned when the webhook was created)"
+        }
+      },
+      "required": [
+        "webhookId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_updateWebhookV1",
+    "description": "Partially update a webhook. Only the fields included in the request\nbody are changed; omitted fields retain their current values. Pass\n`\"description\": null` to clear the description.",
+    "method": "PATCH",
+    "path": "/api/mail/v1/webhooks/{webhookId}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "webhookId": {
+          "type": "string",
+          "description": "Webhook ID (returned when the webhook was created)"
+        },
+        "name": {
+          "type": "string",
+          "description": "New human-readable name for the webhook"
+        },
+        "description": {
+          "type": "string",
+          "description": "New description, or null to clear it"
+        },
+        "events": {
+          "type": "array",
+          "description": "Replaces the full list of subscribed events",
+          "items": {
+            "type": "string",
+            "description": "events parameter",
+            "enum": [
+              "message.received"
+            ]
+          }
+        },
+        "status": {
+          "type": "string",
+          "description": "New status for the webhook",
+          "enum": [
+            "active",
+            "disabled",
+            "paused"
+          ]
+        },
+        "url": {
+          "type": "string",
+          "description": "New URL to deliver events to"
+        }
+      },
+      "required": [
+        "webhookId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_listWebhooksV1",
+    "description": "Retrieve a paginated list of webhooks belonging to the given mail\norder. Supports filtering by mailbox and status. The webhook secret\nis never included; it is returned only when a webhook is created or\nits secret is regenerated.",
+    "method": "GET",
+    "path": "/api/mail/v1/orders/{orderId}/webhooks",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "orderId": {
+          "type": "string",
+          "description": "Order resource ID"
+        },
+        "mailbox_id": {
+          "type": "string",
+          "description": "Filter by the mailbox resource ID the webhooks are attached to"
+        },
+        "status": {
+          "type": "string",
+          "description": "Filter webhooks by status",
+          "enum": [
+            "active",
+            "disabled",
+            "paused"
+          ]
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "Number of items per page"
+        }
+      },
+      "required": [
+        "orderId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_regenerateWebhookSecretV1",
+    "description": "Regenerate the secret of a webhook. The previous secret is\nimmediately invalidated. The new secret is returned only in this\nresponse and is sent as a bearer token with every delivery.",
+    "method": "POST",
+    "path": "/api/mail/v1/webhooks/{webhookId}/regenerate-secret",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "webhookId": {
+          "type": "string",
+          "description": "Webhook ID (returned when the webhook was created)"
+        }
+      },
+      "required": [
+        "webhookId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
+  {
+    "name": "mail_testWebhookV1",
+    "description": "Send a test delivery to the webhook URL and return the result. Test\nrequests are rate limited upstream.",
+    "method": "POST",
+    "path": "/api/mail/v1/webhooks/{webhookId}/test",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "webhookId": {
+          "type": "string",
+          "description": "Webhook ID (returned when the webhook was created)"
+        }
+      },
+      "required": [
+        "webhookId"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  },
   {
     "name": "reach_deleteAContactV1",
     "description": "Delete a contact with the specified UUID.\n\nThis endpoint permanently removes a contact from the email marketing system.",