hostinger-api-mcp 0.0.21 → 0.0.22

package/README.md

@@ -136,6 +136,13 @@ Prices in catalog items is displayed as cents (without floating point), e.g: flo
 
 This endpoint creates a new service order. 
 
+**DEPRECATED**
+
+To purchase a domain, use [`POST /api/domains/v1/portfolio`](/#tag/domains-portfolio/POST/api/domains/v1/portfolio) instead.
+
+To purchase a VPS, use [`POST /api/vps/v1/virtual-machines`](/#tag/vps-virtual-machine/POST/api/vps/v1/virtual-machines) instead.
+
+
 To place order, you need to provide payment method ID and list of price items from the catalog endpoint together with quantity.
 Coupons also can be provided during order creation.
 
@@ -412,7 +419,9 @@ This endpoint retrieves a list of all domains associated with your account.
 
 ### domains_purchaseNewDomainV1
 
-This endpoint allows you to buy (purchase) and register a new domain name. If registration fails, login to hPanel and check the domain registration status.
+This endpoint allows you to buy (purchase) and register a new domain name. 
+
+If registration fails, login to [hPanel](https://hpanel.hostinger.com/) and check the domain registration status.
 
 If no payment method is provided, your default payment method will be used automatically.
 
@@ -428,7 +437,7 @@ Some TLDs require `additional_details` to be provided and these will be validate
 
 - `domain`: Domain name (required)
 - `item_id`: Catalog price item ID (required)
-- `payment_method_id`: Payment method ID 
+- `payment_method_id`: Payment method ID, default will be used if not provided 
 - `domain_contacts`: Domain contact information 
 - `additional_details`: Additional registration data, possible values depends on TLD 
 - `coupons`: Discount coupon codes 
@@ -939,6 +948,24 @@ This endpoint retrieves a list of all available virtual machines.
 
 
 
+### VPS_purchaseNewVirtualMachineV1
+
+This endpoint allows you to buy (purchase) and setup a new virtual machine.
+
+If virtual machine setup fails for any reason, login to [hPanel](https://hpanel.hostinger.com/) and complete the setup manually.
+
+If no payment method is provided, your default payment method will be used automatically.                        
+
+- **Method**: `POST`
+- **Path**: `/api/vps/v1/virtual-machines`
+
+**Parameters**:
+
+- `item_id`: Catalog price item ID (required)
+- `payment_method_id`: Payment method ID, default will be used if not provided 
+- `setup`: setup parameter (required)
+- `coupons`: Discount coupon codes 
+
 ### VPS_getScanMetricsV1
 
 This endpoint retrieves the scan metrics for the [Monarx](https://www.monarx.com/) malware scanner installed on a specified virtual machine.
@@ -995,8 +1022,8 @@ It includes the following metrics:
 **Parameters**:
 
 - `virtualMachineId`: Virtual Machine ID (required)
-- `date_from`: the date-time notation as defined by RFC 3339, section 5.6 (required)
-- `date_to`: the date-time notation as defined by RFC 3339, section 5.6 (required)
+- `date_from`: date_from parameter (required)
+- `date_to`: date_to parameter (required)
 
 ### VPS_setNameserversV1
 
@@ -1133,8 +1160,7 @@ Requirements for the password is the same as in the [recreate virtual machine en
 
 ### VPS_setupNewVirtualMachineV1
 
-This endpoint will setup newly purchased virtual machine. Such virtual machines has `initial` state. 
-New virtual machine can be purchased using [`/api/billing/v1/orders`](/#tag/billing-orders/POST/api/billing/v1/orders) endpoint.                        
+This endpoint will setup newly purchased virtual machine with `initial` state. 
 
 - **Method**: `POST`
 - **Path**: `/api/vps/v1/virtual-machines/{virtualMachineId}/setup`
@@ -1149,9 +1175,9 @@ New virtual machine can be purchased using [`/api/billing/v1/orders`](/#tag/bill
 - `hostname`: Override default hostname of the virtual machine 
 - `install_monarx`: Install Monarx malware scanner (if supported) 
 - `enable_backups`: Enable weekly backup schedule 
-- `ns1`: ns1 parameter 
-- `ns2`: ns2 parameter 
-- `public_key`: public_key parameter 
+- `ns1`: Name server 1 
+- `ns2`: Name server 2 
+- `public_key`: Use SSH key 
 
 ### VPS_getSnapshotV1
 

package/package.json

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

package/server.js

@@ -48,7 +48,7 @@ const TOOLS = [
   },
   {
     "name": "billing_createNewServiceOrderV1",
-    "description": "This endpoint creates a new service order. \n\nTo place order, you need to provide payment method ID and list of price items from the catalog endpoint together with quantity.\nCoupons also can be provided during order creation.\n\nOrders created using this endpoint will be set for automatic renewal.\n\nSome `credit_card` payments might need additional verification, rendering purchase unprocessed.\nWe recommend use other payment methods than `credit_card` if you encounter this issue.",
+    "description": "This endpoint creates a new service order. \n\n**DEPRECATED**\n\nTo purchase a domain, use [`POST /api/domains/v1/portfolio`](/#tag/domains-portfolio/POST/api/domains/v1/portfolio) instead.\n\nTo purchase a VPS, use [`POST /api/vps/v1/virtual-machines`](/#tag/vps-virtual-machine/POST/api/vps/v1/virtual-machines) instead.\n\n\nTo place order, you need to provide payment method ID and list of price items from the catalog endpoint together with quantity.\nCoupons also can be provided during order creation.\n\nOrders created using this endpoint will be set for automatic renewal.\n\nSome `credit_card` payments might need additional verification, rendering purchase unprocessed.\nWe recommend use other payment methods than `credit_card` if you encounter this issue.",
     "method": "POST",
     "path": "/api/billing/v1/orders",
     "inputSchema": {
@@ -739,7 +739,7 @@ const TOOLS = [
   },
   {
     "name": "domains_purchaseNewDomainV1",
-    "description": "This endpoint allows you to buy (purchase) and register a new domain name. If registration fails, login to hPanel and check the domain registration status.\n\nIf no payment method is provided, your default payment method will be used automatically.\n\nIf no WHOIS information is provided, the default contact information for that TLD (Top-Level Domain) will be used. \nBefore making a request, ensure that WHOIS information for the desired TLD exists in your account.\n\nSome TLDs require `additional_details` to be provided and these will be validated before completing the purchase. The required additional details vary by TLD.",
+    "description": "This endpoint allows you to buy (purchase) and register a new domain name. \n\nIf registration fails, login to [hPanel](https://hpanel.hostinger.com/) and check the domain registration status.\n\nIf no payment method is provided, your default payment method will be used automatically.\n\nIf no WHOIS information is provided, the default contact information for that TLD (Top-Level Domain) will be used. \nBefore making a request, ensure that WHOIS information for the desired TLD exists in your account.\n\nSome TLDs require `additional_details` to be provided and these will be validated before completing the purchase. The required additional details vary by TLD.",
     "method": "POST",
     "path": "/api/domains/v1/portfolio",
     "inputSchema": {
@@ -755,7 +755,7 @@ const TOOLS = [
         },
         "payment_method_id": {
           "type": "integer",
-          "description": "Payment method ID"
+          "description": "Payment method ID, default will be used if not provided"
         },
         "domain_contacts": {
           "type": "object",
@@ -1902,6 +1902,46 @@ const TOOLS = [
       }
     ]
   },
+  {
+    "name": "VPS_purchaseNewVirtualMachineV1",
+    "description": "This endpoint allows you to buy (purchase) and setup a new virtual machine.\n\nIf virtual machine setup fails for any reason, login to [hPanel](https://hpanel.hostinger.com/) and complete the setup manually.\n\nIf no payment method is provided, your default payment method will be used automatically.                        ",
+    "method": "POST",
+    "path": "/api/vps/v1/virtual-machines",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "item_id": {
+          "type": "string",
+          "description": "Catalog price item ID"
+        },
+        "payment_method_id": {
+          "type": "integer",
+          "description": "Payment method ID, default will be used if not provided"
+        },
+        "setup": {
+          "type": "string",
+          "description": "setup parameter"
+        },
+        "coupons": {
+          "type": "array",
+          "description": "Discount coupon codes",
+          "items": {
+            "type": "string",
+            "description": "coupons parameter"
+          }
+        }
+      },
+      "required": [
+        "item_id",
+        "setup"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
   {
     "name": "VPS_getScanMetricsV1",
     "description": "This endpoint retrieves the scan metrics for the [Monarx](https://www.monarx.com/) malware scanner installed on a specified virtual machine.\nThe scan metrics provide detailed information about the malware scans performed by Monarx, including the number of scans, \ndetected threats, and other relevant statistics. This information is useful for monitoring the security status of the \nvirtual machine and assessing the effectiveness of the malware scanner.",
@@ -1985,11 +2025,11 @@ const TOOLS = [
         },
         "date_from": {
           "type": "string",
-          "description": "the date-time notation as defined by RFC 3339, section 5.6"
+          "description": "date_from parameter"
         },
         "date_to": {
           "type": "string",
-          "description": "the date-time notation as defined by RFC 3339, section 5.6"
+          "description": "date_to parameter"
         }
       },
       "required": [
@@ -2250,7 +2290,7 @@ const TOOLS = [
   },
   {
     "name": "VPS_setupNewVirtualMachineV1",
-    "description": "This endpoint will setup newly purchased virtual machine. Such virtual machines has `initial` state. \nNew virtual machine can be purchased using [`/api/billing/v1/orders`](/#tag/billing-orders/POST/api/billing/v1/orders) endpoint.                        ",
+    "description": "This endpoint will setup newly purchased virtual machine with `initial` state. ",
     "method": "POST",
     "path": "/api/vps/v1/virtual-machines/{virtualMachineId}/setup",
     "inputSchema": {
@@ -2290,15 +2330,15 @@ const TOOLS = [
         },
         "ns1": {
           "type": "string",
-          "description": "ns1 parameter"
+          "description": "Name server 1"
         },
         "ns2": {
           "type": "string",
-          "description": "ns2 parameter"
+          "description": "Name server 2"
         },
         "public_key": {
           "type": "object",
-          "description": "public_key parameter",
+          "description": "Use SSH key",
           "properties": {
             "name": {
               "type": "string",
@@ -2306,7 +2346,7 @@ const TOOLS = [
             },
             "key": {
               "type": "string",
-              "description": "SSH public key"
+              "description": "Contents of the SSH key"
             }
           }
         }
@@ -2472,7 +2512,7 @@ const SECURITY_SCHEMES = {
 
 /**
  * MCP Server for Hostinger API
- * Generated from OpenAPI spec version 0.0.46
+ * Generated from OpenAPI spec version 0.0.60
  */
 class MCPServer {
   constructor() {
@@ -2490,7 +2530,7 @@ class MCPServer {
     this.server = new Server(
       {
         name: "hostinger-api-mcp",
-        version: "0.0.21",
+        version: "0.0.22",
       },
       {
         capabilities: {
@@ -2515,7 +2555,7 @@ class MCPServer {
       });
     }
     
-    headers['User-Agent'] = 'hostinger-mcp-server/0.0.21';
+    headers['User-Agent'] = 'hostinger-mcp-server/0.0.22';
     
     return headers;
   }

package/server.ts

@@ -64,7 +64,7 @@ const TOOLS: OpenApiTool[] = [
   },
   {
     "name": "billing_createNewServiceOrderV1",
-    "description": "This endpoint creates a new service order. \n\nTo place order, you need to provide payment method ID and list of price items from the catalog endpoint together with quantity.\nCoupons also can be provided during order creation.\n\nOrders created using this endpoint will be set for automatic renewal.\n\nSome `credit_card` payments might need additional verification, rendering purchase unprocessed.\nWe recommend use other payment methods than `credit_card` if you encounter this issue.",
+    "description": "This endpoint creates a new service order. \n\n**DEPRECATED**\n\nTo purchase a domain, use [`POST /api/domains/v1/portfolio`](/#tag/domains-portfolio/POST/api/domains/v1/portfolio) instead.\n\nTo purchase a VPS, use [`POST /api/vps/v1/virtual-machines`](/#tag/vps-virtual-machine/POST/api/vps/v1/virtual-machines) instead.\n\n\nTo place order, you need to provide payment method ID and list of price items from the catalog endpoint together with quantity.\nCoupons also can be provided during order creation.\n\nOrders created using this endpoint will be set for automatic renewal.\n\nSome `credit_card` payments might need additional verification, rendering purchase unprocessed.\nWe recommend use other payment methods than `credit_card` if you encounter this issue.",
     "method": "POST",
     "path": "/api/billing/v1/orders",
     "inputSchema": {
@@ -755,7 +755,7 @@ const TOOLS: OpenApiTool[] = [
   },
   {
     "name": "domains_purchaseNewDomainV1",
-    "description": "This endpoint allows you to buy (purchase) and register a new domain name. If registration fails, login to hPanel and check the domain registration status.\n\nIf no payment method is provided, your default payment method will be used automatically.\n\nIf no WHOIS information is provided, the default contact information for that TLD (Top-Level Domain) will be used. \nBefore making a request, ensure that WHOIS information for the desired TLD exists in your account.\n\nSome TLDs require `additional_details` to be provided and these will be validated before completing the purchase. The required additional details vary by TLD.",
+    "description": "This endpoint allows you to buy (purchase) and register a new domain name. \n\nIf registration fails, login to [hPanel](https://hpanel.hostinger.com/) and check the domain registration status.\n\nIf no payment method is provided, your default payment method will be used automatically.\n\nIf no WHOIS information is provided, the default contact information for that TLD (Top-Level Domain) will be used. \nBefore making a request, ensure that WHOIS information for the desired TLD exists in your account.\n\nSome TLDs require `additional_details` to be provided and these will be validated before completing the purchase. The required additional details vary by TLD.",
     "method": "POST",
     "path": "/api/domains/v1/portfolio",
     "inputSchema": {
@@ -771,7 +771,7 @@ const TOOLS: OpenApiTool[] = [
         },
         "payment_method_id": {
           "type": "integer",
-          "description": "Payment method ID"
+          "description": "Payment method ID, default will be used if not provided"
         },
         "domain_contacts": {
           "type": "object",
@@ -1918,6 +1918,46 @@ const TOOLS: OpenApiTool[] = [
       }
     ]
   },
+  {
+    "name": "VPS_purchaseNewVirtualMachineV1",
+    "description": "This endpoint allows you to buy (purchase) and setup a new virtual machine.\n\nIf virtual machine setup fails for any reason, login to [hPanel](https://hpanel.hostinger.com/) and complete the setup manually.\n\nIf no payment method is provided, your default payment method will be used automatically.                        ",
+    "method": "POST",
+    "path": "/api/vps/v1/virtual-machines",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "item_id": {
+          "type": "string",
+          "description": "Catalog price item ID"
+        },
+        "payment_method_id": {
+          "type": "integer",
+          "description": "Payment method ID, default will be used if not provided"
+        },
+        "setup": {
+          "type": "string",
+          "description": "setup parameter"
+        },
+        "coupons": {
+          "type": "array",
+          "description": "Discount coupon codes",
+          "items": {
+            "type": "string",
+            "description": "coupons parameter"
+          }
+        }
+      },
+      "required": [
+        "item_id",
+        "setup"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ]
+  },
   {
     "name": "VPS_getScanMetricsV1",
     "description": "This endpoint retrieves the scan metrics for the [Monarx](https://www.monarx.com/) malware scanner installed on a specified virtual machine.\nThe scan metrics provide detailed information about the malware scans performed by Monarx, including the number of scans, \ndetected threats, and other relevant statistics. This information is useful for monitoring the security status of the \nvirtual machine and assessing the effectiveness of the malware scanner.",
@@ -2001,11 +2041,11 @@ const TOOLS: OpenApiTool[] = [
         },
         "date_from": {
           "type": "string",
-          "description": "the date-time notation as defined by RFC 3339, section 5.6"
+          "description": "date_from parameter"
         },
         "date_to": {
           "type": "string",
-          "description": "the date-time notation as defined by RFC 3339, section 5.6"
+          "description": "date_to parameter"
         }
       },
       "required": [
@@ -2266,7 +2306,7 @@ const TOOLS: OpenApiTool[] = [
   },
   {
     "name": "VPS_setupNewVirtualMachineV1",
-    "description": "This endpoint will setup newly purchased virtual machine. Such virtual machines has `initial` state. \nNew virtual machine can be purchased using [`/api/billing/v1/orders`](/#tag/billing-orders/POST/api/billing/v1/orders) endpoint.                        ",
+    "description": "This endpoint will setup newly purchased virtual machine with `initial` state. ",
     "method": "POST",
     "path": "/api/vps/v1/virtual-machines/{virtualMachineId}/setup",
     "inputSchema": {
@@ -2306,15 +2346,15 @@ const TOOLS: OpenApiTool[] = [
         },
         "ns1": {
           "type": "string",
-          "description": "ns1 parameter"
+          "description": "Name server 1"
         },
         "ns2": {
           "type": "string",
-          "description": "ns2 parameter"
+          "description": "Name server 2"
         },
         "public_key": {
           "type": "object",
-          "description": "public_key parameter",
+          "description": "Use SSH key",
           "properties": {
             "name": {
               "type": "string",
@@ -2322,7 +2362,7 @@ const TOOLS: OpenApiTool[] = [
             },
             "key": {
               "type": "string",
-              "description": "SSH public key"
+              "description": "Contents of the SSH key"
             }
           }
         }
@@ -2488,7 +2528,7 @@ const SECURITY_SCHEMES: Record<string, SecurityScheme> = {
 
 /**
  * MCP Server for Hostinger API
- * Generated from OpenAPI spec version 0.0.46
+ * Generated from OpenAPI spec version 0.0.60
  */
 class MCPServer {
   private server: Server;
@@ -2510,7 +2550,7 @@ class MCPServer {
     this.server = new Server(
       {
         name: "hostinger-api-mcp",
-        version: "0.0.21",
+        version: "0.0.22",
       },
       {
         capabilities: {
@@ -2535,7 +2575,7 @@ class MCPServer {
       });
     }
     
-    headers['User-Agent'] = 'hostinger-mcp-server/0.0.21';
+    headers['User-Agent'] = 'hostinger-mcp-server/0.0.22';
     
     return headers;
   }

package/types.d.ts

@@ -26,6 +26,13 @@ Prices in catalog items is displayed as cents (without floating point), e.g: flo
   /**
    * This endpoint creates a new service order. 
 
+**DEPRECATED**
+
+To purchase a domain, use [`POST /api/domains/v1/portfolio`](/#tag/domains-portfolio/POST/api/domains/v1/portfolio) instead.
+
+To purchase a VPS, use [`POST /api/vps/v1/virtual-machines`](/#tag/vps-virtual-machine/POST/api/vps/v1/virtual-machines) instead.
+
+
 To place order, you need to provide payment method ID and list of price items from the catalog endpoint together with quantity.
 Coupons also can be provided during order creation.
 
@@ -388,7 +395,9 @@ before transferring the domain to another registrar.
   };
 
   /**
-   * This endpoint allows you to buy (purchase) and register a new domain name. If registration fails, login to hPanel and check the domain registration status.
+   * This endpoint allows you to buy (purchase) and register a new domain name. 
+
+If registration fails, login to [hPanel](https://hpanel.hostinger.com/) and check the domain registration status.
 
 If no payment method is provided, your default payment method will be used automatically.
 
@@ -408,7 +417,7 @@ Some TLDs require `additional_details` to be provided and these will be validate
        */
       item_id: string;
       /**
-       * Payment method ID
+       * Payment method ID, default will be used if not provided
        */
       payment_method_id?: number;
       /**
@@ -1109,6 +1118,35 @@ you need to point your domain A/AAAA records to virtual machine IP as well.
     response: any; // Response structure will depend on the API
   };
 
+  /**
+   * This endpoint allows you to buy (purchase) and setup a new virtual machine.
+
+If virtual machine setup fails for any reason, login to [hPanel](https://hpanel.hostinger.com/) and complete the setup manually.
+
+If no payment method is provided, your default payment method will be used automatically.                        
+   */
+  "undefined": {
+    params: {
+      /**
+       * Catalog price item ID
+       */
+      item_id: string;
+      /**
+       * Payment method ID, default will be used if not provided
+       */
+      payment_method_id?: number;
+      /**
+       * setup parameter
+       */
+      setup: string;
+      /**
+       * Discount coupon codes
+       */
+      coupons?: array;
+    };
+    response: any; // Response structure will depend on the API
+  };
+
   /**
    * This endpoint retrieves the scan metrics for the [Monarx](https://www.monarx.com/) malware scanner installed on a specified virtual machine.
 The scan metrics provide detailed information about the malware scans performed by Monarx, including the number of scans, 
@@ -1171,11 +1209,11 @@ It includes the following metrics:
        */
       virtualMachineId: number;
       /**
-       * the date-time notation as defined by RFC 3339, section 5.6
+       * date_from parameter
        */
       date_from: string;
       /**
-       * the date-time notation as defined by RFC 3339, section 5.6
+       * date_to parameter
        */
       date_to: string;
     };
@@ -1358,8 +1396,7 @@ Requirements for the password is the same as in the [recreate virtual machine en
   };
 
   /**
-   * This endpoint will setup newly purchased virtual machine. Such virtual machines has `initial` state. 
-New virtual machine can be purchased using [`/api/billing/v1/orders`](/#tag/billing-orders/POST/api/billing/v1/orders) endpoint.                        
+   * This endpoint will setup newly purchased virtual machine with `initial` state. 
    */
   "undefined": {
     params: {
@@ -1396,15 +1433,15 @@ New virtual machine can be purchased using [`/api/billing/v1/orders`](/#tag/bill
        */
       enable_backups?: boolean;
       /**
-       * ns1 parameter
+       * Name server 1
        */
       ns1?: string;
       /**
-       * ns2 parameter
+       * Name server 2
        */
       ns2?: string;
       /**
-       * public_key parameter
+       * Use SSH key
        */
       public_key?: object;
     };