@hostinger/mcp 2.18.0 → 3.1.0

package/CHANGELOG.md

@@ -4,6 +4,33 @@ Generated at release time from the diff between the previous and current
 build. Tool changes are listed individually; everything else is summarised
 by area.
 
+## v3.1.0 — 2026-10-16
+
+### Operations
+
+- Changed the description and input schema of `ecommerce_products_update`
+- Changed the input schema of `ecommerce_products_create-physical`
+- Changed the description and input schema of `ecommerce_product-variants_update-in-batch`
+
+### Also in this release
+
+- Documentation: `README.md`
+- Request handling and authentication: `src/core/runtime.js`, `src/core/runtime.ts`
+- Build and packaging: `types.d.ts`
+
+## v3.0.0 — 2026-10-15
+
+### Operations
+
+- Added `wordpress_ai-content_generation-result` — Get generation result
+- Changed the description of `wordpress_ai-content_generate-images`
+
+### Also in this release
+
+- Documentation: `README.md`
+- Request handling and authentication: `src/core/runtime.js`, `src/core/runtime.ts`
+- Build and packaging: `types.d.ts`
+
 ## v2.18.0 — 2026-10-15
 
 ### Operations

package/README.md

@@ -69,7 +69,7 @@ pnpm update -g @hostinger/mcp
 
 This package installs the following MCP server commands:
 
-- `hostinger-api-mcp` — unified server over every operation (420 total)
+- `hostinger-api-mcp` — unified server over every operation (421 total)
 - `hostinger-agency-hosting-mcp` — 42 operations for agency-hosting
 - `hostinger-agent-readiness-mcp` — 3 operations for agent-readiness
 - `hostinger-billing-mcp` — 9 operations for billing
@@ -81,7 +81,7 @@ This package installs the following MCP server commands:
 - `hostinger-mail-mcp` — 38 operations for mail
 - `hostinger-reach-mcp` — 56 operations for reach
 - `hostinger-vps-mcp` — 67 operations for vps
-- `hostinger-wordpress-mcp` — 39 operations for wordpress
+- `hostinger-wordpress-mcp` — 40 operations for wordpress
 
 Every binary exposes the same three tools; a scoped binary only searches and executes its own group's operations. `hostinger-api-mcp` remains the backwards-compatible default.
 
@@ -1554,9 +1554,11 @@ subscribers is archived instead of deleted so its data stays available.
 
 #### ecommerce_products_update
 
-Update a product's name, description or status. Set status to published to make it buyable,
-draft to hide it, or archived to retire it. Variants, prices and inventory are managed
-through the variant endpoints, not here. Returns the updated product summary.
+Update a product's name, description, status, SEO settings or collections. Set status to
+published to make it buyable, draft to hide it, or archived to retire it. SEO settings (title,
+description, slug) left out keep their values. collection_changes adds or removes collections
+without touching the others. Variants, prices and inventory are managed through the variant
+endpoints, not here. Returns the updated product summary.
 
 - **Method**: `PATCH`
 - **Path**: `/api/ecommerce/v1/stores/{store_id}/products/{product_id}`
@@ -1662,8 +1664,8 @@ plus its default currency. Useful to verify prerequisites before building a stor
 
 #### ecommerce_product-variants_update-in-batch
 
-Update up to 100 existing variants in place by id — title, inventory, stock tracking and
-prices. Variants omitted from the request are left untouched. Prices replace the variant's
+Update up to 100 existing variants in place by id — title, SKU, inventory, stock tracking
+and prices. Variants omitted from the request are left untouched. Prices replace the variant's
 existing prices in full. Returns the updated variants.
 
 - **Method**: `PATCH`
@@ -4640,13 +4642,20 @@ Use this endpoint to power off running VPS instances.
 
 #### wordpress_ai-content_generate-images
 
-Generate one or more images from a prompt and an image type for the specified
-WordPress installation. Images are returned inline as base64-encoded PNGs. They match
-the requested aspect ratio and are never smaller than the requested size; logos are
-transparent PNGs cropped to the mark.
+Start generating one or more images from a prompt and an image type for the specified
+WordPress installation. The generation runs asynchronously: the response is returned
+right away with `status: in-progress` and a `generation_id`. Poll
+GET /api/hosting/v1/accounts/{username}/wordpress/{software}/content/generations/{generation_id}
+every few seconds until `status` is `completed` or `failed`.
 
-Generation is synchronous and can take up to a minute. The endpoint is limited to
-10 requests per minute.
+A completed generation returns temporary image URLs together with the time they expire;
+download the images before then. Images match the requested aspect ratio and are never
+smaller than the requested size; logos are transparent images cropped to the mark.
+
+Only one image generation can run per installation at a time: while one is still in
+progress the endpoint returns 409 without the ID of the running generation, so a caller
+that did not receive the `202` has to wait for it to finish (up to a few minutes) before
+starting a new one. The endpoint is limited to 10 requests per minute.
 
 Provide the WordPress installation (software) identifier in the path. It can
 be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).
@@ -4654,6 +4663,25 @@ be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).
 - **Method**: `POST`
 - **Path**: `/api/hosting/v1/accounts/{username}/wordpress/{software}/content/images/generate`
 
+#### wordpress_ai-content_generation-result
+
+Get the result of an AI content generation started for the specified WordPress
+installation, such as an image generation started with
+POST /api/hosting/v1/accounts/{username}/wordpress/{software}/content/images/generate.
+
+While the generation is still running only `status: in-progress` is returned; poll every
+few seconds. Once `completed`, `result` holds the generated content shaped according to
+`type`: temporary image URLs together with the time they expire for `image-generation`, or
+the generated website document for `website-generation` (started from the Hostinger
+WordPress plugin). A `failed` generation has no `result`. Unknown or expired generation
+IDs return 404.
+
+Provide the WordPress installation (software) identifier in the path. It can
+be obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).
+
+- **Method**: `GET`
+- **Path**: `/api/hosting/v1/accounts/{username}/wordpress/{software}/content/generations/{generation_id}`
+
 #### wordpress_ai-tools_show-option-status
 
 Show the current AI option status for the Hostinger Tools plugin on the

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "hostinger-api-mcp",
-  "version": "2.18.0",
+  "version": "3.1.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/mcp",
-  "version": "2.18.0",
+  "version": "3.1.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": "2.18.0",
+  "version": "3.1.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@hostinger/mcp",
-      "version": "2.18.0",
+      "version": "3.1.0",
       "transport": {
         "type": "stdio"
       },

package/src/core/runtime.js

@@ -64,7 +64,7 @@ const GetSkillRequestSchema = z.object({
 
 /**
  * MCP Server for Hostinger API
- * Generated from OpenAPI spec version 1.68.0
+ * Generated from OpenAPI spec version 2.1.0
  */
 class MCPServer {
   constructor({ name, version, tools, instructions, skills = [] }) {

package/src/core/runtime.ts

@@ -94,7 +94,7 @@ interface Skill { uri: string; frontmatter: Record<string, unknown>; resources:
 
 /**
  * MCP Server for Hostinger API
- * Generated from OpenAPI spec version 1.68.0
+ * Generated from OpenAPI spec version 2.1.0
  */
 class MCPServer {
   private readonly name: string;

package/src/core/tools/all.js

@@ -4845,7 +4845,7 @@ export default [
       "destructiveHint": true,
       "idempotentHint": true
     },
-    "description": "Update a product's name, description or status. Set status to published to make it buyable,\ndraft to hide it, or archived to retire it. Variants, prices and inventory are managed\nthrough the variant endpoints, not here. Returns the updated product summary.",
+    "description": "Update a product's name, description, status, SEO settings or collections. Set status to\npublished to make it buyable, draft to hide it, or archived to retire it. SEO settings (title,\ndescription, slug) left out keep their values. collection_changes adds or removes collections\nwithout touching the others. Variants, prices and inventory are managed through the variant\nendpoints, not here. Returns the updated product summary.",
     "method": "PATCH",
     "path": "/api/ecommerce/v1/stores/{store_id}/products/{product_id}",
     "inputSchema": {
@@ -4875,6 +4875,64 @@ export default [
             "published",
             "archived"
           ]
+        },
+        "seo_settings": {
+          "type": "object",
+          "description": "Search-engine settings to change. Send at least one field; omitted fields keep their current values.",
+          "properties": {
+            "title": {
+              "type": "string",
+              "description": "Search-engine title for the product page."
+            },
+            "description": {
+              "type": "string",
+              "description": "Search-engine description for the product page."
+            },
+            "slug": {
+              "type": "string",
+              "description": "URL slug of the product page. Lowercase letters, digits and dashes."
+            }
+          }
+        },
+        "collection_changes": {
+          "type": "object",
+          "description": "Adds the product to or removes it from collections without touching its other collections. Send at least one collection in add or remove.",
+          "properties": {
+            "add": {
+              "type": "array",
+              "description": "Collections to add the product to. Every id must exist in the store.",
+              "items": {
+                "type": "object",
+                "description": "add parameter",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "description": "The collection id."
+                  }
+                },
+                "required": [
+                  "id"
+                ]
+              }
+            },
+            "remove": {
+              "type": "array",
+              "description": "Collections to take the product out of. Ids the product is not in are ignored.",
+              "items": {
+                "type": "object",
+                "description": "remove parameter",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "description": "The collection id."
+                  }
+                },
+                "required": [
+                  "id"
+                ]
+              }
+            }
+          }
         }
       },
       "required": [
@@ -5047,6 +5105,24 @@ export default [
         "currency": {
           "type": "string",
           "description": "ISO 4217 currency code. Defaults to the store's default currency when omitted."
+        },
+        "seo_settings": {
+          "type": "object",
+          "description": "Search-engine settings. Omitted fields are generated from the name and description; a slug already in use gets a numeric suffix. Send at least one field.",
+          "properties": {
+            "title": {
+              "type": "string",
+              "description": "Search-engine title for the product page."
+            },
+            "description": {
+              "type": "string",
+              "description": "Search-engine description for the product page."
+            },
+            "slug": {
+              "type": "string",
+              "description": "URL slug of the product page. Lowercase letters, digits and dashes."
+            }
+          }
         }
       },
       "required": [
@@ -5424,7 +5500,7 @@ export default [
       "destructiveHint": true,
       "idempotentHint": true
     },
-    "description": "Update up to 100 existing variants in place by id — title, inventory, stock tracking and\nprices. Variants omitted from the request are left untouched. Prices replace the variant's\nexisting prices in full. Returns the updated variants.",
+    "description": "Update up to 100 existing variants in place by id — title, SKU, inventory, stock tracking\nand prices. Variants omitted from the request are left untouched. Prices replace the variant's\nexisting prices in full. Returns the updated variants.",
     "method": "PATCH",
     "path": "/api/ecommerce/v1/stores/{store_id}/products/{product_id}/variants/batch",
     "inputSchema": {
@@ -5453,6 +5529,10 @@ export default [
                 "type": "string",
                 "description": "The variant title."
               },
+              "sku": {
+                "type": "string",
+                "description": "The variant SKU."
+              },
               "inventory_quantity": {
                 "type": "integer",
                 "description": "Units in stock."
@@ -15963,7 +16043,7 @@ export default [
       "readOnlyHint": false,
       "destructiveHint": false
     },
-    "description": "Generate one or more images from a prompt and an image type for the specified\nWordPress installation. Images are returned inline as base64-encoded PNGs. They match\nthe requested aspect ratio and are never smaller than the requested size; logos are\ntransparent PNGs cropped to the mark.\n\nGeneration is synchronous and can take up to a minute. The endpoint is limited to\n10 requests per minute.\n\nProvide the WordPress installation (software) identifier in the path. It can\nbe obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).",
+    "description": "Start generating one or more images from a prompt and an image type for the specified\nWordPress installation. The generation runs asynchronously: the response is returned\nright away with `status: in-progress` and a `generation_id`. Poll\nGET /api/hosting/v1/accounts/{username}/wordpress/{software}/content/generations/{generation_id}\nevery few seconds until `status` is `completed` or `failed`.\n\nA completed generation returns temporary image URLs together with the time they expire;\ndownload the images before then. Images match the requested aspect ratio and are never\nsmaller than the requested size; logos are transparent images cropped to the mark.\n\nOnly one image generation can run per installation at a time: while one is still in\nprogress the endpoint returns 409 without the ID of the running generation, so a caller\nthat did not receive the `202` has to wait for it to finish (up to a few minutes) before\nstarting a new one. The endpoint is limited to 10 requests per minute.\n\nProvide the WordPress installation (software) identifier in the path. It can\nbe obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).",
     "method": "POST",
     "path": "/api/hosting/v1/accounts/{username}/wordpress/{software}/content/images/generate",
     "inputSchema": {
@@ -16028,6 +16108,54 @@ export default [
     ],
     "group": "wordpress"
   },
+  {
+    "name": "wordpress_ai-content_generation-result",
+    "title": "Get generation result",
+    "annotations": {
+      "title": "Get generation result",
+      "readOnlyHint": true,
+      "destructiveHint": false
+    },
+    "description": "Get the result of an AI content generation started for the specified WordPress\ninstallation, such as an image generation started with\nPOST /api/hosting/v1/accounts/{username}/wordpress/{software}/content/images/generate.\n\nWhile the generation is still running only `status: in-progress` is returned; poll every\nfew seconds. Once `completed`, `result` holds the generated content shaped according to\n`type`: temporary image URLs together with the time they expire for `image-generation`, or\nthe generated website document for `website-generation` (started from the Hostinger\nWordPress plugin). A `failed` generation has no `result`. Unknown or expired generation\nIDs return 404.\n\nProvide the WordPress installation (software) identifier in the path. It can\nbe obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).",
+    "method": "GET",
+    "path": "/api/hosting/v1/accounts/{username}/wordpress/{software}/content/generations/{generation_id}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "username parameter"
+        },
+        "software": {
+          "type": "string",
+          "description": "WordPress installation (software) identifier"
+        },
+        "generation_id": {
+          "type": "string",
+          "description": "Generation ID returned when the generation was started"
+        },
+        "type": {
+          "type": "string",
+          "description": "Generation type to look up. When omitted, every generation type is checked.",
+          "enum": [
+            "website-generation",
+            "image-generation"
+          ]
+        }
+      },
+      "required": [
+        "username",
+        "software",
+        "generation_id"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "wordpress"
+  },
   {
     "name": "wordpress_ai-tools_show-option-status",
     "title": "Show AI option status",

package/src/core/tools/all.ts

@@ -4859,7 +4859,7 @@ const tools: OpenApiTool[] = [
       "destructiveHint": true,
       "idempotentHint": true
     },
-    "description": "Update a product's name, description or status. Set status to published to make it buyable,\ndraft to hide it, or archived to retire it. Variants, prices and inventory are managed\nthrough the variant endpoints, not here. Returns the updated product summary.",
+    "description": "Update a product's name, description, status, SEO settings or collections. Set status to\npublished to make it buyable, draft to hide it, or archived to retire it. SEO settings (title,\ndescription, slug) left out keep their values. collection_changes adds or removes collections\nwithout touching the others. Variants, prices and inventory are managed through the variant\nendpoints, not here. Returns the updated product summary.",
     "method": "PATCH",
     "path": "/api/ecommerce/v1/stores/{store_id}/products/{product_id}",
     "inputSchema": {
@@ -4889,6 +4889,64 @@ const tools: OpenApiTool[] = [
             "published",
             "archived"
           ]
+        },
+        "seo_settings": {
+          "type": "object",
+          "description": "Search-engine settings to change. Send at least one field; omitted fields keep their current values.",
+          "properties": {
+            "title": {
+              "type": "string",
+              "description": "Search-engine title for the product page."
+            },
+            "description": {
+              "type": "string",
+              "description": "Search-engine description for the product page."
+            },
+            "slug": {
+              "type": "string",
+              "description": "URL slug of the product page. Lowercase letters, digits and dashes."
+            }
+          }
+        },
+        "collection_changes": {
+          "type": "object",
+          "description": "Adds the product to or removes it from collections without touching its other collections. Send at least one collection in add or remove.",
+          "properties": {
+            "add": {
+              "type": "array",
+              "description": "Collections to add the product to. Every id must exist in the store.",
+              "items": {
+                "type": "object",
+                "description": "add parameter",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "description": "The collection id."
+                  }
+                },
+                "required": [
+                  "id"
+                ]
+              }
+            },
+            "remove": {
+              "type": "array",
+              "description": "Collections to take the product out of. Ids the product is not in are ignored.",
+              "items": {
+                "type": "object",
+                "description": "remove parameter",
+                "properties": {
+                  "id": {
+                    "type": "string",
+                    "description": "The collection id."
+                  }
+                },
+                "required": [
+                  "id"
+                ]
+              }
+            }
+          }
         }
       },
       "required": [
@@ -5061,6 +5119,24 @@ const tools: OpenApiTool[] = [
         "currency": {
           "type": "string",
           "description": "ISO 4217 currency code. Defaults to the store's default currency when omitted."
+        },
+        "seo_settings": {
+          "type": "object",
+          "description": "Search-engine settings. Omitted fields are generated from the name and description; a slug already in use gets a numeric suffix. Send at least one field.",
+          "properties": {
+            "title": {
+              "type": "string",
+              "description": "Search-engine title for the product page."
+            },
+            "description": {
+              "type": "string",
+              "description": "Search-engine description for the product page."
+            },
+            "slug": {
+              "type": "string",
+              "description": "URL slug of the product page. Lowercase letters, digits and dashes."
+            }
+          }
         }
       },
       "required": [
@@ -5438,7 +5514,7 @@ const tools: OpenApiTool[] = [
       "destructiveHint": true,
       "idempotentHint": true
     },
-    "description": "Update up to 100 existing variants in place by id — title, inventory, stock tracking and\nprices. Variants omitted from the request are left untouched. Prices replace the variant's\nexisting prices in full. Returns the updated variants.",
+    "description": "Update up to 100 existing variants in place by id — title, SKU, inventory, stock tracking\nand prices. Variants omitted from the request are left untouched. Prices replace the variant's\nexisting prices in full. Returns the updated variants.",
     "method": "PATCH",
     "path": "/api/ecommerce/v1/stores/{store_id}/products/{product_id}/variants/batch",
     "inputSchema": {
@@ -5467,6 +5543,10 @@ const tools: OpenApiTool[] = [
                 "type": "string",
                 "description": "The variant title."
               },
+              "sku": {
+                "type": "string",
+                "description": "The variant SKU."
+              },
               "inventory_quantity": {
                 "type": "integer",
                 "description": "Units in stock."
@@ -15977,7 +16057,7 @@ const tools: OpenApiTool[] = [
       "readOnlyHint": false,
       "destructiveHint": false
     },
-    "description": "Generate one or more images from a prompt and an image type for the specified\nWordPress installation. Images are returned inline as base64-encoded PNGs. They match\nthe requested aspect ratio and are never smaller than the requested size; logos are\ntransparent PNGs cropped to the mark.\n\nGeneration is synchronous and can take up to a minute. The endpoint is limited to\n10 requests per minute.\n\nProvide the WordPress installation (software) identifier in the path. It can\nbe obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).",
+    "description": "Start generating one or more images from a prompt and an image type for the specified\nWordPress installation. The generation runs asynchronously: the response is returned\nright away with `status: in-progress` and a `generation_id`. Poll\nGET /api/hosting/v1/accounts/{username}/wordpress/{software}/content/generations/{generation_id}\nevery few seconds until `status` is `completed` or `failed`.\n\nA completed generation returns temporary image URLs together with the time they expire;\ndownload the images before then. Images match the requested aspect ratio and are never\nsmaller than the requested size; logos are transparent images cropped to the mark.\n\nOnly one image generation can run per installation at a time: while one is still in\nprogress the endpoint returns 409 without the ID of the running generation, so a caller\nthat did not receive the `202` has to wait for it to finish (up to a few minutes) before\nstarting a new one. The endpoint is limited to 10 requests per minute.\n\nProvide the WordPress installation (software) identifier in the path. It can\nbe obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).",
     "method": "POST",
     "path": "/api/hosting/v1/accounts/{username}/wordpress/{software}/content/images/generate",
     "inputSchema": {
@@ -16042,6 +16122,54 @@ const tools: OpenApiTool[] = [
     ],
     "group": "wordpress"
   },
+  {
+    "name": "wordpress_ai-content_generation-result",
+    "title": "Get generation result",
+    "annotations": {
+      "title": "Get generation result",
+      "readOnlyHint": true,
+      "destructiveHint": false
+    },
+    "description": "Get the result of an AI content generation started for the specified WordPress\ninstallation, such as an image generation started with\nPOST /api/hosting/v1/accounts/{username}/wordpress/{software}/content/images/generate.\n\nWhile the generation is still running only `status: in-progress` is returned; poll every\nfew seconds. Once `completed`, `result` holds the generated content shaped according to\n`type`: temporary image URLs together with the time they expire for `image-generation`, or\nthe generated website document for `website-generation` (started from the Hostinger\nWordPress plugin). A `failed` generation has no `result`. Unknown or expired generation\nIDs return 404.\n\nProvide the WordPress installation (software) identifier in the path. It can\nbe obtained from GET /api/hosting/v1/wordpress/installations (the `id` field).",
+    "method": "GET",
+    "path": "/api/hosting/v1/accounts/{username}/wordpress/{software}/content/generations/{generation_id}",
+    "inputSchema": {
+      "type": "object",
+      "properties": {
+        "username": {
+          "type": "string",
+          "description": "username parameter"
+        },
+        "software": {
+          "type": "string",
+          "description": "WordPress installation (software) identifier"
+        },
+        "generation_id": {
+          "type": "string",
+          "description": "Generation ID returned when the generation was started"
+        },
+        "type": {
+          "type": "string",
+          "description": "Generation type to look up. When omitted, every generation type is checked.",
+          "enum": [
+            "website-generation",
+            "image-generation"
+          ]
+        }
+      },
+      "required": [
+        "username",
+        "software",
+        "generation_id"
+      ]
+    },
+    "security": [
+      {
+        "apiToken": []
+      }
+    ],
+    "group": "wordpress"
+  },
   {
     "name": "wordpress_ai-tools_show-option-status",
     "title": "Show AI option status",