Skip to main content
Glama
idugeni

hostinger-mcp-server

by idugeni

hostinger-mcp-server

The most powerful MCP server for Hostinger — built for AI agents that manage infrastructure.

npm version CI Node License Downloads

Getting Started · Why This? · Tools · Config · Architecture


Overview

hostinger-mcp-server connects any MCP-compatible AI agent (Claude, Kiro, Cursor, Windsurf, etc.) to the full Hostinger platform. Manage VPS, domains, DNS, hosting, WordPress, email, ecommerce, and more — all through natural language.

"Restart my VPS and purge the LiteSpeed cache on my WordPress site"
"Add A record for api.example.com pointing to 203.0.113.1"
"Deploy my Node.js app from the uploaded archive"

The agent calls the right tools. You stay in control.


Why This Over Official?

Official hostinger-api-mcp

This hostinger-mcp-server

Tools

276

280+

Min Node.js

24

18

Retry + backoff

Exponential, 3x

Rate-limit handling

429 + retry-after

Response caching

GET, 15s TTL

Request timeout

30s configurable

Batch operations

Multi-domain, multi-VPS

Auto-pagination

Fetches all pages

Health check

Built-in

Account overview

One-call summary

Destructive hints

On all risky ops

HTTP dependencies

7 (axios, express…)

0 (native fetch)

OAuth 2.0 + PKCE

Yes

Yes

HTTP transport

Yes

Yes

Per-domain binaries

Yes

Yes (12)


Getting Started

Install

# Global install
npm install -g hostinger-mcp-server

# Or run directly (no install)
npx hostinger-mcp-server

Authenticate

Option A — API Token (recommended for CI/scripts):

export HOSTINGER_API_TOKEN="your-token-from-hpanel"

Get your token at hpanel.hostinger.com/api

Option B — OAuth (interactive):

hostinger-mcp --login

MCP Client Configuration

Claude Desktop / Kiro / Cursor / Windsurf

{
  "mcpServers": {
    "hostinger": {
      "command": "npx",
      "args": ["-y", "hostinger-mcp-server"],
      "env": {
        "HOSTINGER_API_TOKEN": "your-api-token"
      }
    }
  }
}

HTTP Mode (remote / shared)

HOSTINGER_API_TOKEN=your-token hostinger-mcp --http --host 0.0.0.0 --port 8100

Then connect any MCP client to http://your-server:8100.


Per-Domain Binaries

Only expose what your agent needs:

hostinger-mcp              # All 280+ tools
hostinger-vps-mcp          # 62 VPS tools
hostinger-hosting-mcp      # 48 Hosting + Deploy tools
hostinger-wordpress-mcp    # 35 WordPress tools
hostinger-mail-mcp         # 38 Mail tools
hostinger-dns-mcp          # 8 DNS tools
hostinger-domains-mcp      # 23 Domain tools
hostinger-billing-mcp      # 9 Billing tools
hostinger-reach-mcp        # 12 Email Marketing tools
hostinger-ecommerce-mcp    # 12 Ecommerce tools
hostinger-agency-mcp       # 25 Agency Hosting tools
hostinger-horizons-mcp     # 2 AI Website Builder tools

Tool Categories

  • VM: list, get, purchase, setup, start, stop, restart, recreate

  • Config: hostname, root password, panel password, nameservers

  • Monitoring: metrics (CPU/RAM/disk/network), actions

  • Docker: create, get, update, start, stop, restart, delete, logs, containers

  • Firewall: CRUD rules, activate, deactivate, sync

  • SSH Keys: list, create, delete, attach

  • Backups & Snapshots: list, restore, create, delete

  • Templates & Data Centers: browse OS templates, list locations

  • Scripts: CRUD post-install scripts

  • Recovery: start/stop recovery mode

  • Security: Monarx malware scanner (install/uninstall/metrics)

  • Network: PTR records (create/delete)

  • Websites: list, create, delete

  • Cache: clear, toggle, cacheless mode

  • Cron Jobs: list, create, delete, get output

  • Databases: CRUD, change password, repair, phpMyAdmin link, remote connections

  • Domains: subdomains, parked domains, free subdomain, verify ownership

  • PHP: version, options, extensions, reset, phpinfo

  • Node.js: builds, logs, restart, vulnerabilities, auto-patch

  • Deploy: JS app, static site, WP import, WP plugin, WP theme

  • Installations: list, install, detect, validate, delete

  • Core: version, updates, update

  • Plugins: list, search, suggested, available, install, activate, deactivate, update, uninstall

  • Themes: list, browse, install, activate, update, uninstall

  • Performance: LiteSpeed Cache (status/purge), Memcached (status/toggle)

  • Operations: maintenance mode, login links, JWT tokens, AI tools

  • Orders & Plans

  • Mailboxes: list, create, delete, change password

  • Aliases: list, create, delete

  • Forwarders: list, create, delete, keep-copy, resend confirmation

  • Autoreplies: list, create, update, delete

  • Catch-alls: list, create, delete, resend confirmation

  • Webhooks: CRUD, test, regenerate secret, delivery logs

  • Logs: access, action, inbound, outbound, mailbox-actions

  • API Tokens: list, create, revoke

  • Availability check, purchase

  • Portfolio: list, details, nameservers

  • Security: domain lock, privacy protection, auth code

  • Forwarding: create, get, update, delete

  • WHOIS: profiles CRUD, usage

  • Transfers: list, details

  • Verifications

  • Records: get, update, delete, reset, validate

  • Snapshots: list, get, restore

  • Catalog: browse products & pricing

  • Orders: create purchase order

  • Payment Methods: list, set default, delete

  • Subscriptions: list, enable/disable auto-renewal, renew

  • Profiles: list, DNS status

  • Contacts: list, create (single/bulk), delete, groups

  • Segments: list, create, get, contacts

  • Stores: list, create, delete, metadata

  • Products: physical, digital

  • Sales Channels: list, create, update

  • Shipping, Payments, Storefront instructions

  • Orders, Datacenters

  • Websites: provision, status, details, delete, processes, build assets

  • Domains: link, unlink, change

  • Cache, Cron Jobs, Databases (+ users)

  • File import, WordPress settings/versions

  • health_check — Verify API connectivity + auth

  • account_overview — Full service summary in one call

  • batch_dns_update — Apply records to multiple domains

  • batch_vps_restart — Restart multiple VMs at once

  • list_all_domains_paginated — Auto-fetch all pages

  • list_all_websites_paginated — Auto-fetch all pages

  • list_all_subscriptions_paginated — Auto-fetch all pages

  • clear_api_cache — Force fresh data


CLI

Usage: hostinger-mcp [options]

Options:
  --stdio          Stdio transport (default)
  --http           HTTP streaming transport
  --host <host>    Bind host (default: 127.0.0.1)
  --port <port>    Bind port (default: 8100)
  --login          OAuth sign-in and exit
  --logout         Clear stored credentials and exit
  --domain <name>  Load only one domain's tools
  --help           Show help

Architecture

src/
├── index.ts              Entry point — CLI, auth, registration, transport
├── api-client.ts         HTTP engine: retry, cache, rate-limit, pagination
├── cli.ts                Argument parser
├── helpers.ts            Response formatter
├── auth/
│   └── oauth.ts          OAuth 2.0 PKCE + credential storage
├── tools/
│   ├── billing.ts        9 tools
│   ├── dns.ts            8 tools
│   ├── domains.ts        23 tools
│   ├── vps.ts            62 tools
│   ├── hosting.ts        41 tools
│   ├── wordpress.ts      35 tools
│   ├── mail.ts           38 tools
│   ├── reach.ts          12 tools
│   ├── ecommerce.ts      12 tools
│   ├── agency.ts         25 tools
│   ├── horizons.ts       2 tools
│   ├── deploy.ts         8 tools
│   └── smart.ts          8 tools
└── bin/                   Per-domain entry points (12 files)

Tech Stack:

  • Runtime: Node.js 18+ (ESM)

  • Language: TypeScript (strict)

  • MCP SDK: @modelcontextprotocol/sdk ^1.30 (registerTool API)

  • Validation: Zod ^3.25

  • HTTP: Native fetch — zero external deps

  • Target: ESNext + NodeNext


Security

Practice

Implementation

Token storage

Environment variable only

OAuth credentials

~/.config/hostinger-mcp/credentials.json (mode 0600)

Destructive operations

Annotated with destructiveHint: true

Token in code

Never — always via ENV

If a token is compromised, revoke immediately at hpanel.hostinger.com/api.


Contributing

git clone https://github.com/idugeni/hostinger-mcp.git
cd hostinger-mcp
npm install
npm run build

PRs welcome. Please ensure npm run build passes with zero errors before submitting.


References


Built with precision for AI-powered infrastructure management.

Report Bug · Request Feature