{"_id":"@eliyantosarage/hostinger-mcp","name":"@eliyantosarage/hostinger-mcp","dist-tags":{"latest":"2.0.0"},"versions":{"2.0.0":{"name":"@eliyantosarage/hostinger-mcp","version":"2.0.0","description":"The most complete MCP server for Hostinger — 280+ tools, OAuth, HTTP transport, retry/cache, batch operations, deploy automation","type":"module","main":"dist/index.js","bin":{"hostinger-mcp":"dist/index.js","hostinger-api-mcp":"dist/bin/hostinger-api-mcp.js","hostinger-billing-mcp":"dist/bin/hostinger-billing-mcp.js","hostinger-dns-mcp":"dist/bin/hostinger-dns-mcp.js","hostinger-domains-mcp":"dist/bin/hostinger-domains-mcp.js","hostinger-vps-mcp":"dist/bin/hostinger-vps-mcp.js","hostinger-hosting-mcp":"dist/bin/hostinger-hosting-mcp.js","hostinger-wordpress-mcp":"dist/bin/hostinger-wordpress-mcp.js","hostinger-mail-mcp":"dist/bin/hostinger-mail-mcp.js","hostinger-reach-mcp":"dist/bin/hostinger-reach-mcp.js","hostinger-ecommerce-mcp":"dist/bin/hostinger-ecommerce-mcp.js","hostinger-agency-mcp":"dist/bin/hostinger-agency-mcp.js","hostinger-horizons-mcp":"dist/bin/hostinger-horizons-mcp.js"},"scripts":{"build":"tsc","start":"node dist/index.js","clean":"rimraf dist","prepublishOnly":"npm run build"},"repository":{"type":"git","url":"git+https://github.com/rifqi96/hostinger-mcp.git"},"homepage":"https://github.com/rifqi96/hostinger-mcp#readme","bugs":{"url":"https://github.com/rifqi96/hostinger-mcp/issues"},"author":{"name":"Rifqi"},"license":"MIT","keywords":["mcp","hostinger","hpanel","vps","hosting","domains","dns","ai-agent","model-context-protocol","oauth","deploy","wordpress","email","ecommerce","claude","cursor","kiro"],"engines":{"node":">=18.0.0"},"dependencies":{"@modelcontextprotocol/sdk":"^1.30.0","zod":"^3.25.0"},"devDependencies":{"@types/node":"^22.15.0","typescript":"^5.8.0"},"gitHead":"855f314807c00ee417b39f6479f042467efc3b26","types":"./dist/index.d.ts","_id":"@eliyantosarage/hostinger-mcp@2.0.0","_nodeVersion":"26.2.0","_npmVersion":"12.0.1","dist":{"integrity":"sha512-+BRbnqVZ7e81GCW9BzqVSJKM5wRQbf1tVS6bYQCEUf1ExkY+K4IeDRe5YjKs6tWFj6ZQeTnpTXqUAJgOMjhCYA==","shasum":"bf02d8ec2e1df5c0b7d0fdd72bd08550ee3cf9af","tarball":"https://registry.npmjs.org/@eliyantosarage/hostinger-mcp/-/hostinger-mcp-2.0.0.tgz","fileCount":94,"unpackedSize":309751,"signatures":[{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEYCIQC9hxpOO9nsHZz27/3SdxZwYfhTgfP5EuD1gfqGqZwHAwIhAKGyZieATU2kURyMWE02ugI9GSW604z00Gwu/0oXiIki"}]},"_npmUser":{"name":"eliyantosarage","email":"officialelsa21@gmail.com"},"directories":{},"maintainers":[{"name":"eliyantosarage","email":"officialelsa21@gmail.com"}],"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/hostinger-mcp_2.0.0_1785404689369_0.534526911123846"},"_hasShrinkwrap":false}},"time":{"created":"2026-07-30T09:44:49.263Z","2.0.0":"2026-07-30T09:44:49.515Z","modified":"2026-07-30T09:44:49.721Z"},"maintainers":[{"name":"eliyantosarage","email":"officialelsa21@gmail.com"}],"description":"The most complete MCP server for Hostinger — 280+ tools, OAuth, HTTP transport, retry/cache, batch operations, deploy automation","homepage":"https://github.com/rifqi96/hostinger-mcp#readme","keywords":["mcp","hostinger","hpanel","vps","hosting","domains","dns","ai-agent","model-context-protocol","oauth","deploy","wordpress","email","ecommerce","claude","cursor","kiro"],"repository":{"type":"git","url":"git+https://github.com/rifqi96/hostinger-mcp.git"},"author":{"name":"Rifqi"},"bugs":{"url":"https://github.com/rifqi96/hostinger-mcp/issues"},"license":"MIT","readme":"# hostinger-mcp\n\n> The most complete MCP server for Hostinger — surpasses the official with 280+ tools, OAuth, HTTP transport, smart caching, batch operations, and deploy automation.\n\n[![CI](https://github.com/rifqi96/hostinger-mcp/actions/workflows/ci.yml/badge.svg)](https://github.com/rifqi96/hostinger-mcp/actions/workflows/ci.yml)\n[![Node.js](https://img.shields.io/badge/node-%3E%3D18-brightgreen)](https://nodejs.org)\n[![License: MIT](https://img.shields.io/badge/License-MIT-blue.svg)](LICENSE)\n\n## Why This Over Official?\n\n| Feature | Official | **This** |\n|---------|----------|----------|\n| Tools | 276 | **280+** |\n| Node.js | 24+ required | **18+** |\n| Retry + backoff | No | **Yes** (exponential, 3 retries) |\n| Rate-limit (429) | No | **Yes** (respects `retry-after`) |\n| Response caching | No | **Yes** (GET, 15s TTL) |\n| Request timeout | No | **Yes** (30s, configurable) |\n| Batch operations | No | **Yes** (multi-domain DNS, multi-VPS) |\n| Smart pagination | No | **Yes** (auto-fetch all pages) |\n| Health check | No | **Yes** |\n| Account overview | No | **Yes** (full service summary) |\n| `destructiveHint` | No | **Yes** (on all destructive ops) |\n| OAuth 2.0 + PKCE | Yes | **Yes** |\n| HTTP transport | Yes | **Yes** |\n| Per-domain binaries | Yes | **Yes** (12 binaries) |\n| Deploy tools | Yes | **Yes** |\n\n## Quick Start\n\n```bash\n# Install globally\nnpm install -g hostinger-mcp\n\n# Or run directly with npx\nnpx hostinger-mcp\n```\n\n### With API Token (recommended)\n\n```bash\nexport HOSTINGER_API_TOKEN=\"your-token-from-hpanel\"\nhostinger-mcp\n```\n\nGet your token at: https://hpanel.hostinger.com/api\n\n### With OAuth (interactive)\n\n```bash\nhostinger-mcp --login\n```\n\n## MCP Client Configuration\n\n### Claude Desktop / Kiro / Cursor\n\n```json\n{\n  \"mcpServers\": {\n    \"hostinger\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"hostinger-mcp\"],\n      \"env\": {\n        \"HOSTINGER_API_TOKEN\": \"your-api-token\"\n      }\n    }\n  }\n}\n```\n\n### HTTP Mode (for remote/shared access)\n\n```bash\nHOSTINGER_API_TOKEN=your-token hostinger-mcp --http --host 0.0.0.0 --port 8100\n```\n\n## Per-Domain Binaries\n\nPick only the tools you need:\n\n| Binary | Tools | Domain |\n|--------|-------|--------|\n| `hostinger-mcp` | 280+ | All (default) |\n| `hostinger-billing-mcp` | 9 | Billing |\n| `hostinger-dns-mcp` | 8 | DNS |\n| `hostinger-domains-mcp` | 23 | Domains |\n| `hostinger-vps-mcp` | 62 | VPS |\n| `hostinger-hosting-mcp` | 48+ | Hosting + Deploy |\n| `hostinger-wordpress-mcp` | 35 | WordPress |\n| `hostinger-mail-mcp` | 38 | Mail |\n| `hostinger-reach-mcp` | 12 | Email Marketing |\n| `hostinger-ecommerce-mcp` | 12 | Ecommerce |\n| `hostinger-agency-mcp` | 25 | Agency Hosting |\n| `hostinger-horizons-mcp` | 2 | AI Website Builder |\n\n## Tool Categories\n\n### Billing (9 tools)\nCatalog browsing, order creation, payment methods, subscriptions, auto-renewal, subscription renewal.\n\n### DNS (8 tools)\nZone record CRUD, validation, reset, snapshots, restore.\n\n### Domains (23 tools)\nPortfolio management, availability check, purchase, nameservers, registrar lock, privacy protection, forwarding, WHOIS profiles, transfers, verifications.\n\n### VPS (62 tools)\nVM lifecycle (start/stop/restart/recreate), Docker Compose projects (CRUD + logs + containers), firewall (rules + activate/sync), SSH keys, backups, snapshots, OS templates, data centers, post-install scripts, recovery mode, Monarx malware scanner, PTR records, metrics, actions.\n\n### Hosting (48+ tools)\nWebsites, cache (clear/toggle/cacheless), cron jobs (CRUD + output), databases (CRUD + repair + remote + phpMyAdmin), subdomains, parked domains, domain verification, PHP (version/options/extensions/reset/phpinfo), Node.js (builds/logs/restart/vulnerabilities/patch), deploy tools (JS app/static/WP import/plugin/theme).\n\n### WordPress (35 tools)\nInstallations (list/install/detect/validate/delete), core (version/updates/update), plugins (list/search/suggested/available/install/activate/deactivate/update/uninstall), themes (list/install/activate/update/uninstall), LiteSpeed Cache, Memcached, maintenance mode, login links, JWT tokens, AI tools.\n\n### Mail (38 tools)\nOrders, mailboxes (CRUD + password), aliases, forwarders (+ resend confirmation), autoreplies, catch-alls (+ resend confirmation), webhooks (CRUD + test + regenerate secret + delivery logs), logs (access/action/inbound/outbound/mailbox-actions), API tokens.\n\n### Email Marketing / Reach (12 tools)\nProfiles, DNS status, contacts (single/bulk/delete), groups, segments (CRUD + contacts).\n\n### Ecommerce (12 tools)\nStores (CRUD + metadata), products (physical/digital), sales channels (CRUD), shipping, manual payments, storefront instructions.\n\n### Agency Hosting (25 tools)\nOrders, datacenters, website provisioning (+ setup status), website management (details/delete/processes/build-assets), domains (link/unlink/change), cache, cron jobs, databases (+ users), file import, WordPress settings.\n\n### Horizons (2 tools)\nCreate AI-built website, get website details/edit link.\n\n### Smart Tools (7 tools)\n`health_check`, `account_overview`, `batch_dns_update`, `batch_vps_restart`, `list_all_domains_paginated`, `list_all_websites_paginated`, `list_all_subscriptions_paginated`, `clear_api_cache`.\n\n## CLI Options\n\n```\nOptions:\n  --stdio          Use stdio transport (default)\n  --http           Use HTTP streaming transport\n  --host <host>    HTTP host (default: 127.0.0.1)\n  --port <port>    HTTP port (default: 8100)\n  --login          Run OAuth sign-in flow and exit\n  --logout         Revoke stored OAuth credentials and exit\n  --domain <name>  Filter tools to specific domain\n  --help, -h       Show help\n```\n\n## Architecture\n\n```\nsrc/\n├── index.ts              # Entry point — CLI, transport, tool registration\n├── api-client.ts         # HTTP client (retry, cache, rate-limit, pagination)\n├── helpers.ts            # Response formatting\n├── cli.ts                # CLI argument parser\n├── auth/\n│   └── oauth.ts          # OAuth 2.0 PKCE flow\n├── tools/\n│   ├── billing.ts        # 9 tools\n│   ├── dns.ts            # 8 tools\n│   ├── domains.ts        # 23 tools\n│   ├── vps.ts            # 62 tools\n│   ├── hosting.ts        # 41 tools\n│   ├── wordpress.ts      # 35 tools\n│   ├── mail.ts           # 38 tools\n│   ├── reach.ts          # 12 tools\n│   ├── ecommerce.ts      # 12 tools\n│   ├── agency.ts         # 25 tools\n│   ├── horizons.ts       # 2 tools\n│   ├── deploy.ts         # 8 tools\n│   └── smart.ts          # 7 tools\n└── bin/                   # Per-domain entry points\n    ├── hostinger-api-mcp.ts\n    ├── hostinger-billing-mcp.ts\n    ├── hostinger-dns-mcp.ts\n    └── ... (12 total)\n```\n\n## Development\n\n```bash\ngit clone https://github.com/rifqi96/hostinger-mcp.git\ncd hostinger-mcp\nnpm install\nnpm run build\n```\n\n## Security\n\n- Never hardcode API tokens — use environment variables\n- OAuth credentials stored at `~/.config/hostinger-mcp/credentials.json` (mode 0600)\n- Token has full account access — rotate immediately if exposed\n- Tools with `destructiveHint: true` signal AI clients to confirm before executing\n\n## References\n\n- [Hostinger API Documentation](https://developers.hostinger.com)\n- [Hostinger Official MCP](https://github.com/hostinger/api-mcp-server)\n- [MCP Specification](https://modelcontextprotocol.io)\n- [MCP TypeScript SDK](https://github.com/modelcontextprotocol/typescript-sdk)\n\n## License\n\n[MIT](LICENSE)\n","readmeFilename":"README.md","_rev":"1-877a45ffc3b3cbc8e02793ec92651ebc"}