Skip to main content

Cloudways MCP Server Tools

Explore the complete list of Cloudways MCP Server tools and their descriptions. Learn how MCP tools help manage servers, applications, services, add-ons, DNS, Cloudflare CDN, monitoring, Git deployment, projects, and SSH keys through AI-assisted commands.

Written by Syed Abuzar Mehdi

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:

We're here 24/7 to help you!

Did this answer your question?