home / mcp / cloudways mcp server

Cloudways MCP Server

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "aphraz-cw-mcp": {
      "url": "http://localhost:7000/mcp",
      "headers": {
        "LOG_LEVEL": "INFO",
        "REDIS_URL": "redis://localhost:6379/0",
        "LOG_FORMAT": "console",
        "ENCRYPTION_KEY": "YOUR_ENCRYPTION_KEY",
        "HTTP_POOL_SIZE": "500",
        "REDIS_POOL_SIZE": "500",
        "RATE_LIMIT_WINDOW": "60",
        "RATE_LIMIT_REQUESTS": "90"
      }
    }
  }
}

This MCP server provides a secure, modular interface to manage Cloudways infrastructure through 43+ tools. It enables you to perform server and application management, monitor activities, enforce security, and automate workflows with an AI-friendly protocol.

How to use

You interact with the Cloudways MCP Server using an MCP client that talks to the server over HTTP or via a local process. Start by starting the local MCP server or connecting to the remote HTTP endpoint, then issue tool calls to perform operations such as listing servers, retrieving app details, managing domains, or applying security policies. Each tool is designed to be invoked with structured parameters, and you can combine multiple tools to automate complex workflows.

How to install

Prerequisites: Python 3.11+, a running Redis server, and Cloudways API credentials.

1. Set up environment variables for secure operation.

2. Prepare and export the encryption key and Redis configuration.

3. Start the MCP server and verify it is listening at the default MCP URL.

Additional notes

Security and observability are built in. You get credential encryption, session isolation, rate limiting, audit logging, and structured monitoring. The MCP server supports both HTTP-based remote access and local stdio-based startup for development and experimentation.

Available tools

ping

Basic connectivity and authentication test to verify the MCP endpoint is reachable.

customer_info

Retrieve session and customer authentication details to confirm identity and access rights.

rate_limit_status

Return the current rate limit status for the active session.

list_servers

List Cloudways servers available under your account.

get_server_details

Fetch detailed information for a specific server.

get_app_details

Get details for a particular application.

get_app_credentials

Retrieve credentials for the specified application.

get_app_settings

Obtain current settings for an application.

get_app_monitoring_summary

View a summary of application monitoring data.

list_projects

List projects associated with your Cloudways account.

list_team_members

Fetch team member information for access control.

get_alerts

Retrieve configured alerts for proactive monitoring.

get_ssh_keys

List SSH keys available for access to servers.

get_available_providers

Show supported hosting providers.

get_available_regions

List regions where resources can be provisioned.

get_available_server_sizes

Display available server size options.

get_available_apps

Show apps that can be provisioned or managed.

get_available_packages

List available software packages for installations.

start_server

Power on a specified server.

stop_server

Power off a specified server.

restart_server

Restart a specified server.

backup_server

Create a backup snapshot of a server.

get_server_settings

Fetch current server configuration.

get_server_disk_usage

Check disk usage on the server.

optimize_server_disk

Run optimization on server storage to reclaim space.

get_server_services_status

Check the status of services running on the server.

change_service_state

Enable or disable a server service.

manage_server_varnish

Configure or manage Varnish caching on the server.

get_server_monitoring_detail

Retrieve detailed monitoring metrics for the server.

get_server_analytics

Fetch server analytics data for insights.

clone_app

Create a clone of an existing application.

backup_app

Back up an application’s files and data.

restore_app

Restore an application from a backup.

rollback_app_restore

Rollback a restoration to a previous state.

clear_app_cache

Clear the application cache to refresh content.

get_app_varnish_settings

Retrieve Varnish settings for an application.

manage_app_varnish

Configure Varnish caching behavior for an application.

reset_app_file_permissions

Reset file permissions for the application directory.

enforce_app_https

Enforce HTTPS for the application.

update_app_cname

Add or modify the CNAME for the application domain.

delete_app_cname

Remove the CNAME from the application.

get_app_analytics_traffic

View traffic analytics for the application.

get_app_analytics_php

View PHP analytics for the application.

get_app_analytics_mysql

View MySQL analytics for the application.

get_whitelisted_ips_ssh

List IPs whitelisted for SSH access.

get_whitelisted_ips_mysql

List IPs whitelisted for MySQL access.

update_whitelisted_ips

Update IP allowlists for SSH/MySQL access.

check_ip_blacklisted

Check if an IP is blacklisted.

allow_ip_siab

Grant SIAB access to a specific IP.

allow_ip_adminer

Grant Adminer access to a specific IP.

install_ssl_certificate

Install an SSL certificate on the target domain.

remove_ssl_certificate

Remove an SSL certificate from the target domain.

install_letsencrypt

Install Let’s Encrypt certificates for domains.

renew_letsencrypt

Renew Let’s Encrypt certificates for domains.

set_letsencrypt_auto_renewal

Enable automatic renewal for Let’s Encrypt certificates.

revoke_letsencrypt

Revoke Let’s Encrypt certificates for domains.

generate_git_ssh_key

Generate a Git SSH key pair for deployments.

get_git_ssh_key

Retrieve the generated Git SSH key.

git_clone

Clone a repository using Git deployment tooling.

git_pull

Pull latest changes for a deployed app.

get_git_deployment_history

View deployment history for Git-based deployments.

get_git_branch_names

List available Git branches for deployment.