Offered as an installation option for Windows users to set up Node.js prerequisites for the MCP server.
Mentioned as an optional installation method for Node.js dependencies required by the MCP server.
Provides comprehensive access to Hostinger's API, enabling management of billing services, DNS records, domains, and VPS resources. Capabilities include creating service orders, managing payment methods, manipulating DNS zone records, checking domain availability, controlling virtual machines, managing firewalls, handling backups and snapshots, and configuring public keys for server access.
Model Context Protocol (MCP) server for Hostinger API.
If you don't have Node.js installed, you can download it from the official website. Alternatively, you can use a package manager like Homebrew (for macOS) or Chocolatey (for Windows) to install Node.js.
We recommend using NVM (Node Version Manager) to install and manage installed Node.js versions. After installing NVM, you can install Node.js with the following command:
To install the MCP server, run one of the following command, depending on your package manager:
To update the MCP server to the latest version, use one of the following commands, depending on your package manager:
The following environment variables can be configured when running the server:
DEBUG: Enable debug logging (true/false) (default: false)APITOKEN: Your API token, which will be sent in the Authorization header.To use the MCP server with SSE transport, you must run the server with the --sse option.
This will enable the server to communicate with clients using Server-Sent Events on localhost port 8100.
Additionally, you can specify the --host and --port options to set the host and port for the server to listen on.
Example of running the server with SSE transport:
This server implements the Model Context Protocol (MCP) and can be used with any MCP-compatible consumer, like Claude.js client or other MCP consumers.
Example of connecting to this server from a Claude.js client:
This MCP server provides the following tools:
This endpoint retrieves a list of catalog items available for order.
Prices in catalog items is displayed as cents (without floating point), e.g: float 17.99 is displayed as integer 1799.
GET/api/billing/v1/catalogParameters:
category: Filter catalog items by category name: Filter catalog items by name. Use * for wildcard search, e.g. .COM* to find .com domainThis endpoint creates a new service order.
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.
Orders created using this endpoint will be set for automatic renewal.
Some credit_card payments might need additional verification, rendering purchase unprocessed.
We recommend use other payment methods than credit_card if you encounter this issue.
POST/api/billing/v1/ordersParameters:
payment_method_id: Payment method ID (required)items: items parameter (required)coupons: Discount coupon codesThis endpoint sets default payment method for your account.
POST/api/billing/v1/payment-methods/{paymentMethodId}Parameters:
paymentMethodId: Payment method ID (required)This endpoint deletes a payment method from your account.
DELETE/api/billing/v1/payment-methods/{paymentMethodId}Parameters:
paymentMethodId: Payment method ID (required)This endpoint retrieves a list of available payment methods that can be used for placing new orders.
If you want to add new payment method, please use hPanel.
GET/api/billing/v1/payment-methodsThis endpoint cancels a subscription and stops any further billing.
DELETE/api/billing/v1/subscriptions/{subscriptionId}Parameters:
subscriptionId: Subscription ID (required)This endpoint retrieves a list of all subscriptions associated with your account.
GET/api/billing/v1/subscriptionsThis endpoint retrieves particular DNS snapshot with the contents of DNS zone records.
GET/api/dns/v1/snapshots/{domain}/{snapshotId}Parameters:
domain: Domain name (required)snapshotId: Snapshot ID (required)This endpoint retrieves list of DNS snapshots.
GET/api/dns/v1/snapshots/{domain}Parameters:
domain: Domain name (required)This endpoint restores DNS zone to the selected snapshot.
POST/api/dns/v1/snapshots/{domain}/{snapshotId}/restoreParameters:
domain: Domain name (required)snapshotId: Snapshot ID (required)This endpoint retrieves DNS zone records for a specific domain.
GET/api/dns/v1/zones/{domain}Parameters:
domain: Domain name (required)This endpoint updates DNS records for the selected domain.
Using overwrite = true will replace existing records with the provided ones.
Otherwise existing records will be updated and new records will be added.
PUT/api/dns/v1/zones/{domain}Parameters:
domain: Domain name (required)overwrite: If true, resource records (RRs) matching name and type will be deleted and new RRs will be created, otherwise resource records' ttl's are updated and new records are appended. If no matching RRs are found, they are created. zone: zone parameter (required)This endpoint deletes DNS records for the selected domain.
To filter which records to delete, add the name of the record and type to the filter.
Multiple filters can be provided with single request.
If you have multiple records with the same name and type, and you want to delete only part of them,
refer to the Update zone records endpoint.
DELETE/api/dns/v1/zones/{domain}Parameters:
domain: Domain name (required)This endpoint resets DNS zone to the default records.
POST/api/dns/v1/zones/{domain}/resetParameters:
domain: Domain name (required)sync: Determines if operation should be run synchronously reset_email_records: Determines if email records should be reset whitelisted_record_types: Specifies which record types to not resetThis endpoint used to validate DNS records prior update for the selected domain.
If the validation is successful, the response will contain 200 Success code.
If there is validation error, the response will fail with 422 Validation error code.
POST/api/dns/v1/zones/{domain}/validateParameters:
domain: Domain name (required)overwrite: If true, resource records (RRs) matching name and type will be deleted and new RRs will be created, otherwise resource records' ttl's are updated and new records are appended. If no matching RRs are found, they are created. zone: zone parameter (required)This endpoint checks the availability of a domain name. Multiple TLDs can be checked at once.
If you want to get alternative domains with response, provide only one TLD in the request and set with_alternatives to true.
TLDs should be provided without the leading dot (e.g. com, net, org).
Endpoint has rate limit of 10 requests per minute.
POST/api/domains/v1/availabilityParameters:
domain: Domain name (without TLD) (required)tlds: TLDs list (required)with_alternatives: Should response include alternativesThis endpoint retrieves domain forwarding data.
GET/api/domains/v1/forwarding/{domain}Parameters:
domain: Domain name (required)This endpoint deletes domain forwarding data.
DELETE/api/domains/v1/forwarding/{domain}Parameters:
domain: Domain name (required)This endpoint creates domain forwarding data.
POST/api/domains/v1/forwardingParameters:
domain: Domain name (required)redirect_type: Redirect type (required)redirect_url: URL to forward domain to (required)This endpoint enables domain lock for the domain. When domain lock is enabled, the domain cannot be transferred to another registrar without first disabling the lock.
PUT/api/domains/v1/portfolio/{domain}/domain-lockParameters:
domain: Domain name (required)This endpoint disables domain lock for the domain. Domain lock needs to be disabled before transferring the domain to another registrar.
DELETE/api/domains/v1/portfolio/{domain}/domain-lockParameters:
domain: Domain name (required)This endpoint retrieves details for specified domain.
GET/api/domains/v1/portfolio/{domain}Parameters:
domain: Domain name (required)This endpoint retrieves a list of all domains associated with your account.
GET/api/domains/v1/portfolioThis endpoint allows you to buy (purchase) and register a new domain name. If registration fails, login to hPanel and check the domain registration status.
If no payment method is provided, your default payment method will be used automatically.
If no WHOIS information is provided, the default contact information for that TLD (Top-Level Domain) will be used. Before making a request, ensure that WHOIS information for the desired TLD exists in your account.
Some TLDs require additional_details to be provided and these will be validated before completing the purchase. The required additional details vary by TLD.
POST/api/domains/v1/portfolioParameters:
domain: Domain name (required)item_id: Catalog price item ID (required)payment_method_id: Payment method ID domain_contacts: Domain contact information additional_details: Additional registration data, possible values depends on TLD coupons: Discount coupon codesThis endpoint enables privacy protection for the domain. When privacy protection is enabled, the domain owner's personal information is hidden from the public WHOIS database.
PUT/api/domains/v1/portfolio/{domain}/privacy-protectionParameters:
domain: Domain name (required)This endpoint disables privacy protection for the domain. When privacy protection is disabled, the domain owner's personal information is visible in the public WHOIS database.
DELETE/api/domains/v1/portfolio/{domain}/privacy-protectionParameters:
domain: Domain name (required)This endpoint sets the nameservers for a specified domain.
Be aware, that improper nameserver configuration can lead to the domain being unresolvable or unavailable.
PUT/api/domains/v1/portfolio/{domain}/nameserversParameters:
domain: Domain name (required)ns1: First name server (required)ns2: Second name server (required)ns3: Third name server ns4: Fourth name serverThis endpoint retrieves a WHOIS contact profile.
GET/api/domains/v1/whois/{whoisId}Parameters:
whoisId: WHOIS ID (required)This endpoint deletes WHOIS contact profile.
DELETE/api/domains/v1/whois/{whoisId}Parameters:
whoisId: WHOIS ID (required)This endpoint retrieves a list of WHOIS contact profiles.
GET/api/domains/v1/whoisParameters:
tld: Filter by TLD (without leading dot)This endpoint creates WHOIS contact profile.
POST/api/domains/v1/whoisParameters:
tld: TLD of the domain (without leading dot) (required)country: ISO 3166 2-letter country code (required)entity_type: Legal entity type (required)tld_details: TLD details whois_details: WHOIS details (required)This endpoint retrieves a domain list where provided WHOIS contact profile is used.
GET/api/domains/v1/whois/{whoisId}/usageParameters:
whoisId: WHOIS ID (required)This endpoint retrieves a list of all data centers available.
GET/api/vps/v1/data-centersThis endpoint activates a firewall for a specified virtual machine.
Only one firewall can be active for a virtual machine at a time.
POST/api/vps/v1/firewall/{firewallId}/activate/{virtualMachineId}Parameters:
firewallId: Firewall ID (required)virtualMachineId: Virtual Machine ID (required)This endpoint deactivates a firewall for a specified virtual machine.
POST/api/vps/v1/firewall/{firewallId}/deactivate/{virtualMachineId}Parameters:
firewallId: Firewall ID (required)virtualMachineId: Virtual Machine ID (required)This endpoint retrieves firewall by its ID and rules associated with it.
GET/api/vps/v1/firewall/{firewallId}Parameters:
firewallId: Firewall ID (required)This endpoint deletes a specified firewall.
Any virtual machine that has this firewall activated will automatically have it deactivated.
DELETE/api/vps/v1/firewall/{firewallId}Parameters:
firewallId: Firewall ID (required)This endpoint retrieves a list of all firewalls available.
GET/api/vps/v1/firewallParameters:
page: Page numberThis endpoint creates a new firewall.
POST/api/vps/v1/firewallParameters:
name: name parameter (required)This endpoint updates a specific firewall rule from a specified firewall.
Any virtual machine that has this firewall activated will loose sync with the firewall and will have to be synced again manually.
PUT/api/vps/v1/firewall/{firewallId}/rules/{ruleId}Parameters:
firewallId: Firewall ID (required)ruleId: Firewall Rule ID (required)protocol: protocol parameter (required)port: Port or port range, ex: 1024:2048 (required)source: source parameter (required)source_detail: IP range, CIDR, single IP or any (required)This endpoint deletes a specific firewall rule from a specified firewall.
Any virtual machine that has this firewall activated will loose sync with the firewall and will have to be synced again manually.
DELETE/api/vps/v1/firewall/{firewallId}/rules/{ruleId}Parameters:
firewallId: Firewall ID (required)ruleId: Firewall Rule ID (required)This endpoint creates new firewall rule from a specified firewall. By default, the firewall drops all incoming traffic, which means you must add accept rules for all ports you want to use.
Any virtual machine that has this firewall activated will loose sync with the firewall and will have to be synced again manually.
POST/api/vps/v1/firewall/{firewallId}/rulesParameters:
firewallId: Firewall ID (required)protocol: protocol parameter (required)port: Port or port range, ex: 1024:2048 (required)source: source parameter (required)source_detail: IP range, CIDR, single IP or any (required)This endpoint syncs a firewall for a specified virtual machine.
Firewall can loose sync with virtual machine if the firewall has new rules added, removed or updated.
POST/api/vps/v1/firewall/{firewallId}/sync/{virtualMachineId}Parameters:
firewallId: Firewall ID (required)virtualMachineId: Virtual Machine ID (required)This endpoint retrieves post-install script by its ID.
GET/api/vps/v1/post-install-scripts/{postInstallScriptId}Parameters:
postInstallScriptId: Post-install script ID (required)This endpoint updates a specific post-install script.
PUT/api/vps/v1/post-install-scripts/{postInstallScriptId}Parameters:
postInstallScriptId: Post-install script ID (required)name: Name of the script (required)content: Content of the script (required)This endpoint deletes a post-install script from your account.
DELETE/api/vps/v1/post-install-scripts/{postInstallScriptId}Parameters:
postInstallScriptId: Post-install script ID (required)This endpoint retrieves a list of post-install scripts associated with your account.
GET/api/vps/v1/post-install-scriptsParameters:
page: Page numberThis endpoint allows you to add a new post-install script to your account, which can then be used run after the installation of a virtual machine instance.
The script contents will be saved to the file /post_install with executable attribute set and will be executed once virtual machine is installed.
The output of the script will be redirected to /post_install.log. Maximum script size is 48KB.
POST/api/vps/v1/post-install-scriptsParameters:
name: Name of the script (required)content: Content of the script (required)This endpoint attaches an existing public keys from your account to a specified virtual machine.
Multiple keys can be attached to a single virtual machine.
POST/api/vps/v1/public-keys/attach/{virtualMachineId}Parameters:
virtualMachineId: Virtual Machine ID (required)ids: Public Key IDs to attach (required)This endpoint deletes a public key from your account.
Deleting public key from account does not remove it from virtual machine
DELETE/api/vps/v1/public-keys/{publicKeyId}Parameters:
publicKeyId: Public Key ID (required)This endpoint retrieves a list of public keys associated with your account.
GET/api/vps/v1/public-keysParameters:
page: Page numberThis endpoint allows you to add a new public key to your account, which can then be attached to virtual machine instances for secure access.
POST/api/vps/v1/public-keysParameters:
name: name parameter (required)key: key parameter (required)This endpoint retrieves details of a specific OS template for virtual machines.
GET/api/vps/v1/templates/{templateId}Parameters:
templateId: Template ID (required)This endpoint retrieves a list of available OS templates for virtual machines.
GET/api/vps/v1/templatesThis endpoint retrieves details of a specific action performed on a specified virtual machine.
This endpoint allows you to view detailed information about a particular action, including the action name, timestamp, and status.
GET/api/vps/v1/virtual-machines/{virtualMachineId}/actions/{actionId}Parameters:
virtualMachineId: Virtual Machine ID (required)actionId: Action ID (required)This endpoint retrieves a list of actions performed on a specified virtual machine.
Actions are operations or events that have been executed on the virtual machine, such as starting, stopping, or modifying the machine. This endpoint allows you to view the history of these actions, providing details about each action, such as the action name, timestamp, and status.
GET/api/vps/v1/virtual-machines/{virtualMachineId}/actionsParameters:
virtualMachineId: Virtual Machine ID (required)page: Page numberThis endpoint retrieves a list of public keys attached to a specified virtual machine.
GET/api/vps/v1/virtual-machines/{virtualMachineId}/public-keysParameters:
virtualMachineId: Virtual Machine ID (required)page: Page numberThis endpoint deletes a specified backup for a virtual machine.
DELETE/api/vps/v1/virtual-machines/{virtualMachineId}/backups/{backupId}Parameters:
virtualMachineId: Virtual Machine ID (required)backupId: Backup ID (required)This endpoint retrieves a list of backups for a specified virtual machine.
GET/api/vps/v1/virtual-machines/{virtualMachineId}/backupsParameters:
virtualMachineId: Virtual Machine ID (required)page: Page numberThis endpoint restores a backup for a specified virtual machine.
The system will then initiate the restore process, which may take some time depending on the size of the backup.
All data on the virtual machine will be overwritten with the data from the backup.
POST/api/vps/v1/virtual-machines/{virtualMachineId}/backups/{backupId}/restoreParameters:
virtualMachineId: Virtual Machine ID (required)backupId: Backup ID (required)This endpoint sets the hostname for a specified virtual machine. Changing hostname does not update PTR record automatically. If you want your virtual machine to be reachable by a hostname, you need to point your domain A/AAAA records to virtual machine IP as well.
PUT/api/vps/v1/virtual-machines/{virtualMachineId}/hostnameParameters:
virtualMachineId: Virtual Machine ID (required)hostname: hostname parameter (required)This endpoint resets the hostname and PTR record of a specified virtual machine to the default value.
DELETE/api/vps/v1/virtual-machines/{virtualMachineId}/hostnameParameters:
virtualMachineId: Virtual Machine ID (required)This endpoint retrieves detailed information about a specified virtual machine.
GET/api/vps/v1/virtual-machines/{virtualMachineId}Parameters:
virtualMachineId: Virtual Machine ID (required)This endpoint retrieves a list of all available virtual machines.
GET/api/vps/v1/virtual-machinesThis endpoint retrieves the scan metrics for the Monarx 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, detected threats, and other relevant statistics. This information is useful for monitoring the security status of the virtual machine and assessing the effectiveness of the malware scanner.
GET/api/vps/v1/virtual-machines/{virtualMachineId}/monarxParameters:
virtualMachineId: Virtual Machine ID (required)This endpoint installs the Monarx malware scanner on a specified virtual machine.
Monarx is a security tool designed to detect and prevent malware infections on virtual machines. By installing Monarx, users can enhance the security of their virtual machines, ensuring that they are protected against malicious software.
POST/api/vps/v1/virtual-machines/{virtualMachineId}/monarxParameters:
virtualMachineId: Virtual Machine ID (required)This endpoint uninstalls the Monarx malware scanner on a specified virtual machine. If Monarx is not installed, the request will still be processed without any effect.
DELETE/api/vps/v1/virtual-machines/{virtualMachineId}/monarxParameters:
virtualMachineId: Virtual Machine ID (required)This endpoint retrieves the historical metrics for a specified virtual machine. It includes the following metrics:
GET/api/vps/v1/virtual-machines/{virtualMachineId}/metricsParameters:
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)This endpoint sets the nameservers for a specified virtual machine. Be aware, that improper nameserver configuration can lead to the virtual machine being unable to resolve domain names.
PUT/api/vps/v1/virtual-machines/{virtualMachineId}/nameserversParameters:
virtualMachineId: Virtual Machine ID (required)ns1: ns1 parameter (required)ns2: ns2 parameterThis endpoint creates or updates a PTR (Pointer) record for a specified virtual machine.
POST/api/vps/v1/virtual-machines/{virtualMachineId}/ptrParameters:
virtualMachineId: Virtual Machine ID (required)This endpoint deletes a PTR (Pointer) record for a specified virtual machine.
Once deleted, reverse DNS lookups to the virtual machine's IP address will no longer return the previously configured hostname.
DELETE/api/vps/v1/virtual-machines/{virtualMachineId}/ptrParameters:
virtualMachineId: Virtual Machine ID (required)This endpoint sets the panel password for a specified virtual machine. If virtual machine does not use panel OS, the request will still be processed without any effect. Requirements for the password is the same as in the recreate virtual machine endpoint.
PUT/api/vps/v1/virtual-machines/{virtualMachineId}/panel-passwordParameters:
virtualMachineId: Virtual Machine ID (required)password: Panel password for the virtual machine (required)This endpoint initiates the recovery mode for a specified virtual machine. Recovery mode is a special state that allows users to perform system rescue operations, such as repairing file systems, recovering data, or troubleshooting issues that prevent the virtual machine from booting normally.
Virtual machine will boot recovery disk image and original disk image will be mounted in /mnt directory.
POST/api/vps/v1/virtual-machines/{virtualMachineId}/recoveryParameters:
virtualMachineId: Virtual Machine ID (required)root_password: Temporary root password for recovery mode (required)This endpoint stops the recovery mode for a specified virtual machine. If virtual machine is not in recovery mode, this operation will fail.
DELETE/api/vps/v1/virtual-machines/{virtualMachineId}/recoveryParameters:
virtualMachineId: Virtual Machine ID (required)This endpoint will recreate a virtual machine from scratch. The recreation process involves reinstalling the operating system and resetting the virtual machine to its initial state. Snapshots, if there are any, will be deleted.
Password will be checked against leaked password databases. Requirements for the password are:
This operation is irreversible and will result in the loss of all data stored on the virtual machine!
POST/api/vps/v1/virtual-machines/{virtualMachineId}/recreateParameters:
virtualMachineId: Virtual Machine ID (required)template_id: Template ID (required)password: Password for the virtual machine. If not provided, random password will be generated. Password will not be shown in the response. post_install_script_id: Post-install script IDThis endpoint restarts a specified virtual machine. This is equivalent to fully stopping and starting the virtual machine. If the virtual machine was stopped, it will be started.
POST/api/vps/v1/virtual-machines/{virtualMachineId}/restartParameters:
virtualMachineId: Virtual Machine ID (required)This endpoint sets the root password for a specified virtual machine. Requirements for the password is the same as in the recreate virtual machine endpoint.
PUT/api/vps/v1/virtual-machines/{virtualMachineId}/root-passwordParameters:
virtualMachineId: Virtual Machine ID (required)password: Root password for the virtual machine (required)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 endpoint.
POST/api/vps/v1/virtual-machines/{virtualMachineId}/setupParameters:
virtualMachineId: Virtual Machine ID (required)template_id: Template ID (required)data_center_id: Data center ID (required)post_install_script_id: Post-install script ID password: Password for the virtual machine. If not provided, random password will be generated. Password will not be shown in the response. 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 parameterThis endpoint retrieves a snapshot for a specified virtual machine.
GET/api/vps/v1/virtual-machines/{virtualMachineId}/snapshotParameters:
virtualMachineId: Virtual Machine ID (required)This endpoint creates a snapshot of a specified virtual machine. A snapshot captures the state and data of the virtual machine at a specific point in time, allowing users to restore the virtual machine to that state if needed. This operation is useful for backup purposes, system recovery, and testing changes without affecting the current state of the virtual machine.
Creating new snapshot will overwrite the existing snapshot!
POST/api/vps/v1/virtual-machines/{virtualMachineId}/snapshotParameters:
virtualMachineId: Virtual Machine ID (required)This endpoint deletes a snapshot of a specified virtual machine.
DELETE/api/vps/v1/virtual-machines/{virtualMachineId}/snapshotParameters:
virtualMachineId: Virtual Machine ID (required)This endpoint restores a specified virtual machine to a previous state using a snapshot. Restoring from a snapshot allows users to revert the virtual machine to that state, which is useful for system recovery, undoing changes, or testing.
POST/api/vps/v1/virtual-machines/{virtualMachineId}/snapshot/restoreParameters:
virtualMachineId: Virtual Machine ID (required)This endpoint starts a specified virtual machine. If the virtual machine is already running, the request will still be processed without any effect.
POST/api/vps/v1/virtual-machines/{virtualMachineId}/startParameters:
virtualMachineId: Virtual Machine ID (required)This endpoint stops a specified virtual machine. If the virtual machine is already stopped, the request will still be processed without any effect.
POST/api/vps/v1/virtual-machines/{virtualMachineId}/stopParameters:
virtualMachineId: Virtual Machine ID (required)You must be authenticated.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
The Hostinger MCP server enables seamless integration of Hostinger’s API with AI tools. This server exposes Hostinger API endpoints as callable tools, allowing AI models to fetch live data or perform real-time actions on hosting infrastructure.