Cloudways MCP Server provides a set of structured tools that allow MCP-compatible AI clients to interact with your Cloudways account using natural language.
Each tool is designed to perform a specific Cloudways operation, such as listing servers, creating applications, managing backups, restarting services, updating server settings, reviewing monitoring data, managing Cloudflare CDN, handling DNS records, deploying code through Git, or managing SSH keys.
This article provides a complete reference list of Cloudways MCP Server tools and their descriptions. You can use it to understand what each tool does before using Cloudways MCP through an AI assistant.
This helps keep the main MCP Server setup article simple, while giving users a separate place to review all supported tools in detail.
Cloudways MCP Server Tools
You can also visit the Cloudways API Playground to explore the available Cloudways API endpoints, review request structures, and understand how different API actions work.
Note:
Some API tools perform account, server, application, billing, or security actions directly. Users should test API requests carefully in the API Playground, preferably on a test server or test application, before using them in production workflows. API access should only be used by trusted account owners or authorized users.
Server Management
Cloudways MCP allows you to manage your servers easily through AI-assisted commands.
With server management tools, you can:
Create and set up new servers
Start, stop, or restart servers
Scale server resources as needed
Manage backups and restore points
Track the status of ongoing operations (such as server creation or scaling)
These tools help you handle all key server-related tasks without needing to manually interact with the Cloudways platform interface.
Tool | Description |
server_list | List all servers with their status, cloud provider, region, IP, and app count. |
server_get | Get detailed info about a specific server including all hosted apps and configuration. |
server_create | Create a new server on DigitalOcean, AWS, GCE, Vultr, or Linode with an initial application. |
server_start | Start a stopped server. |
server_stop | Stop a running server. |
server_restart | Restart a server to apply configuration changes. |
server_delete | Permanently delete a server and all its data. |
server_backup | Create a full backup of a server. |
server_scale | Upgrade or downgrade server size (CPU/RAM). |
server_update_label | Rename a server. |
operation_status | Check the status of an async operation. |
server_clone | Clone an existing server to a new server with the same applications and, optionally, settings, app domains, cron jobs, and SSL certificates. |
server_scale_volume | Change the data volume size on a server (available for Amazon and GCE servers only). |
server_disk_usage_fetch | Initiate a disk usage fetch operation for a server. |
server_snapshot_frequency_update | Configure the snapshot backup frequency (in hours) for AWS and GCE servers. Send an empty or null value to disable. |
server_backup_settings_update | Update the backup settings for a server, including frequency of automatic backups, retention period, off-server storage, local backups, and more. |
server_local_backup_delete | Delete the local backups stored on the server itself. |
server_package_update | Install, uninstall, or upgrade packages on a server (PHP, MySQL/MariaDB versions, etc.). Use server_packages to discover available packages. |
server_maintenance_window_get | Retrieve the configured maintenance window settings for a server (days of the week and time slot) during which Cloudways may apply updates. |
server_maintenance_window_update | Update the maintenance window settings for a server by setting the days of the week and preferred time slot. |
server_master_username_update | Update the master username for a server (used for SSH/SFTP access). |
server_master_password_update | Update the master password for a server (used for SSH/SFTP access). |
server_storage_attach | Attach a Block Storage volume to a server (DigitalOcean servers only). |
server_storage_scale | Resize the Block Storage volume attached to a server (DigitalOcean servers only). |
Application Management
Tools for managing applications hosted on Cloudways servers, including creation, cloning, deletion, backups, and security insights.
Tool | Description |
app_list | List all applications on a specific server. |
app_get | Get detailed information about a specific application. |
app_create | Create a new application (WordPress, Laravel, Magento, etc.). |
app_delete | Permanently delete an application and its data. |
app_clone | Clone an application on the same server. |
app_clone_to_server | Clone an application to a different server. |
app_backup | Create a backup of an application. |
app_credentials | Get SSH/SFTP credentials for an application. |
app_purge_cache | Clear all cache layers for an application. |
app_update_label | Rename an application. |
app_vulnerabilities_list | List WordPress vulnerabilities with severity scores. |
app_vulnerabilities_refresh | Trigger a new vulnerability scan. |
staging_app_clone | Clone a staging application to the same server. |
staging_app_clone_to_server | Clone a staging application to a different existing server. |
app_cname_update | Update an application's primary domain (CNAME). |
app_cname_delete | Delete an application's primary domain (CNAME), reverting to the default Cloudways URL. |
app_restore | Restore an application to a previous backup version (local or remote). |
app_restore_rollback | Roll back the last backup restore action, returning the application to its pre-restore state. |
app_backup_status_get | Get the status of an in-progress application backup operation. |
app_local_backup_delete | Delete the local backup created as part of a restore operation. |
app_aliases_update | Update application aliases (secondary domains pointing to the same application). |
app_cron_list_get | Retrieve the list of cron jobs scheduled for an application on a server. |
app_cron_list_update | Update the list of cron jobs scheduled for an application on a server. |
app_db_password_update | Update the database password used by the application to connect to its MySQL/MariaDB database. |
app_symlink_update | Update the symlink target for an application by changing where public_html points. |
app_webroot_update | Update the webroot of an application (e.g., point Nginx to /public_html/public for Laravel). |
app_cors_headers_update | Update CORS (cross-origin resource sharing) headers for an application |
app_webp_redirection_update | Enable or disable WebP redirection and automatically serve WebP versions of images to supported browsers. |
app_enforce_https_update | Enable or disable HTTPS redirection for an application (forces HTTP traffic to HTTPS). |
app_reset_permissions | Reset file and folder permissions for an application, fixing ownership and modes after manual changes. |
app_fpm_settings_update | Configure PHP-FPM settings for an application (workers, max children, request memory, etc.). |
app_fpm_settings_get | Retrieve the current PHP-FPM configuration for an application. |
app_varnish_settings_get | Retrieve the Varnish configuration (TTL, cacheable paths, exclusions) for an application. |
app_varnish_settings_update | Update the Varnish configuration (TTL, cacheable paths, exclusions) for an application |
app_credentials_create | Create a new SSH/SFTP access credential for an application (in addition to the master credential). |
app_credentials_delete | Delete a specific application access credential. |
app_credentials_update | Update a specific application access credential ( rename it, change its password, or both). |
app_ssh_access_get | Retrieve the current SSH access status for an application (enabled or disabled). |
app_ssh_access_update | Enable or disable SSH access for an application. |
app_access_state_get | Retrieve the access state of an application ( publicly accessible or in maintenance mode). |
app_settings_get | Retrieve current values of application setting flags (XML-RPC, GEO-IP header, device detection, etc.). |
app_access_state_update | Update the access state of an application (public or maintenance mode). |
app_geo_ip_header_update | Enable or disable the GEO-IP header. Note that Cloudways injects the visitor's country into the request. |
app_xmlrpc_update | Enable or disable WordPress XML-RPC for an application (recommended off for security). |
app_device_detection_update | Enable or disable Device Detection for an application (separates desktop and mobile cache buckets). |
app_ignore_query_string_update | Enable or disable the Ignore Query String cache rule for an application. |
app_php_direct_execution_update | Enable or disable direct PHP file execution from wp-content/uploads (WordPress security setting). |
app_cron_optimizer_update | Enable or disable the Cron Optimizer. This replaces WP-Cron with system cron for improved reliability. |
app_admin_password_update | Update the admin password of the installed application (e.g., the WordPress admin user's password). |
app_password_protection_get | Retrieve the current password protection (htpasswd / HTTP Basic Auth) configuration for an application. |
app_password_protection_update | Enable or update password protection (HTTP Basic Auth) for an application. |
app_wp_multisite_update | Enable or update the WordPress Multisite configuration (subdomain or subdirectory network). |
app_stack_update | Update the application stack version (v1 Hybrid/Apache or v2 Lightning/NGINX). |
app_object_cache_update | Enable or disable the WordPress Object Cache (OCP) feature for an application. |
Service Management
Tools for managing infrastructure-level services such as web servers, databases, and caching layers. These operations directly impact application availability and performance.
Tool | Description |
service_status | Check the status of all services on a server. |
service_restart | Restart a specific service (nginx, mysql, php-fpm, etc.). |
service_start | Start a stopped service. |
service_stop | Stop a running service. |
varnish_manage | Enable, disable, or purge Varnish cache at server level. |
varnish_app_manage | Enable or disable Varnish cache per application. |
Add-on Management
Tools for managing Cloudways add-ons at both account and server levels, including activation, deactivation, and configuration of services like SMTP and DNS.
Tool | Description |
addon_list | List all available add-ons with status and pricing. |
addon_activate | Activate an add-on on your account. |
addon_deactivate | Deactivate an add-on from your account. |
addon_activate_on_server | Enable an add-on on a specific server. |
addon_deactivate_on_server | Remove an add-on from a server. |
Cloudflare CDN
Tools for integrating and managing Cloudflare CDN at the application level, including domain onboarding and verification workflows.
Tool | Description |
cloudflare_add_domain | Add a domain to Cloudflare CDN for an application. |
cloudflare_get_details | View CDN status, configuration, and usage. |
cloudflare_get_txt_records | Retrieve DNS TXT records for domain verification. |
DNS Made Easy
Tools for managing DNS zones and records through the DNS Made Easy add-on, including domain lifecycle operations and traffic usage insights.
Tool | Description |
dns_made_easy_list_domains | List all managed domains. |
dns_made_easy_add_domains | Add domains for DNS management. |
dns_made_easy_delete_domains | Delete domains from DNS Made Easy. |
dns_made_easy_get_domain_status | Check domain status. |
dns_made_easy_list_records | List DNS records for a domain. |
dns_made_easy_add_records | Add DNS records. |
dns_made_easy_delete_records | Delete DNS records. |
dns_made_easy_update_record | Update DNS records. |
dns_made_easy_get_domain_usage | View DNS usage statistics. |
Server Settings
Tools for viewing and modifying server-level configuration, including PHP settings, MySQL parameters, and automated maintenance operations like disk cleanup.
Tool | Description |
server_settings_get | View server and PHP configuration. |
server_settings_update | Update PHP and MySQL settings. |
server_disk_cleanup_settings_get | View disk cleanup settings. |
server_disk_cleanup_settings_update | Configure automated cleanup. |
server_disk_cleanup_execute | Execute disk cleanup manually. |
Monitoring & Analytics
Tools for retrieving infrastructure metrics, application performance data, and traffic analytics. These support debugging, optimization, and capacity planning workflows.
Tool | Description |
monitoring_server_summary | View server bandwidth and disk usage. |
monitoring_server_usage | Refresh server usage statistics. |
monitoring_server_graph | Retrieve monitoring graphs (CPU, memory, etc.). |
monitoring_app_summary | View application-level usage metrics. |
analytics_app_traffic | Analyze traffic patterns and sources. |
analytics_app_traffic_details | Get detailed traffic data for custom ranges. |
analytics_app_php | Analyze PHP performance and slow pages. |
analytics_app_mysql | Analyze MySQL queries and performance. |
analytics_app_cron | View cron job execution analytics. |
Copilot Insights
Tools that provide AI-driven insights and alerts about infrastructure health, risks, and optimization opportunities based on Cloudways Copilot analysis.
Tool | Description |
copilot_insights_list | Retrieve insights, alerts, and recommendations for your infrastructure. |
Projects
Tools for organizing servers and applications into logical groups. These operations help you structure your Cloudways fleet for easier navigation, client management, and team collaboration.
Tool | Description |
project_list | List all Projects on the account (with their IDs, names, and the servers / apps grouped under each). |
project_create | Create a new Project on the account (give it a name and an initial set of application members). |
project_update | Update an existing Project by its ID by renaming or changing which applications belong to the project. |
project_delete | Delete a Project by its ID (This only removes the grouping. The underlying servers and applications are not deleted). |
Git Deployment
Tools for managing Git-based deployments on your applications. These operations enable source-controlled code delivery, from setting up SSH deploy keys and linking repositories to pulling the latest commits and reviewing deployment history.
Tool | Description |
git_generate_key | Generate a fresh SSH deploy key for an application (Cloudways creates a new key pair on the server; the public half is then registered with the Git repository host so Cloudways can pull from it without a password). |
git_key_get | Retrieve the contents of the public SSH key generated for an application. Copy/paste this value into your Git host (GitHub / GitLab / Bitbucket) as a deploy key. |
git_branches_get | Refresh and return the list of branches available in the linked Git repository. This can be used to populate a branch selector before cloning or pulling. |
git_clone | Clone a Git repository (specific branch) into an application's web root and deploy the initial code. Use this once when first linking a repo. Note that subsequent updates go through git_pull. |
git_pull | Pull the latest commits from the linked Git branch and deploy them onto the application. |
git_history_get | Retrieve the recent Git deployment history for an application (timestamped list of clone / pull operations with commit hashes and status) to review what was deployed and when. |
SSH Key Management
Tools for managing SSH public keys across servers, applications, and system users. These operations control who can authenticate via SSH or SFTP, enabling secure access provisioning and revocation without requiring password-based login.
Tool | Description |
ssh_key_create | Add (upload) an SSH public key to a server, an application, or a system user so that the holder of the corresponding private key can SSH/SFTP into that target. |
ssh_key_delete | Delete (revoke) a previously added SSH key by its ssh_key_id, removing the holder's ability to SSH/SFTP into the associated server, application, or user. |
ssh_key_update | Rename an existing SSH key by its ssh_key_id (updates the label only). To rotate the key material, delete the old key (ssh_key_delete) and add a new one (ssh_key_create). |
Authentication API
These tools are used to authenticate API requests. Before using other Cloudways API endpoints, users need to generate an OAuth access token and include it in the authorization header of their requests.
Tool | Description |
POST /oauth/access_token | Generate an OAuth access token required to authorize Cloudways API requests. |
Add-ons Management API
These tools are used to view, activate, deactivate, upgrade, and request Cloudways add-ons at the account, server, or application level.
Tool | Description |
GET /addon | Retrieve the list of available Cloudways add-ons. |
POST /addon/activateOnServer | Activate an add-on on a specific server. |
POST /addon/deactivateOnServer | Deactivate or remove an add-on from a specific server. |
POST /addon/activate | Activate an add-on at the account level. |
POST /addon/request | Request an add-on for a specific application. |
POST /addon/upgrade | Upgrade an existing add-on package. |
GET /addon/getRackspaceMailboxes | Retrieve the list of Rackspace mailboxes. |
GET /addon/elastic-email/domains | List Elastic Email domains connected to the account. |
POST /addon/elastic-email/domain/verify | Verify an Elastic Email domain. |
DELETE /addon/elastic-email/domain/delete | Delete an Elastic Email domain from the account. |
Application API
These tools are used for core application lifecycle actions such as creating, cloning, deleting, renaming, and cloning staging applications.
Tool | Description |
POST /app | Add a new application to an existing server. |
DELETE /app/{appId} | Delete an application from a server. |
PUT /app/{appId} | Update the application label. |
POST /app/clone | Clone an application on the same server. |
POST /app/cloneToOtherServer | Clone an application to another server. |
POST /staging/app/cloneApp | Clone a staging application on the same server. |
POST /staging/app/cloneToOtherServer | Clone a staging application to another server. |
App Management API
These tools are used to manage day-to-day application settings, access, credentials, backups, domains, cron jobs, cache, PHP-FPM, Varnish, security settings, and application-level configurations.
Tool | Description |
GET /app/creds | Retrieve application SSH/SFTP credentials. |
POST /app/creds | Create new application credentials. |
PUT /app/creds/{app_cred_id} | Update a specific application credential. |
DELETE /app/creds/{app_cred_id} | Delete a specific application credential. |
GET /app/getAppSshPerms | Retrieve the current SSH access status for an application. |
POST /app/updateAppSshPerms | Enable or disable SSH access for an application. |
GET /app/getApplicationAccess | Retrieve the current application access state. |
POST /app/state | Change the application access state, such as public or restricted. |
POST /app/manage/backup | Create an application backup. |
GET /app/manage/backup | Check local application backup status. |
DELETE /app/manage/backup | Delete the local application backup. |
POST /app/manage/restore | Restore an application from a backup. |
POST /app/manage/rollback | Roll back the last application restore action. |
POST /app/manage/cname | Update the primary domain or CNAME of an application. |
DELETE /app/manage/cname | Delete the application CNAME and revert to the default URL. |
POST /app/manage/aliases | Update application aliases or secondary domains. |
GET /app/manage/cronList | Retrieve the list of cron jobs for an application. |
POST /app/manage/cronList | Update the cron job list for an application. |
POST /app/manage/dbPassword | Update the application database password. |
GET /app/manage/fpm_setting | Retrieve PHP-FPM settings for an application. |
POST /app/manage/fpm_setting | Update PHP-FPM settings for an application. |
GET /app/manage/varnish_setting | Retrieve Varnish settings for an application. |
POST /app/manage/varnish_setting | Update Varnish settings for an application. |
POST /app/manage/symlink | Update the symlink target for an application. |
POST /app/manage/webroot | Update the application webroot. |
POST /app/manage/reset_permissions | Reset file and folder permissions for an application. |
POST /app/cache/purge | Clear or purge application cache. |
POST /app/manage/cors | Update CORS headers for an application. |
POST /app/manage/webp | Enable or disable WebP redirection. |
POST /app/manage/enforce_https | Enable or disable HTTPS redirection. |
POST /app/manage/geoip | Enable or disable the GEO-IP header for an application. |
POST /app/manage/xmlrpc | Enable or disable WordPress XML-RPC. |
POST /app/manage/device_detection | Enable or disable Device Detection. |
POST /app/manage/ignore_query_string | Enable or disable Ignore Query String caching. |
POST /app/manage/php_direct_execution | Enable or disable direct PHP execution from WordPress uploads. |
POST /app/manage/cron_optimizer | Enable or disable the Cron Optimizer. |
POST /app/manage/admin_password | Update the admin password of the installed application. |
GET /app/password-protection | Retrieve current application password protection settings. |
POST /app/password-protection | Enable or update application password protection. |
POST /app/wp-multisite | Enable or update WordPress Multisite configuration. |
POST /app/stack | Update the application stack version. |
POST /app/object-cache | Enable or disable Object Cache for a WordPress application. |
Bot Protection API
These tools are used to review and manage Bot Protection data, including traffic, login traffic, bad bots, whitelisted IPs, whitelisted bots, and activation or deactivation settings.
Tool | Description |
GET /app/malcare | Check Bot Protection status for an application. |
GET /app/malcare/traffic | Retrieve Bot Protection traffic data. |
GET /app/malcare/traffic/summary | Retrieve summarized Bot Protection traffic data. |
GET /app/malcare/logins | Retrieve Bot Protection login traffic data. |
GET /app/malcare/logins/summary | Retrieve summarized login protection traffic data. |
GET /app/malcare/bots/bad | Retrieve the list of detected bad bots. |
GET /app/malcare/whitelisted_ips | Retrieve IPs whitelisted from Bot Protection blocking. |
GET /app/malcare/whitelisted_bots | Retrieve bots whitelisted from Bot Protection blocking. |
PUT /app/malcare/enable | Enable Bot Protection for an application. |
PUT /app/malcare/disable | Disable Bot Protection for an application. |
PUT /app/malcare/whitelist_ip | Add or update whitelisted IPs for Bot Protection. |
PUT /app/malcare/whitelist_bot | Add or update whitelisted bots for Bot Protection. |
CloudwaysBot API
These tools are used to manage CloudwaysBot alerts and alert integrations. They help users create channels, retrieve alerts, update integrations, and mark notifications as read.
Tool | Description |
GET /integrations/create | Retrieve the list of available CloudwaysBot alert channel types. |
GET /integrations | Retrieve the user’s configured CloudwaysBot integrations. |
POST /integrations | Create a new CloudwaysBot alert integration. |
PUT /integrations/{channel_id} | Update an existing CloudwaysBot integration. |
DELETE /integrations/{channel_id} | Delete a CloudwaysBot alert channel. |
GET /alerts | Retrieve all CloudwaysBot alerts. |
GET /alerts/{last_id} | Retrieve paginated CloudwaysBot alerts. |
POST /alert/markAllRead | Mark all CloudwaysBot alerts as read. |
POST /alert/markAsRead/{alert_id} | Mark a specific CloudwaysBot alert as read. |
Cloudflare Enterprise API
These tools are used to manage Cloudflare Enterprise for applications, including domain setup, TXT verification, cache purge, Smart Cache Purge, settings, and analytics.
Tool | Description |
GET /cloudflare | Retrieve Cloudflare details for an application or domain. |
POST /cloudflare/domain | Set up Cloudflare for an application domain. |
GET /cloudflare/txt | Fetch TXT records required for Cloudflare verification. |
DELETE /cloudflare/domain/delete | Delete a Cloudflare Enterprise domain. |
POST /cloudflare/domain/transfer | Transfer a Cloudflare Enterprise domain. |
POST /cloudflare/domain/purge | Purge Cloudflare cache for a domain. |
GET /cloudflare/dns/query | Retrieve Cloudflare DNS query information. |
POST /cloudflare/txt/verify | Verify TXT records for Cloudflare domain validation. |
GET /cloudflare/smart-cache-purge/status | Retrieve Smart Cache Purge status. |
POST /cloudflare/smart-cache-purge/configure | Configure Smart Cache Purge. |
GET /cloudflare/settings | Retrieve Cloudflare Enterprise settings. |
PUT /cloudflare/settings | Update Cloudflare Enterprise settings. |
GET /cloudflare/analytics/cache | Retrieve Cloudflare cache analytics. |
GET /cloudflare/analytics/security | Retrieve Cloudflare security analytics. |
CloudwaysCDN API
These tools are used to manage the legacy CloudwaysCDN workflow, including setup, activation, bandwidth, purge, URL update, and subscription removal.
Tool | Description |
GET /app/cdn | Retrieve CloudwaysCDN details for an application. |
POST /app/cdn | Set up CloudwaysCDN for an application. |
POST /app/cdn/activate | Activate CloudwaysCDN for an application. |
GET /app/cdn/bandwidth | Retrieve CloudwaysCDN bandwidth usage. |
POST /app/cdn/purge | Purge assets from CloudwaysCDN. |
PUT /app/cdn/{app_id} | Update the CloudwaysCDN website URL. |
DELETE /app/cdn/{app_id} | Remove the CloudwaysCDN subscription. |
Application Vulnerability API
These tools are used to list and refresh application vulnerability information, especially for WordPress applications.
DNS Made Easy API
These tools are used to manage DNS Made Easy domains and DNS records through the Cloudways API.
Tool | Description |
GET /dns_made_easy/domains | List DNS Made Easy domains. |
POST /dns_made_easy/domains | Add domains to DNS Made Easy. |
DELETE /dns_made_easy/domains | Delete domains from DNS Made Easy. |
GET /dns_made_easy/domain/status | Retrieve the status of a DNS Made Easy domain. |
GET /dns_made_easy/records | Retrieve DNS records for a DNS Made Easy domain. |
POST /dns_made_easy/records | Add DNS records to a DNS Made Easy domain. |
DELETE /dns_made_easy/records | Delete DNS records from a DNS Made Easy domain. |
PUT /dns_made_easy/record | Update a DNS record for a DNS Made Easy domain. |
GET /dns_made_easy/domain/usage | Retrieve current month DNS Made Easy domain usage. |
SafeUpdates API
These tools are used to retrieve, configure, enable, disable, schedule, and review SafeUpdates activity for applications.
Tool | Description |
GET /safeupdates | Retrieve SafeUpdates details. |
PUT /safeupdates | Update SafeUpdates configuration. |
GET /safeupdates/status | Retrieve SafeUpdates status. |
PUT /safeupdates/status | Update SafeUpdates status. |
GET /safeupdates/list | Retrieve SafeUpdates list. |
GET /safeupdates/settings | Retrieve SafeUpdates settings. |
PUT /safeupdates/settings | Update SafeUpdates settings. |
GET /safeupdates/schedule | Retrieve SafeUpdates schedule. |
GET /safeupdates/history | Retrieve SafeUpdates history. |
Git API
These tools are used to manage Git deployment for applications, including SSH key generation, branch retrieval, cloning, pulling, and deployment history.
Tool | Description |
POST /git/generateKey | Generate a Git SSH deploy key for an application. |
GET /git/key | Retrieve the Git SSH public key. |
GET /git/branchNames | Retrieve branch names from a Git repository. |
POST /git/clone | Clone a Git repository into an application. |
POST /git/pull | Pull the latest commits from the configured Git branch. |
GET /git/history | Retrieve Git deployment history. |
Lists API
These tools return predefined values used across the API, such as available applications, regions, providers, packages, server sizes, backup frequencies, and monitoring options.
Tool | Description |
GET /apps | Retrieve the list of supported application types. |
GET /backup-frequencies | Retrieve supported backup frequency options. |
GET /countries | Retrieve the supported countries list. |
GET /monitor_durations | Retrieve supported monitoring duration options. |
GET /monitor_targets | Retrieve supported monitoring target options. |
GET /packages | Retrieve available package options. |
GET /providers | Retrieve supported cloud providers. |
GET /regions | Retrieve available cloud provider regions. |
GET /server_sizes | Retrieve available server size options. |
GET /settings | Retrieve supported settings options. |
Operation API
These tools are used to check the status of asynchronous operations such as server creation, scaling, cloning, and backups.
Tool | Description |
GET /operation/{id} | Retrieve the status of an ongoing operation. |
Projects API
These tools are used to organize applications into projects for easier account and client management.
Tool | Description |
GET /project | Retrieve the list of projects. |
POST /project | Create a new project. |
PUT /project/{id} | Update an existing project. |
DELETE /project/{id} | Delete a project without deleting the underlying applications. |
SSH Key Management API
These tools are used to add, update, or remove SSH public keys for server or application access.
Tool | Description |
POST /ssh_key | Add an SSH public key. |
PUT /ssh_key/{ssh_key_id} | Rename or update an existing SSH key label. |
DELETE /ssh_key/{ssh_key_id} | Delete or revoke an SSH key. |
Security API
These tools are used to manage secure access, IP whitelisting, SSL certificates, DNS validation, Adminer access, and SSH in a Browser access.
Tool | Description |
POST /security/adminer | Allow temporary Adminer access from a specified IP. |
POST /security/siab | Allow SSH in a Browser access from a specified IP. |
GET /security/isBlacklisted | Check whether an IP address is blacklisted. |
GET /security/whitelistedIpsMysql | Retrieve IPs whitelisted for MySQL access. |
GET /security/whitelisted | Retrieve IPs whitelisted for SSH/SFTP access. |
POST /security/whitelisted | Update whitelisted IPs for secure access. |
POST /security/createDNS | Create DNS records required for SSL validation. |
POST /security/verifyDNS | Verify DNS records required for SSL validation. |
POST /security/lets_encrypt_install | Install or manually renew a Let’s Encrypt SSL certificate. |
POST /security/lets_encrypt_auto | Change the Let’s Encrypt auto-renewal policy. |
POST /security/lets_encrypt_revoke | Revoke a Let’s Encrypt SSL certificate. |
POST /security/csr | Create or retrieve a CSR certificate for custom SSL. |
POST /security/crt | Upload or update a custom SSL certificate. |
DELETE /security/crt | Remove an installed custom SSL certificate. |
Server API
These tools are used for core server lifecycle actions such as creating, deleting, starting, stopping, restarting, cloning, scaling, attaching storage, and retrieving server information.
Tool | Description |
GET /server | Retrieve the list of servers. |
POST /server | Create a new server. |
DELETE /server/{serverId} | Delete a server. |
PUT /server/{serverId} | Update a server label. |
POST /server/start | Start a stopped server. |
POST /server/stop | Stop a running server. |
POST /server/restart | Restart a server. |
POST /server/cloneServer | Clone an existing server. |
GET /server/{server_id}/diskUsage | Retrieve server disk usage. |
POST /server/scaleServer | Upgrade or scale a server. |
POST /server/scaleResources | Scale server resources. |
POST /server/scaleVolume | Scale server volume size. |
POST /server/attachStorage | Attach Block Storage to a server. |
POST /server/scaleStorage | Scale attached Block Storage. |
POST /server/autoScalePolicy | Set server autoscale policy. |
Server Management API
These tools are used for advanced server management, including backups, monitoring graphs, server settings, packages, maintenance windows, master credentials, snapshot frequency, and disk cleanup.
Tool | Description |
POST /server/manage/backup | Create a server backup. |
POST /server/manage/remove_local_backup | Delete local server backups. |
GET /server/monitor/detail | Retrieve server monitoring graph details. |
GET /server/manage/settings | Retrieve server settings. |
POST /server/manage/settings | Update server settings. |
POST /server/manage/backupSettings | Update server backup settings. |
POST /server/manage/masterPassword | Update the server master password. |
POST /server/manage/masterUsername | Update the server master username. |
POST /server/manage/package | Update or install server packages. |
POST /server/manage/snapshotFrequency | Update server snapshot frequency. |
GET /server/manage/maintenance-window | Retrieve server maintenance window settings. |
PUT /server/manage/maintenance-window | Update server maintenance window settings. |
GET /server/disk-cleanup/settings | Retrieve disk cleanup settings. |
PUT /server/disk-cleanup/settings | Update disk cleanup settings. |
POST /server/disk-cleanup/execute | Execute server disk cleanup manually. |
Service API
These tools are used to manage services running on a server, such as starting, stopping, restarting, and managing Varnish at server or application level.
Tool | Description |
GET /service | Retrieve the status of services on a server. |
POST /service/state | Change the state of a service, such as start, stop, or restart. |
GET /service/appVarnish | Retrieve Varnish status at the application level. |
POST /service/varnish | Enable, disable, or purge Varnish at server or application level. |
Supervisord API
These tools are used to manage Supervisord queues for applications that use background workers.
Tool | Description |
GET /app/supervisor | Retrieve Supervisord queues for an application. |
POST /app/supervisor | Create a Supervisord queue. |
DELETE /app/supervisor/{id} | Delete a Supervisord queue. |
GET /supervisor/queue/status | Retrieve Supervisord queue status. |
POST /supervisor/queue/restart | Restart a Supervisord queue. |
Transfer Server API
These tools are used to request, check, or cancel a server transfer process.
Tool | Description |
POST /server_transfer/request | Request a server transfer to another Cloudways account. |
POST /server_transfer/status | Retrieve server transfer status. |
POST /server_transfer/cancel | Cancel a server transfer process. |
Staging Management API
These tools are used to manage staging synchronization, staging authentication, htaccess credentials, staging deployment logs, backup rollback, and database table selection during staging workflows.
Tool | Description |
POST /Sync/app | Synchronize data between live and staging applications. |
POST /sync/app | Synchronize data between live and staging applications. |
POST /staging/auth/status | Retrieve or update staging authentication status. |
POST /staging/htaccessUpdate | Update htaccess authentication credentials for a staging application. |
POST /staging/app/logs | Retrieve staging application deployment logs. |
POST /staging/app/backupRollBack | Roll back a staging backup action. |
POST /staging/app/deleteBackup | Delete a local backup created during staging. |
GET /staging/App/Tables | Retrieve database tables for staging sync selection or exclusion. |
Monitor / Analytics API
These tools are used to retrieve server and application monitoring information, traffic analytics, PHP performance data, MySQL performance data, and cron execution analytics.
Tool | Description |
GET /server/monitor/summary | Retrieve server monitoring summary. |
GET /server/monitor/detail | Retrieve server monitoring graph details. |
GET /server/usage | Refresh or retrieve server usage statistics. |
GET /app/monitor/summary | Retrieve application disk usage summary. |
GET /app/monitor/detail | Retrieve application disk usage graph details. |
GET /analytics/app/traffic | Retrieve application traffic analytics. |
GET /analytics/app/trafficDetail | Retrieve detailed traffic data for a custom range. |
GET /analytics/app/php | Retrieve PHP performance analytics. |
GET /analytics/app/mysql | Retrieve MySQL performance analytics. |
GET /analytics/app/cron | Retrieve cron execution analytics. |
Team Member API
These tools are used to manage Cloudways team members through the API.
Tool | Description |
GET /team-member | Retrieve the list of team members. |
POST /team-member | Add a new team member. |
PUT /team-member/{id} | Update a team member’s details or permissions. |
DELETE /team-member/{id} | Delete a team member from the account. |
Copilot API
These tools are part of the expanded Cloudways API v2 surface. They are used to manage Copilot subscriptions, configure Copilot settings, and access infrastructure insights or alerts. Cloudways announced API v2 with expanded coverage for Copilot, Security Suite, Cloudflare, billing/reporting, application stack, and scaling workflows.
Tool | Description |
GET /copilot/subscription | Retrieve Copilot subscription details. |
POST /copilot/subscription | Subscribe to or activate Copilot. |
PUT /copilot/subscription | Update Copilot subscription settings or plan. |
DELETE /copilot/subscription | Cancel or disable a Copilot subscription. |
GET /copilot/settings | Retrieve Copilot settings. |
PUT /copilot/settings | Update Copilot settings. |
GET /copilot/insights | Retrieve Copilot insights, alerts, and recommendations. |
GET /copilot/usage | Retrieve Copilot usage information. |
Security Suite API
These tools are part of the expanded API v2 security coverage. They are used for server-level and application-level security workflows, such as scans, incidents, quarantine, firewall settings, allowlists, blocklists, and event logs.
Tool | Description |
GET /security-suite/server/incidents | Retrieve server-level security incidents. |
GET /security-suite/server/firewall | Retrieve server firewall settings. |
PUT /security-suite/server/firewall | Update server firewall settings. |
GET /security-suite/server/ip-allowlist | Retrieve server IP allowlist. |
PUT /security-suite/server/ip-allowlist | Update server IP allowlist. |
GET /security-suite/server/ip-blocklist | Retrieve server IP blocklist. |
PUT /security-suite/server/ip-blocklist | Update server IP blocklist. |
GET /security-suite/server/country-blocklist | Retrieve country-level blocklist settings. |
PUT /security-suite/server/country-blocklist | Update country-level blocklist settings. |
POST /security-suite/app/scan | Start an application security scan. |
GET /security-suite/app/scan | Retrieve application scan results. |
GET /security-suite/app/incidents | Retrieve application security incidents. |
GET /security-suite/app/quarantine | Retrieve quarantined files. |
POST /security-suite/app/quarantine/restore | Restore a quarantined file. |
GET /security-suite/app/files | Retrieve file-level security details. |
GET /security-suite/app/events | Retrieve application security event logs. |
GET /security-suite/app/ip-allowlist | Retrieve application IP allowlist. |
PUT /security-suite/app/ip-allowlist | Update application IP allowlist. |
GET /security-suite/app/ip-blocklist | Retrieve application IP blocklist. |
PUT /security-suite/app/ip-blocklist | Update application IP blocklist. |
Client Billing & Reporting API
These tools are part of the expanded API v2 billing/reporting coverage. They are intended for client billing, invoices, plans, services, tax rules, and reporting workflows.
Tool | Description |
GET /billing/clients | Retrieve client records. |
POST /billing/clients | Create a new client record. |
GET /billing/clients/{id} | Retrieve details of a specific client. |
PUT /billing/clients/{id} | Update a client record. |
DELETE /billing/clients/{id} | Delete a client record. |
GET /billing/services | Retrieve billing services. |
POST /billing/services | Create a billing service. |
PUT /billing/services/{id} | Update a billing service. |
DELETE /billing/services/{id} | Delete a billing service. |
GET /billing/plans | Retrieve billing plans. |
POST /billing/plans | Create a billing plan. |
PUT /billing/plans/{id} | Update a billing plan. |
DELETE /billing/plans/{id} | Delete a billing plan. |
GET /billing/invoices | Retrieve invoices. |
GET /billing/invoices/{id} | Retrieve details of a specific invoice. |
POST /billing/invoices/{id}/reminder | Send an invoice reminder. |
GET /billing/taxes | Retrieve tax rules or rates. |
POST /billing/taxes | Create a tax rule or rate. |
GET /billing/tax/countries | Retrieve country tax specifications. |
GET /billing/reports | Retrieve billing or client reports. |
How Cloudways MCP Keeps the Context Window Lean
Cloudways MCP supports 240+ tools without loading every tool schema into your MCP client at once. Instead, it uses a meta-tool architecture to keep the context window light and efficient.
When your MCP client connects, it initially sees only 65 tools, including 62 commonly used direct tools for core actions such as server management, application management, add-ons, services, monitoring, DNS Made Easy, and vulnerability checks.
The remaining tools are available dynamically through three meta-tools:
list_available_toolsets — shows all available Cloudways capability areas.
get_toolset_tools — displays the tools and schemas inside a selected toolset.
execute_tool — runs any dynamic tool using the selected toolset, tool name, and required arguments.
This means your AI client can discover and use the right Cloudways tool only when needed, reducing token usage, keeping the context window clean, and still providing access to the full Cloudways API surface.
That’s it! We hope this article was useful.
Need Help?
If you need assistance, feel free to:
Visit the Cloudways Support Center.
Chat with us: Need a Hand > Send us a Message.
Or create a support ticket anytime.
We're here 24/7 to help you!
