hostinger-api-mcp 1.8.1 → 1.9.0

package/README.md

@@ -49,14 +49,15 @@ pnpm update -g hostinger-api-mcp
 
 This package installs the following MCP server commands:
 
-- `hostinger-api-mcp` — unified server with every tool (222 total)
-- `hostinger-agency-hosting-mcp` — 17 tools for agency-hosting
+- `hostinger-api-mcp` — unified server with every tool (224 total)
+- `hostinger-agency-hosting-mcp` — 18 tools for agency-hosting
 - `hostinger-billing-mcp` — 7 tools for billing
 - `hostinger-dns-mcp` — 8 tools for dns
 - `hostinger-domains-mcp` — 19 tools for domains
 - `hostinger-ecommerce-mcp` — 12 tools for ecommerce
 - `hostinger-horizons-mcp` — 2 tools for horizons
 - `hostinger-hosting-mcp` — 48 tools for hosting
+- `hostinger-mail-mcp` — 1 tools for mail
 - `hostinger-reach-mcp` — 12 tools for reach
 - `hostinger-vps-mcp` — 62 tools for vps
 - `hostinger-wordpress-mcp` — 35 tools for wordpress
@@ -323,6 +324,15 @@ Website contents are overwritten by the build result, which is deployed to publi
 - **Method**: `POST`
 - **Path**: `/api/agency-hosting/v1/websites/{website_uid}/build-assets`
 
+#### agency-hosting_clearAgencyPlanWebsiteCacheV1
+
+Clears cache for all domains associated with an Agency Plan website, including its preview domain.
+
+This operation clears all cache types for the website.
+
+- **Method**: `DELETE`
+- **Path**: `/api/agency-hosting/v1/websites/{website_uid}/cache`
+
 #### agency-hosting_listAgencyPlanWebsiteCronJobsV1
 
 Returns a paginated list of cron jobs configured for an Agency Plan website.
@@ -1408,6 +1418,18 @@ complete. The response returns before the removal finishes.
 - **Method**: `DELETE`
 - **Path**: `/api/hosting/v1/websites/{domain}`
 
+### `hostinger-mail-mcp`
+
+#### mail_getMailOrderListV1
+
+Retrieve a paginated list of mail orders associated with your account.
+
+Use this endpoint to monitor your mail services, including their status,
+plan, attached domain, and expiration details.
+
+- **Method**: `GET`
+- **Path**: `/api/mail/v1/orders`
+
 ### `hostinger-reach-mcp`
 
 #### reach_deleteAContactV1

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "hostinger-api-mcp",
-  "version": "1.8.1",
+  "version": "1.9.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.8.1",
+  "version": "1.9.0",
   "mcpName": "io.github.hostinger/hostinger-api-mcp",
   "description": "MCP server for Hostinger API",
   "repository": {
@@ -26,6 +26,7 @@
     "hostinger-ecommerce-mcp": "./src/servers/ecommerce.js",
     "hostinger-horizons-mcp": "./src/servers/horizons.js",
     "hostinger-hosting-mcp": "./src/servers/hosting.js",
+    "hostinger-mail-mcp": "./src/servers/mail.js",
     "hostinger-reach-mcp": "./src/servers/reach.js",
     "hostinger-vps-mcp": "./src/servers/vps.js",
     "hostinger-wordpress-mcp": "./src/servers/wordpress.js"

package/server.json

@@ -6,12 +6,12 @@
     "url": "https://github.com/hostinger/api-mcp-server",
     "source": "github"
   },
-  "version": "1.8.1",
+  "version": "1.9.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "hostinger-api-mcp",
-      "version": "1.8.1",
+      "version": "1.9.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.8.1
+ * Generated from OpenAPI spec version 1.9.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.8.1
+ * Generated from OpenAPI spec version 1.9.0
  */
 class MCPServer {
   private readonly name: string;

package/src/core/tools/agency-hosting.js

@@ -456,6 +456,30 @@ export default [
     ],
     "group": "agency-hosting"
   },
+  {
+    "name": "agency-hosting_clearAgencyPlanWebsiteCacheV1",
+    "description": "Clears cache for all domains associated with an Agency Plan website, including its preview domain.\n\nThis operation clears all cache types for the website.",
+    "method": "DELETE",
+    "path": "/api/agency-hosting/v1/websites/{website_uid}/cache",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "website_uid": {
+          "type": "string",
+          "description": "Agency Plan website UID"
+        }
+      },
+      "required": [
+        "website_uid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "agency-hosting"
+  },
   {
     "name": "agency-hosting_listAgencyPlanWebsiteCronJobsV1",
     "description": "Returns a paginated list of cron jobs configured for an Agency Plan website.\n\nEach entry includes the schedule expression and the command executed on that schedule.",

package/src/core/tools/agency-hosting.ts

@@ -470,6 +470,30 @@ const tools: OpenApiTool[] = [
     ],
     "group": "agency-hosting"
   },
+  {
+    "name": "agency-hosting_clearAgencyPlanWebsiteCacheV1",
+    "description": "Clears cache for all domains associated with an Agency Plan website, including its preview domain.\n\nThis operation clears all cache types for the website.",
+    "method": "DELETE",
+    "path": "/api/agency-hosting/v1/websites/{website_uid}/cache",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "website_uid": {
+          "type": "string",
+          "description": "Agency Plan website UID"
+        }
+      },
+      "required": [
+        "website_uid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "agency-hosting"
+  },
   {
     "name": "agency-hosting_listAgencyPlanWebsiteCronJobsV1",
     "description": "Returns a paginated list of cron jobs configured for an Agency Plan website.\n\nEach entry includes the schedule expression and the command executed on that schedule.",

package/src/core/tools/all.js

@@ -713,6 +713,30 @@ export default [
     ],
     "group": "agency-hosting"
   },
+  {
+    "name": "agency-hosting_clearAgencyPlanWebsiteCacheV1",
+    "description": "Clears cache for all domains associated with an Agency Plan website, including its preview domain.\n\nThis operation clears all cache types for the website.",
+    "method": "DELETE",
+    "path": "/api/agency-hosting/v1/websites/{website_uid}/cache",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "website_uid": {
+          "type": "string",
+          "description": "Agency Plan website UID"
+        }
+      },
+      "required": [
+        "website_uid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "agency-hosting"
+  },
   {
     "name": "agency-hosting_listAgencyPlanWebsiteCronJobsV1",
     "description": "Returns a paginated list of cron jobs configured for an Agency Plan website.\n\nEach entry includes the schedule expression and the command executed on that schedule.",
@@ -3813,6 +3837,59 @@ export default [
     ],
     "group": "hosting"
   },
+  {
+    "name": "mail_getMailOrderListV1",
+    "description": "Retrieve a paginated list of mail orders associated with your account.\n\nUse this endpoint to monitor your mail services, including their status,\nplan, attached domain, and expiration details.",
+    "method": "GET",
+    "path": "/api/mail/v1/orders",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "domain": {
+          "type": "string",
+          "description": "Filter orders by domain name (exact match)"
+        },
+        "status": {
+          "type": "string",
+          "description": "Filter orders by status",
+          "enum": [
+            "pending_setup",
+            "active",
+            "suspended"
+          ]
+        },
+        "is_trial": {
+          "type": "boolean",
+          "description": "Filter orders by trial state"
+        },
+        "sort": {
+          "type": "string",
+          "description": "Sort orders by field. Prefix with `-` for descending order.",
+          "enum": [
+            "created_at",
+            "-created_at",
+            "expires_at",
+            "-expires_at"
+          ]
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "Number of items per page"
+        }
+      },
+      "required": []
+    },
+    "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/all.ts

@@ -727,6 +727,30 @@ const tools: OpenApiTool[] = [
     ],
     "group": "agency-hosting"
   },
+  {
+    "name": "agency-hosting_clearAgencyPlanWebsiteCacheV1",
+    "description": "Clears cache for all domains associated with an Agency Plan website, including its preview domain.\n\nThis operation clears all cache types for the website.",
+    "method": "DELETE",
+    "path": "/api/agency-hosting/v1/websites/{website_uid}/cache",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "website_uid": {
+          "type": "string",
+          "description": "Agency Plan website UID"
+        }
+      },
+      "required": [
+        "website_uid"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "agency-hosting"
+  },
   {
     "name": "agency-hosting_listAgencyPlanWebsiteCronJobsV1",
     "description": "Returns a paginated list of cron jobs configured for an Agency Plan website.\n\nEach entry includes the schedule expression and the command executed on that schedule.",
@@ -3827,6 +3851,59 @@ const tools: OpenApiTool[] = [
     ],
     "group": "hosting"
   },
+  {
+    "name": "mail_getMailOrderListV1",
+    "description": "Retrieve a paginated list of mail orders associated with your account.\n\nUse this endpoint to monitor your mail services, including their status,\nplan, attached domain, and expiration details.",
+    "method": "GET",
+    "path": "/api/mail/v1/orders",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "domain": {
+          "type": "string",
+          "description": "Filter orders by domain name (exact match)"
+        },
+        "status": {
+          "type": "string",
+          "description": "Filter orders by status",
+          "enum": [
+            "pending_setup",
+            "active",
+            "suspended"
+          ]
+        },
+        "is_trial": {
+          "type": "boolean",
+          "description": "Filter orders by trial state"
+        },
+        "sort": {
+          "type": "string",
+          "description": "Sort orders by field. Prefix with `-` for descending order.",
+          "enum": [
+            "created_at",
+            "-created_at",
+            "expires_at",
+            "-expires_at"
+          ]
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "Number of items per page"
+        }
+      },
+      "required": []
+    },
+    "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

@@ -0,0 +1,56 @@
+// Auto-generated tool list for group: mail
+export default [
+  {
+    "name": "mail_getMailOrderListV1",
+    "description": "Retrieve a paginated list of mail orders associated with your account.\n\nUse this endpoint to monitor your mail services, including their status,\nplan, attached domain, and expiration details.",
+    "method": "GET",
+    "path": "/api/mail/v1/orders",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "domain": {
+          "type": "string",
+          "description": "Filter orders by domain name (exact match)"
+        },
+        "status": {
+          "type": "string",
+          "description": "Filter orders by status",
+          "enum": [
+            "pending_setup",
+            "active",
+            "suspended"
+          ]
+        },
+        "is_trial": {
+          "type": "boolean",
+          "description": "Filter orders by trial state"
+        },
+        "sort": {
+          "type": "string",
+          "description": "Sort orders by field. Prefix with `-` for descending order.",
+          "enum": [
+            "created_at",
+            "-created_at",
+            "expires_at",
+            "-expires_at"
+          ]
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "Number of items per page"
+        }
+      },
+      "required": []
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  }
+];

package/src/core/tools/mail.ts

@@ -0,0 +1,71 @@
+// Auto-generated tool list for group: mail
+import type { Tool } from "@modelcontextprotocol/sdk/types.js";
+
+export interface OpenApiTool extends Tool {
+  method: string;
+  path: string;
+  security: unknown[];
+  custom?: boolean;
+  group?: string;
+  topic?: string;
+  handlerMethod?: string;
+  templateFile?: string;
+  templateFileTS?: string;
+}
+
+const tools: OpenApiTool[] = [
+  {
+    "name": "mail_getMailOrderListV1",
+    "description": "Retrieve a paginated list of mail orders associated with your account.\n\nUse this endpoint to monitor your mail services, including their status,\nplan, attached domain, and expiration details.",
+    "method": "GET",
+    "path": "/api/mail/v1/orders",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "domain": {
+          "type": "string",
+          "description": "Filter orders by domain name (exact match)"
+        },
+        "status": {
+          "type": "string",
+          "description": "Filter orders by status",
+          "enum": [
+            "pending_setup",
+            "active",
+            "suspended"
+          ]
+        },
+        "is_trial": {
+          "type": "boolean",
+          "description": "Filter orders by trial state"
+        },
+        "sort": {
+          "type": "string",
+          "description": "Sort orders by field. Prefix with `-` for descending order.",
+          "enum": [
+            "created_at",
+            "-created_at",
+            "expires_at",
+            "-expires_at"
+          ]
+        },
+        "page": {
+          "type": "integer",
+          "description": "Page number"
+        },
+        "per_page": {
+          "type": "integer",
+          "description": "Number of items per page"
+        }
+      },
+      "required": []
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "mail"
+  }
+];
+export default tools;

package/src/servers/agency-hosting.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/agency-hosting.js';
 
-startServer({ name: 'hostinger-agency-hosting-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-agency-hosting-mcp', version: '1.9.0', tools });

package/src/servers/agency-hosting.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/agency-hosting.js';
 
-startServer({ name: 'hostinger-agency-hosting-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-agency-hosting-mcp', version: '1.9.0', tools });

package/src/servers/all.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/all.js';
 
-startServer({ name: 'hostinger-api-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-api-mcp', version: '1.9.0', tools });

package/src/servers/all.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/all.js';
 
-startServer({ name: 'hostinger-api-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-api-mcp', version: '1.9.0', tools });

package/src/servers/billing.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/billing.js';
 
-startServer({ name: 'hostinger-billing-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-billing-mcp', version: '1.9.0', tools });

package/src/servers/billing.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/billing.js';
 
-startServer({ name: 'hostinger-billing-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-billing-mcp', version: '1.9.0', tools });

package/src/servers/dns.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/dns.js';
 
-startServer({ name: 'hostinger-dns-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-dns-mcp', version: '1.9.0', tools });

package/src/servers/dns.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/dns.js';
 
-startServer({ name: 'hostinger-dns-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-dns-mcp', version: '1.9.0', tools });

package/src/servers/domains.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/domains.js';
 
-startServer({ name: 'hostinger-domains-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-domains-mcp', version: '1.9.0', tools });

package/src/servers/domains.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/domains.js';
 
-startServer({ name: 'hostinger-domains-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-domains-mcp', version: '1.9.0', tools });

package/src/servers/ecommerce.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/ecommerce.js';
 
-startServer({ name: 'hostinger-ecommerce-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-ecommerce-mcp', version: '1.9.0', tools });

package/src/servers/ecommerce.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/ecommerce.js';
 
-startServer({ name: 'hostinger-ecommerce-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-ecommerce-mcp', version: '1.9.0', tools });

package/src/servers/horizons.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/horizons.js';
 
-startServer({ name: 'hostinger-horizons-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-horizons-mcp', version: '1.9.0', tools });

package/src/servers/horizons.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/horizons.js';
 
-startServer({ name: 'hostinger-horizons-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-horizons-mcp', version: '1.9.0', tools });

package/src/servers/hosting.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/hosting.js';
 
-startServer({ name: 'hostinger-hosting-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-hosting-mcp', version: '1.9.0', tools });

package/src/servers/hosting.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/hosting.js';
 
-startServer({ name: 'hostinger-hosting-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-hosting-mcp', version: '1.9.0', tools });

package/src/servers/mail.js

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+// Auto-generated entry for group: mail
+import { startServer } from '../core/runtime.js';
+import tools from '../core/tools/mail.js';
+
+startServer({ name: 'hostinger-mail-mcp', version: '1.9.0', tools });

package/src/servers/mail.ts

@@ -0,0 +1,6 @@
+#!/usr/bin/env node
+// Auto-generated entry for group: mail
+import { startServer } from '../core/runtime.js';
+import tools from '../core/tools/mail.js';
+
+startServer({ name: 'hostinger-mail-mcp', version: '1.9.0', tools });

package/src/servers/reach.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/reach.js';
 
-startServer({ name: 'hostinger-reach-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-reach-mcp', version: '1.9.0', tools });

package/src/servers/reach.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/reach.js';
 
-startServer({ name: 'hostinger-reach-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-reach-mcp', version: '1.9.0', tools });

package/src/servers/vps.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/vps.js';
 
-startServer({ name: 'hostinger-vps-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-vps-mcp', version: '1.9.0', tools });

package/src/servers/vps.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/vps.js';
 
-startServer({ name: 'hostinger-vps-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-vps-mcp', version: '1.9.0', tools });

package/src/servers/wordpress.js

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/wordpress.js';
 
-startServer({ name: 'hostinger-wordpress-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-wordpress-mcp', version: '1.9.0', tools });

package/src/servers/wordpress.ts

@@ -3,4 +3,4 @@
 import { startServer } from '../core/runtime.js';
 import tools from '../core/tools/wordpress.js';
 
-startServer({ name: 'hostinger-wordpress-mcp', version: '1.8.1', tools });
+startServer({ name: 'hostinger-wordpress-mcp', version: '1.9.0', tools });

package/types.d.ts

@@ -429,6 +429,21 @@ Website contents are overwritten by the build result, which is deployed to publi
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * Clears cache for all domains associated with an Agency Plan website, including its preview domain.
+
+This operation clears all cache types for the website.
+   */
+  "agency-hosting_clearAgencyPlanWebsiteCacheV1": {
+    params: {
+      /**
+       * Agency Plan website UID
+       */
+      website_uid: string;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * Returns a paginated list of cron jobs configured for an Agency Plan website.
 
@@ -2556,6 +2571,42 @@ complete. The response returns before the removal finishes.
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * Retrieve a paginated list of mail orders associated with your account.
+
+Use this endpoint to monitor your mail services, including their status,
+plan, attached domain, and expiration details.
+   */
+  "mail_getMailOrderListV1": {
+    params: {
+      /**
+       * Filter orders by domain name (exact match)
+       */
+      domain?: string;
+      /**
+       * Filter orders by status
+       */
+      status?: string;
+      /**
+       * Filter orders by trial state
+       */
+      is_trial?: boolean;
+      /**
+       * Sort orders by field. Prefix with `-` for descending order.
+       */
+      sort?: string;
+      /**
+       * Page number
+       */
+      page?: number;
+      /**
+       * Number of items per page
+       */
+      per_page?: number;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * Delete a contact with the specified UUID.