npm package: @hostealocom/mcp
Description: Hostealo MCP server — manage hosting services from AI assistants
Latest version: 1.2.0

# @hostealocom/mcp

MCP (Model Context Protocol) server for [Hostealo](https://hostealo.com) — manage your hosting services directly from AI assistants like Claude, Cursor, and others.

## Quick Start

```bash
HOSTEALO_API_KEY=hst_live_your_key npx -y @hostealocom/mcp
```

Get your API key from [Account → API Keys](https://my.hostealo.com/account/api-keys) in the Hostealo panel.

## Setup

### Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "hostealo": {
      "command": "npx",
      "args": ["-y", "@hostealocom/mcp"],
      "env": {
        "HOSTEALO_API_KEY": "hst_live_your_key"
      }
    }
  }
}
```

### Cursor

Settings → MCP → Add new MCP server:

```json
{
  "mcpServers": {
    "hostealo": {
      "command": "npx",
      "args": ["-y", "@hostealocom/mcp"],
      "env": {
        "HOSTEALO_API_KEY": "hst_live_your_key"
      }
    }
  }
}
```

### Claude Code

```bash
claude mcp add hostealo \
  --transport http \
  https://my.hostealo.com/api/v1/mcp \
  --header "X-API-Key: hst_live_your_key"
```

> Claude Code also supports the remote HTTP transport directly — no need for npx.

## Available Tools (52)

### Services
| Tool | Description |
|------|-------------|
| `list_services` | List all your hosting services (filter by type/status) |
| `get_service` | Get details of a specific service |
| `get_vps_status` | Live VPS status (CPU, RAM, bandwidth, IP) |
| `get_vps_usage` | Historical resource usage charts |
| `get_vps_os_images` | Available OS images and apps for reinstall |

### VPS Actions
| Tool | Description |
|------|-------------|
| `vps_power` | Start, stop, or restart a VPS |
| `vps_reinstall` | Reinstall OS or application |
| `vps_reset_password` | Reset root/admin password |
| `list_backups` | List VPS backups |
| `create_backup` | Create a new backup |
| `restore_backup` | Restore from a backup |

### Domains
| Tool | Description |
|------|-------------|
| `domains_list` | List all your registered domains |
| `domain_get` | Domain detail with live nameservers and registry status |
| `domain_check` | Check if a domain is available for registration |
| `domain_pricing` | List all TLD pricing (register/transfer/renew) in EUR |
| `domain_nameservers` | Get current nameservers |
| `domain_update_nameservers` | Update nameservers (min 2 NS) |
| `domain_renew` | Renew domain for 1-10 years |

### Dedicated Servers
| Tool | Description |
|------|-------------|
| `dedicated_stock` | Browse live dedicated server stock by location |
| `dedicated_request` | Request a dedicated server (creates support ticket) |

### Billing
| Tool | Description |
|------|-------------|
| `list_invoices` | List invoices (filter by status) |
| `get_invoice` | Invoice details with line items |
| `pay_invoice` | Pay an invoice with account balance |

### Support
| Tool | Description |
|------|-------------|
| `list_tickets` | List support tickets |
| `get_ticket` | Ticket details with messages |
| `create_ticket` | Open a new support ticket |
| `reply_ticket` | Reply to a ticket |
| `close_ticket` | Close a ticket |

### Account
| Tool | Description |
|------|-------------|
| `get_account` | Your account profile |
| `get_balance` | Balance and recent transactions |

### Notifications
| Tool | Description |
|------|-------------|
| `list_notifications` | List notifications (filter unread) |
| `mark_notification_read` | Mark a notification as read |

### Orders
| Tool | Description |
|------|-------------|
| `list_plans` | List available VPS and colocation plans |
| `order_vps` | Place a VPS order |
| `order_colocation` | Place a colocation order |
| `order_ip_block` | Order a /24 IP block |
| `order_asn` | Register an ASN |

### DDoS Protection
| Tool | Description |
|------|-------------|
| `ddos_overview` | Bandwidth overview for a VPS IP |
| `ddos_rules` | List active DDoS rules |
| `ddos_create_rule` | Create a DDoS rule |
| `ddos_delete_rule` | Delete a DDoS rule |
| `ddos_applications` | List detected applications |
| `ddos_attacks` | List mitigated attacks |
| `ddos_attack_detail` | Details of a specific attack |

### Knowledge Base
| Tool | Description |
|------|-------------|
| `kb_search` | Search knowledge base articles |
| `kb_article` | Get full article content |

### Announcements
| Tool | Description |
|------|-------------|
| `announcements_list` | List published platform announcements (filter by type) |
| `announcement_get` | Get full announcement content |

### Service Sharing
| Tool | Description |
|------|-------------|
| `list_shares` | List active shares for a service |
| `create_share` | Generate share invite code |
| `revoke_share` | Revoke a share |
| `accept_share` | Accept a share invite |

### Server Status
| Tool | Description |
|------|-------------|
| `get_server_status` | Infrastructure status and uptime monitors |

## Configuration

| Environment Variable | Default | Description |
|---------------------|---------|-------------|
| `HOSTEALO_API_KEY` | — | **Required.** Your API key |
| `HOSTEALO_API_URL` | `https://my.hostealo.com/api/v1` | API base URL |

You can also pass `--api-key=hst_live_...` as a CLI argument.

## API Key Permissions

| Level | Access |
|-------|--------|
| `read` | List and view resources only |
| `read_write` | Read + create tickets, power actions, backups, update NS |
| `full` | Everything including payments, orders, and key management |

Create and manage keys at [my.hostealo.com/account/api-keys](https://my.hostealo.com/account/api-keys).

## Example Prompts

Once connected, try asking your AI assistant:

- *"Show me the status of all my VPS servers"*
- *"Restart my Madrid VPS"*
- *"Do I have any unpaid invoices?"*
- *"Is example.com available? How much does it cost?"*
- *"Show me the nameservers for my domain"*
- *"What dedicated servers are available in Germany?"*
- *"Create a support ticket about slow network on my NY server"*
- *"What's my current account balance?"*
- *"Show me recent DDoS attacks on my VPS"*

## Requirements

- Node.js 18+
- A Hostealo account with an API key

## License

MIT