hostinger-api-mcp 1.18.0 → 1.20.0

package/src/core/tools/all.ts

@@ -4261,6 +4261,111 @@ const tools: OpenApiTool[] = [
     ],
     "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.",
@@ -4843,6 +4948,239 @@ const tools: OpenApiTool[] = [
     ],
     "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.",

package/src/core/tools/mail.js

@@ -1,5 +1,110 @@
 // Auto-generated tool list for group: mail
 export default [
+  {
+    "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.",
@@ -581,5 +686,238 @@ 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"
   }
 ];