hostinger-api-mcp 1.29.0 → 1.31.0

package/README.md

@@ -49,16 +49,16 @@ pnpm update -g hostinger-api-mcp
 
 This package installs the following MCP server commands:
 
-- `hostinger-api-mcp` — unified server with every tool (289 total)
+- `hostinger-api-mcp` — unified server with every tool (300 total)
 - `hostinger-agency-hosting-mcp` — 27 tools for agency-hosting
 - `hostinger-billing-mcp` — 9 tools for billing
 - `hostinger-dns-mcp` — 8 tools for dns
-- `hostinger-domains-mcp` — 36 tools for domains
+- `hostinger-domains-mcp` — 38 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` — 38 tools for mail
-- `hostinger-reach-mcp` — 12 tools for reach
+- `hostinger-reach-mcp` — 21 tools for reach
 - `hostinger-vps-mcp` — 62 tools for vps
 - `hostinger-wordpress-mcp` — 35 tools for wordpress
 
@@ -855,6 +855,29 @@ Use this endpoint to obtain the code required to transfer a domain to another re
 - **Method**: `GET`
 - **Path**: `/api/domains/v1/portfolio/{domain}/auth-code`
 
+#### domains_claimFreeDomainV1
+
+Claim a free domain available on your account and register it.
+
+Unlike purchasing a domain, this consumes a free domain you already have,
+so no payment method is required.
+
+A successful response means the domain is registered. If registration fails, login to
+[hPanel](https://hpanel.hostinger.com/) and check domain registration status.
+
+If no WHOIS information is provided, default contact information for that TLD will be used.
+Before making request, ensure WHOIS information for desired TLD exists in your account.
+
+Some TLDs require `additional_details` to be provided and these will be validated before claiming.
+
+Requests which cannot be fulfilled are rejected with an error code in the response body,
+for example `2037` when no free domain is available.
+
+Use this endpoint to register a domain using a free domain from your account.
+
+- **Method**: `POST`
+- **Path**: `/api/domains/v1/portfolio/claim`
+
 #### domains_enableDomainLockV1
 
 Enable domain lock for the domain.
@@ -957,6 +980,30 @@ Use this endpoint to configure custom DNS hosting for domains.
 - **Method**: `PUT`
 - **Path**: `/api/domains/v1/portfolio/{domain}/nameservers`
 
+#### domains_claimFreeDomainTransferV1
+
+Claim a free domain transfer available on your account and start the transfer.
+
+Unlike purchasing a transfer, this consumes a free domain transfer you already have,
+so no payment method is required.
+
+Before making request, unlock the domain at the current registrar and get its authorization
+code. The transfer is validated first, so domains which cannot be transferred are rejected
+before the free domain transfer is consumed.
+
+A successful response means the transfer has been started. Completion depends on the current
+registrar and can be followed with the [transfer list endpoint](#tag/domains-transfer).
+
+If no WHOIS information is provided, default contact information for that TLD will be used.
+Before making request, ensure WHOIS information for desired TLD exists in your account.
+
+Requests which cannot be fulfilled are rejected with an error code in the response body.
+
+Use this endpoint to transfer a domain using a free domain transfer from your account.
+
+- **Method**: `POST`
+- **Path**: `/api/domains/v1/transfers/claim`
+
 #### domains_getTransferV1
 
 Retrieve the transfer for a specified domain.
@@ -2085,9 +2132,55 @@ Delete a contact with the specified UUID.
 
 This endpoint permanently removes a contact from the email marketing system.
 
+**Deprecated.** This endpoint cannot target a profile, so it always falls back to the
+client's default profile and cannot delete contacts of any other profile. Use
+`DELETE /api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}` instead.
+
 - **Method**: `DELETE`
 - **Path**: `/api/reach/v1/contacts/{uuid}`
 
+#### reach_deleteAContactFieldV1
+
+Delete a custom contact field.
+
+Every value contacts hold for the field is deleted with it, and for the choice types so
+are its options. The contacts themselves are not affected.
+
+- **Method**: `DELETE`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/contacts/fields/{fieldUuid}`
+
+#### reach_updateAContactFieldV1
+
+Rename a custom contact field and, for the choice types, replace its option set.
+
+Options carrying a uuid are kept and relabelled, options without one are created, and any
+existing option left out of the list is deleted along with the values contacts hold for
+it. The field type and slug cannot be changed.
+
+- **Method**: `PATCH`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/contacts/fields/{fieldUuid}`
+
+#### reach_listContactFieldsV1
+
+Get the custom contact fields defined in a profile.
+
+Custom fields let you store your own attributes on contacts. The returned uuids are what
+you pass to the contact update endpoint to set values, and choice fields also list the
+options available to pick from.
+
+- **Method**: `GET`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/contacts/fields`
+
+#### reach_createAContactFieldV1
+
+Define a new custom contact field in a profile.
+
+The `slug` is derived from the label and, like the field type, cannot be changed later.
+Use the returned uuid to set values on contacts.
+
+- **Method**: `POST`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/contacts/fields`
+
 #### reach_listContactGroupsV1
 
 Get a list of all contact groups.
@@ -2104,6 +2197,11 @@ Get a list of contacts, optionally filtered by group and subscription status.
 This endpoint returns a paginated list of contacts with their basic information.
 You can filter contacts by group UUID and subscription status.
 
+**Deprecated.** This endpoint cannot target a profile, so it always falls back to the
+client's default profile and cannot list contacts of any other profile. Use
+`GET /api/reach/v1/profiles/{profileUuid}/contacts` instead, which also replaces the
+group filter with a tag filter.
+
 - **Method**: `GET`
 - **Path**: `/api/reach/v1/contacts`
 
@@ -2119,6 +2217,73 @@ the contact will be created with a pending status and a confirmation email will
 - **Method**: `POST`
 - **Path**: `/api/reach/v1/contacts`
 
+#### reach_getContactDetailsV1
+
+Get the full details of a single contact.
+
+Alongside the contact's own attributes this returns the tags assigned to it and the
+values it holds for the profile's custom contact fields.
+
+- **Method**: `GET`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}`
+
+#### reach_deleteAProfileContactV1
+
+Permanently delete a contact from a profile.
+
+The contact is removed together with its custom field values and tag assignments.
+
+- **Method**: `DELETE`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}`
+
+#### reach_updateAContactV1
+
+Update a contact's attributes and custom field values.
+
+Only the properties present in the request body are changed, so a partial body is enough
+to change a single attribute. Sending a property as `null` clears it.
+
+The response carries the contact's core attributes. Read back its tags, custom field
+values, source and note with `GET /api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}`.
+
+- **Method**: `PATCH`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/contacts/{contactUuid}`
+
+#### reach_createContactsInBulkV1
+
+Create many contacts in a profile in a single call.
+
+The contacts are imported in the background, so a success response means the import was
+accepted rather than finished. Contacts whose email already exists in the profile are
+left as they are. If double opt-in is enabled, new contacts start off pending and are
+sent a confirmation email.
+
+- **Method**: `POST`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/contacts/bulk`
+
+#### reach_listProfileContactsV1
+
+Get a paginated list of contacts belonging to a profile.
+
+Contacts can be filtered by subscription status, by tag, and by an email search term.
+The `meta.total` field of the response is the number of contacts matching the filters,
+so calling this endpoint without filters gives the profile's total contact count.
+
+- **Method**: `GET`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/contacts`
+
+#### reach_createNewContactsV1
+
+Create a new contact in the email marketing system.
+
+This endpoint allows you to create a new contact with basic information like name, email, and surname.
+
+If double opt-in is enabled, the contact will be created with a pending status
+and a confirmation email will be sent.
+
+- **Method**: `POST`
+- **Path**: `/api/reach/v1/profiles/{profileUuid}/contacts`
+
 #### reach_listSegmentsV1
 
 Get a list of all contact segments.
@@ -2168,18 +2333,6 @@ Segments are used to organize and group contacts based on specific criteria.
 - **Method**: `GET`
 - **Path**: `/api/reach/v1/segmentation/segments/{segmentUuid}`
 
-#### reach_createNewContactsV1
-
-Create a new contact in the email marketing system.
-
-This endpoint allows you to create a new contact with basic information like name, email, and surname.
-
-If double opt-in is enabled, the contact will be created with a pending status
-and a confirmation email will be sent.
-
-- **Method**: `POST`
-- **Path**: `/api/reach/v1/profiles/{profileUuid}/contacts`
-
 #### reach_getProfileDomainDNSStatusV1
 
 Retrieve the DNS configuration status for a profile's domain.

package/gemini-extension.json

@@ -1,6 +1,6 @@
 {
   "name": "hostinger-api-mcp",
-  "version": "1.29.0",
+  "version": "1.31.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.29.0",
+  "version": "1.31.0",
   "mcpName": "io.github.hostinger/hostinger-api-mcp",
   "description": "MCP server for Hostinger API",
   "repository": {

package/server.json

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