American Cloud MCP Server
OfficialOne-line summary: This is the read-only surface of the American Cloud MCP server — inspect and audit your cloud account (compute, storage, networking, Kubernetes) and get cost estimates, without changing anything.
Server introspection —
get_server_inforeports version, pinned SDK, API endpoint, enabled service groups, and read-only status.Compute (VMs) — list/get VMs, view status, specs, IPs, networks, images; fetch CPU/memory/network/disk metrics over a time window.
Compute catalogs — browse VM packages (by UUID or label), OS images (by UUID or label, filterable by OS/version), regions, and registered SSH keys.
Block storage — list/get volumes (optionally filtered by VM), list snapshots per volume or account-wide, get snapshot details.
Object storage — list S3-compatible storage units (with optional usage), list buckets per unit, list access keys and retrieve a unit's original S3 key pair (secrets — handle as sensitive).
Kubernetes — list versions (optionally valid upgrade targets), node packages, and clusters; get cluster details and fetch a cluster's kubeconfig (sensitive).
Networking — isolated networks, VPCs and their tiers, public IPs (account-wide or by isolated network/VPC), firewall rules, port forwarding rules, load balancer rules and instances, egress rules, and network ACL lists/rules.
Cost estimation — hourly/monthly price previews for VMs, block storage volumes, snapshots, VPCs, and Kubernetes clusters, plus object storage metered pricing and public IP pricing.
Not available here — no create, update, resize, stop, or delete tools, and no in-VM command execution; enabling management requires the
--allow-writesflag (and a token with write permissions).
Provides tools for managing American Cloud managed Kubernetes clusters, including retrieving cluster configuration and related lifecycle operations.
Provides tools for managing American Cloud managed MySQL databases, including backups, infrastructure, and offerings.
Provides tools for managing American Cloud managed PostgreSQL databases, including backups, infrastructure, and offerings.
Provides tools for managing American Cloud managed Redis databases, including backups, infrastructure, and offerings.
Provides tools for managing American Cloud managed WordPress instances.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
American Cloud MCP Server
Manage American Cloud infrastructure from Claude, ChatGPT, Grok, Cursor, Codex, and any other MCP client: 179 tools across compute, storage, networking, Kubernetes, databases, WordPress, and DNS.
There are two ways to connect:
Hosted server | Local server (this package) | |
Address |
|
|
Sign in | Your American Cloud account, through the client's connector or MCP settings. No install, no token. | An API token in the client configuration. Runs on your machine over stdio. |
Permissions | Set per app in Connected apps in the dashboard: Read-only, Full access, or Custom. Change them at any time; the app picks up the change on its next request. | The token's preset, plus the |
Best for | Claude on the web, Claude Desktop, Claude Code, ChatGPT, Grok, Cursor, Codex | Windsurf, VS Code, other stdio clients, scripts and CI |
The hosted server needs no setup beyond a sign-in: follow the guide for your client under Guides. The rest of this README covers the local server.

Quick start
Add to your MCP client configuration (Claude Desktop, Claude Code, Cursor, …):
{
"mcpServers": {
"americancloud": {
"command": "npx",
"args": ["-y", "@americancloud/mcp"],
"env": {
"AMERICANCLOUD_API_TOKEN": "amcld_…"
}
}
}
}Create and manage API tokens at
console.americancloud.com/api-tokens.
A token has the same presets as a connected app: Read-only, Full
access, or Custom. A legacy API key (client ID and secret) still works:
set AMERICANCLOUD_API_CLIENT_ID and AMERICANCLOUD_API_CLIENT_SECRET instead
of the token.
The server is read-only by default — see Safety before enabling resource management.
Related MCP server: Akamai Cloud MCP Server
Service groups
By default the core infrastructure groups are enabled: compute, storage,
networking, kubernetes. Scope or extend with --services:
npx @americancloud/mcp --services all
npx @americancloud/mcp --services compute,dnsGroup | Tools | Covers |
| 25 | VMs, packages, images, regions, SSH keys |
| 27 | block storage, snapshots, object storage and its access keys |
| 57 | isolated/VPC networks, VPC tiers, public IPs, firewall, port forwarding, load balancers, egress, ACLs |
| 11 | managed Kubernetes clusters |
| 36 | managed MySQL/PostgreSQL/Redis, backups, infrastructure, offerings |
| 16 | managed WordPress |
| 7 | hosted DNS zones and records |
Scoping with --services keeps the tool list small for context-sensitive
clients.
Safety
This server lets an AI assistant manage real infrastructure with real billing. It's designed to be safe by default:
Read-only by default. Out of the box, only read tools (list/get/cost estimates) are registered — an assistant can explore and inspect but cannot create, modify, or delete anything. To enable management tools, add
"--allow-writes"toargs.Secrets need
--allow-writestoo. Five read tools return a secret:get_kubernetes_cluster_config(the kubeconfig),get_object_storage_keysandlist_object_storage_access_keys(S3 keys),get_database_connection(the password, withincludePassword) andget_database_backup_repo(S3 keys, withinclude_credentials). They don't change anything, but the API requires the manage permission for them, so the read-only default doesn't register them. They appear with--allow-writes.Use the narrowest token. For inspection, create a token with the Read-only preset — then resource mutation and secret reads are impossible regardless of any flag, because the token itself can't perform them. Only use a token with Full access together with
--allow-writeswhen you actually want the assistant to make changes or read a secret.Changes are flagged. Every write tool that changes or removes something that already exists (update, replace, stop, detach, resize, delete, and so on) is marked destructive, so MCP clients that support confirmations will prompt before running it. Only tools that add something new are not. Tools that cause irreversible loss (delete, release, reinstall, revert, cancel) also start their description with ⚠️ DESTRUCTIVE.
No automatic retries. The server sends each API request once. If a create call fails with a server error, check with the matching list or get tool before you try again, so you do not create the resource twice.
// management-enabled (Full access token + opt-in flag):
"args": ["-y", "@americancloud/mcp", "--allow-writes"]With writes enabled, the assistant can provision and deploy — and it still shows you the cost and waits for approval before creating anything:

Inside a VM
The tools manage your account: they create, change, power, resize and delete resources. No tool runs a command inside a VM, and the server stores no key or password for your machines. In-VM work takes one of these paths:
A client with a shell (Claude Code, Codex, Cursor) gets the public IP from
get_vmand runsssh cloud@<public-ip>itself, with your own key. Before the first VM it registers the host's own public key withcreate_ssh_keyand passes it tocreate_vm, so it logs in with the key it already has.A new VM can configure itself on first boot with a cloud-init script in
create_vm'suserdataargument.A running VM without SSH gets a browser console from
create_vm_console, for you to use.
A chat client without a shell (Claude.ai, ChatGPT, Grok) can do the second and third, not the first. The server tells the assistant this in its instructions, so it says so instead of guessing.
Environment
Variable | Required | Purpose |
| one credential | API token ( |
| legacy | Legacy API key: client ID ( |
| legacy | Legacy API key: client secret ( |
| no | API base URL override |
Guides
Full documentation on the American Cloud docs site:
MCP server overview — hosted and local servers, permissions, safety, and service groups
Client setup, hosted and local: Claude Code · Claude.ai and Claude Desktop · ChatGPT · Grok · Cursor · Codex · other clients
Things to try — prompt ideas across compute, storage, networking, and DNS
Deploy with AI — migration playbooks and deployment recipes built on this server
Versioning
See VERSIONING.md — the server versions independently;
the exact-pinned @americancloud/sdk dependency states the API surface it
targets.
Contributing
This server is generated and maintained in lockstep with the American Cloud
SDK and API — see CONTRIBUTING.md for how to report
issues or propose changes.
License
Available Tools
53 toolsget_block_storage_volumeGet block storage volumeARead-onlyIdempotentInspect
Get one block storage volume by ID: size, region, and attachment state.
Inputs: id (required).
get_cost_estimate_block_storageGet block storage cost estimateARead-onlyIdempotentInspect
Preview the price of a block storage volume configuration without creating it. Takes the same arguments as create_block_storage_volume.
Inputs: name (required), region (required), sizeGb (required).
get_cost_estimate_kubernetesGet Kubernetes cost estimateARead-onlyIdempotentInspect
Preview the price of a Kubernetes cluster configuration without creating it. Takes the same arguments as create_kubernetes_cluster.
Inputs: name (required), region (required), version (required), workerNodes (required), +7 more.
get_cost_estimate_object_storageGet object storage cost estimateARead-onlyIdempotentInspect
Get the metered pricing for object storage (per-GB rate and minimums). Takes no arguments — object storage is billed by actual usage.
Inputs: no named parameters.
get_cost_estimate_public_ipGet public IP cost estimateARead-onlyIdempotentInspect
Get the price of a public IP address. Takes no arguments.
Inputs: no named parameters.
get_cost_estimate_snapshotGet snapshot cost estimateARead-onlyIdempotentInspect
Preview the price of a snapshot without creating it. Takes the same arguments as create_snapshot.
Inputs: name (required), type (required), volumeId (required).
get_cost_estimate_vmGet VM cost estimateARead-onlyIdempotentInspect
Preview the price of a VM configuration without creating anything. Takes the same arguments as create_vm and returns hourly/monthly cost breakdowns — use this before create_vm when cost matters.
Inputs: name (required), image (required), region (required), vmSpecs (required), +7 more.
get_cost_estimate_vpc_networkGet VPC cost estimateARead-onlyIdempotentInspect
Preview the price of a VPC configuration without creating it. Same arguments as create_vpc_network.
Inputs: cidr (required), name (required), region (required), description.
get_egress_ruleGet egress ruleARead-onlyIdempotentInspect
Get one egress rule by ID (from list_egress_rules), including its protocol, ports, and CIDRs.
Inputs: id (required).
get_imageGet imageARead-onlyIdempotentInspect
Get one OS image by its UUID (from list_images), including its label and OS details.
Inputs: id (required).
get_image_by_labelGet image by labelARead-onlyIdempotentInspect
Get one OS image by its public label (e.g. "ubuntu-24.04-050826").
Inputs: label (required).
get_isolated_networkGet isolated networkARead-onlyIdempotentInspect
Get one standalone isolated network by ID, including its CIDR and status. If the ID belongs to a VPC tier subnet (e.g. from a VM in a VPC), use get_vpc_tier instead.
Inputs: id (required).
get_kubernetes_clusterGet Kubernetes clusterARead-onlyIdempotentInspect
Get one Kubernetes cluster by ID. Pass details=true for full node and status information.
Inputs: id (required), details.
get_network_acl_listGet network ACL listBRead-onlyIdempotentInspect
Get one network ACL list by ID.
Inputs: id (required).
get_network_acl_ruleGet network ACL ruleCRead-onlyIdempotentInspect
Get one network ACL rule by ID.
Inputs: id (required).
get_public_ipGet public IPARead-onlyIdempotentInspect
Get one public IP by ID, including its NAT configuration.
Inputs: id (required).
get_regionGet regionARead-onlyIdempotentInspect
Get one region by its UUID (from list_regions), including its label and availability.
Inputs: id (required).
get_region_by_labelGet region by labelARead-onlyIdempotentInspect
Get one region by its public label (e.g. "us-west-0").
Inputs: label (required).
get_server_infoGet server infoARead-onlyIdempotentInspect
Describe this American Cloud MCP server: version, pinned SDK version, API endpoint, the kind of credential in use, enabled service groups, and whether it is running in read-only mode. Useful to confirm configuration before managing resources.
Inputs: no named parameters.
get_snapshotGet snapshotBRead-onlyIdempotentInspect
Get one snapshot by ID: source volume, type, size, and creation time.
Inputs: id (required).
get_vmGet VMARead-onlyIdempotentInspect
Get one virtual machine by ID: status, specs, IP address, network, and image details. The ipAddress is the private address on the VM's network; the public IP comes from list_public_ips_by_isolated_network or list_public_ips_by_vpc for that network. To connect over SSH, log in at the public IP as the default user cloud, unless the user names a different one.
Inputs: id (required).
get_vm_metricsGet VM metricsBRead-onlyIdempotentInspect
Get CPU, memory, network, and disk usage metrics for a VM over the last N hours.
Inputs: id (required), hours (required), sample_period.
get_vm_packageGet VM packageARead-onlyIdempotentInspect
Get one VM package by its UUID, including CPU/memory/disk limits.
Inputs: id (required).
get_vm_package_by_labelGet VM package by labelARead-onlyIdempotentInspect
Get one VM package by its public label (e.g. "standard-custom"), including CPU/memory/disk limits.
Inputs: label (required).
get_vpc_networkGet VPC networkBRead-onlyIdempotentInspect
Get one VPC network by ID, including its tiers and status.
Inputs: id (required).
get_vpc_tierGet VPC tierARead-onlyIdempotentInspect
Get one tier (subnet) of a VPC, including its CIDR, gateway, ACL, status, and creation date. Use the tier IDs from get_vpc_network.
Inputs: id (required), tierId (required).
list_block_storage_snapshotsList block storage snapshotsBRead-onlyIdempotentInspect
List the snapshots taken of a specific block storage volume.
Inputs: id (required), page, pageSize.
list_block_storage_volumesList block storage volumesARead-onlyIdempotentInspect
List block storage volumes in your account, optionally filtered to a VM. Returns IDs, sizes, regions, and attachment state.
Inputs: page, vmId, pageSize.
list_egress_rulesList egress rulesARead-onlyIdempotentInspect
List outbound (egress) traffic rules across your isolated networks.
Inputs: page, pageSize.
list_egress_rules_by_networkList egress rules by networkARead-onlyIdempotentInspect
List the egress rules for a specific isolated network.
Inputs: networkId (required), page, pageSize.
list_firewall_rulesList firewall rulesBRead-onlyIdempotentInspect
List inbound firewall rules on a public IP.
Inputs: ipId (required), page, pageSize.
list_imagesList imagesARead-onlyIdempotentInspect
List the operating system images available for VM creation, optionally filtered by OS and version. Image labels are required by create_vm and reinstall_vm.
Inputs: os, page, version, pageSize.
list_isolated_networksList isolated networksARead-onlyIdempotentInspect
List standalone isolated (single-tier private) networks in your account. VPC tier subnets are listed separately via get_vpc_network.
Inputs: page, pageSize.
list_kubernetes_clustersList Kubernetes clustersBRead-onlyIdempotentInspect
List the Kubernetes clusters in your account with their IDs, status, version, and node counts.
Inputs: page, pageSize.
list_kubernetes_packagesList Kubernetes packagesARead-onlyIdempotentInspect
List the available Kubernetes node packages (sizing/pricing tiers) for cluster creation.
Inputs: page, pageSize.
list_kubernetes_versionsList Kubernetes versionsARead-onlyIdempotentInspect
List the available Kubernetes versions. Pass current_version to get only valid upgrade targets from a running cluster's version.
Inputs: page, pageSize, current_version.
list_load_balancer_instancesList load balancer instancesBRead-onlyIdempotentInspect
List the VMs assigned (or assignable) to a load balancer rule.
Inputs: ruleId (required), page, applied, pageSize.
list_load_balancer_rulesList load balancer rulesCRead-onlyIdempotentInspect
List load balancer rules on a public IP.
Inputs: ipId (required), page, pageSize.
list_network_acl_listsList network ACL listsCRead-onlyIdempotentInspect
List network ACL lists, which are applied to VPC tiers.
Inputs: page, pageSize.
list_network_acl_lists_by_vpcList network ACL lists by VPCBRead-onlyIdempotentInspect
List the ACL lists belonging to a specific VPC.
Inputs: vpcId (required), page, pageSize.
list_network_acl_rulesList network ACL rulesCRead-onlyIdempotentInspect
List the rules within a network ACL list.
Inputs: listId (required), page, pageSize.
list_object_storage_bucketsList object storage bucketsCRead-onlyIdempotentInspect
List the buckets within an object storage unit.
Inputs: storageUnitId (required), page, pageSize.
list_object_storage_unitsList object storage unitsARead-onlyIdempotentInspect
List your S3-compatible object storage units, optionally with usage figures. A unit contains buckets and has its own access keys. A null maxBuckets or limitKb means unlimited.
Inputs: page, usage, pageSize.
list_port_forwarding_rulesList port forwarding rulesBRead-onlyIdempotentInspect
List port forwarding rules on a public IP.
Inputs: ipId (required), page, pageSize.
list_public_ipsList public IPsBRead-onlyIdempotentInspect
List the public IP addresses allocated to your account.
Inputs: page, pageSize.
list_public_ips_by_isolated_networkList public IPs by isolated networkCRead-onlyIdempotentInspect
List the public IPs allocated within a specific isolated network.
Inputs: isolatedNetworkId (required), page, pageSize.
list_public_ips_by_vpcList public IPs by VPCBRead-onlyIdempotentInspect
List the public IPs allocated within a specific VPC.
Inputs: vpcId (required), page, pageSize.
list_regionsList regionsARead-onlyIdempotentInspect
List the regions where infrastructure can be provisioned. Region labels are required by create_vm and most create tools.
Inputs: page, pageSize.
list_snapshotsList snapshotsBRead-onlyIdempotentInspect
List all volume snapshots in your account with their IDs, source volumes, and types.
Inputs: page, pageSize.
list_ssh_keysList SSH keysARead-onlyIdempotentInspect
List the SSH key pairs registered in your account. Key names are used by create_vm's keypairs argument.
Inputs: page, pageSize.
list_vm_packagesList VM packagesARead-onlyIdempotentInspect
List the available VM packages (compute tiers) with their labels, CPU/memory/disk limits, and zones. Package labels are required by create_vm and get_cost_estimate_vm.
Inputs: page, pageSize.
list_vmsList VMsARead-onlyIdempotentInspect
List the virtual machines in your American Cloud account, one page at a time, with their IDs, names, status, region, and IP addresses.
Inputs: page, pageSize.
list_vpc_networksList VPC networksBRead-onlyIdempotentInspect
List Virtual Private Cloud networks, which contain multiple tier subnets.
Inputs: page, pageSize.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 53 tools
Most tools target clearly distinct resources and actions, with scoped list variants (by VPC, by isolated network) and ID-vs-label lookups clarified in descriptions. A few pairs overlap conceptually, such as list_snapshots vs list_block_storage_snapshots and the various list_public_ips variants, but the descriptions make the boundaries understandable.
Tool names consistently use snake_case verb_noun patterns: list_*, get_*, and get_cost_estimate_* followed by the resource. Variants such as *_by_label, *_by_vpc, and *_by_isolated_network are applied predictably across resource groups.
The domain is broad, but 53 tools is too large for a single MCP surface and creates a heavy selection burden for an agent. Many tools are read-only list/get variants, so the count feels over-scoped rather than each tool being essential.
The server provides extensive read-only inspection and cost-estimation coverage, but there are no create, update, delete, or lifecycle action tools despite descriptions referencing create_vm, create_snapshot, create_vpc_network, reinstall_vm, and similar operations. This leaves major gaps for actual cloud resource management.
Maintenance
Related MCP Connectors
Talk to your public-facing AI from any MCP client — Claude, ChatGPT, Cursor, Cline, Windsurf.
Hosted SQL Server MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Hosted MCP for Celesto cloud computers: create, exec, ports, start/stop/delete.
Unified API to query AWS, GCP, Azure and generate Terraform/CLI execution kits for AI agents.
Related MCP Servers
- AlicenseBqualityCmaintenanceMCP Server for full Easypanel control via Claude Code, Cursor, and Claude Desktop. Provides 37 tools for deploy, logs, env vars, domains, databases, and monitoring with built-in safety guards.57309 npm4MIT
- AlicenseAqualityDmaintenanceA read-only MCP server for Akamai Cloud (Linode) that lets users ask plain-language questions about their account, including inventory, pricing, GPU availability, and account limits.3773 PyPI2Apache 2.0
- AlicenseNot gradedqualityDmaintenanceAn MCP server for Kvindo Cloud that lets AI clients list, inspect, create, update, and delete cloud resources (VMs, volumes, Kubernetes, etc.) via natural language. Read-only by default, with write/delete operations gated by explicit opt-in environment variables.13 npm1MIT
- AlicenseAqualityCmaintenanceEnables MCP-compatible clients like Claude Desktop, Claude Code, Codex, and local-model hosts to inspect Proxmox VE clusters, nodes, VMs, containers, storage, snapshots, and tasks, with opt-in write operations for starting, stopping, cloning, backing up, and migrating guests. Read-only by default, it supports both stdio and Streamable HTTP transports.14MIT