Hostinger Server

---

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

VPS (62 tools) — Full VM lifecycle + Docker + Firewall

• 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)

Hosting (48 tools) — Websites, PHP, Node.js, Databases

• 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

WordPress (35 tools) — Plugins, Themes, Cache, Maintenance

• 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

Mail (38 tools) — Mailboxes, Forwarding, Webhooks, Logs

• 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

Domains (23 tools) — Portfolio, DNS, WHOIS, Transfers

• 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

DNS (8 tools) — Records, Validation, Snapshots

• Records: get, update, delete, reset, validate
• Snapshots: list, get, restore

Billing (9 tools) — Catalog, Orders, Subscriptions

• Catalog: browse products & pricing
• Orders: create purchase order
• Payment Methods: list, set default, delete
• Subscriptions: list, enable/disable auto-renewal, renew

Reach / Email Marketing (12 tools)

• Profiles: list, DNS status
• Contacts: list, create (single/bulk), delete, groups
• Segments: list, create, get, contacts

Ecommerce (12 tools)

• Stores: list, create, delete, metadata
• Products: physical, digital
• Sales Channels: list, create, update
• Shipping, Payments, Storefront instructions

Agency Hosting (25 tools)

• Orders, Datacenters
• Websites: provision, status, details, delete, processes, build assets
• Domains: link, unlink, change
• Cache, Cron Jobs, Databases (+ users)
• File import, WordPress settings/versions

Smart Tools (8 tools) — Exclusive to this server

• 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

• Hostinger API Documentation
• MCP Specification
• MCP TypeScript SDK

---