@hostealocom/mcp

MCP (Model Context Protocol) server for Hostealo — manage your hosting services directly from AI assistants like Claude, Cursor, and others.

Quick Start

HOSTEALO_API_KEY=hst_live_your_key npx -y @hostealocom/mcp

Get your API key from Account → API Keys in the Hostealo panel.

Setup

Claude Desktop

Add to your claude_desktop_config.json:

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

Cursor

Settings → MCP → Add new MCP server:

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

Claude Code

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 (72)

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 — common

Provider-aware: response shape adapts to whichever network covers the VPS IP (Hostealo Shield for Spanish prefixes; W&D Shield for NL/DE/US). The differences are documented inside each tool's description.

| Tool | Description | |------|-------------| | ddos_overview | Bandwidth (pass vs drop). Hostealo adds settings_summary, covering_subnet, bgp, totals, sample_rate. | | ddos_attacks | List mitigated attacks. Hostealo rows carry pps_peak/bps_peak/signatures; W&D rows carry maximum_peak/raw_maximum_peak/total_bandwidth. | | ddos_attack_detail | Detailed attack stats. Hostealo returns rich top.* breakdown (countries, IPs, ports, ASNs, packet lengths, protocols, TTLs); W&D returns attack_ports. | | ddos_applications | Application/preset library used to create rules or attach profiles. |

DDoS Protection — W&D Shield only

| Tool | Description | |------|-------------| | ddos_rules | List firewall rules for a VPS IP | | ddos_create_rule | Create a firewall rule | | ddos_delete_rule | Delete a firewall rule |

DDoS Protection — Hostealo Shield only

IP Lists (owner-only, max 10 per user)

| Tool | Description | |------|-------------| | ddos_iplists | List the customer's IP lists + system lists | | ddos_iplist_create | Create a new IP list (default action WHITELIST/BLACKLIST/TRUST) | | ddos_iplist_update | Rename or redescribe a list | | ddos_iplist_delete | Delete a list (fails if attached to a Protection Profile) | | ddos_iplist_entries | List entries inside a list | | ddos_iplist_entry_add | Add a single IP/CIDR (bare IPs auto-normalized to /32) | | ddos_iplist_entries_add_batch | Bulk-add up to 100 IPs/CIDRs in one call | | ddos_iplist_entry_delete | Remove a single entry |

Custom Protection Presets (owner-only, max 10 per user)

| Tool | Description | |------|-------------| | ddos_presets | List custom + system presets with full flag detail (for clone) | | ddos_preset_create | Create a custom preset (19 boolean flags + limits) | | ddos_preset_update | Update an existing preset | | ddos_preset_delete | Delete a preset (fails if attached to a profile) | | ddos_filters | Read-only library of upstream packet filters available to FILTER-action presets |

IP Settings + Profile Attachment (shared full users can mutate)

| Tool | Description | |------|-------------| | ddos_ip_settings_presets | List IP Settings Presets master library (template that locks action + limits at the IP level) | | ddos_settings_update | Patch the IP's Settings — Country/ASN block lists, default action, attached preset | | ddos_attach_profile | Attach a Protection Profile preset to the IP (per-port / per-protocol) | | ddos_detach_profile | Detach a Protection Profile from the IP | | ddos_pcap | Download packet capture for a time window (base64-encoded pcapng) | | ddos_samples | Paginated raw packet samples for forensic inspection |

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.

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