Skip to main content
Glama
American Cloud MCP Server

American Cloud MCP Server

Official

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

https://mcp.americancloud.com/mcp

npx @americancloud/mcp

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 --allow-writes flag.

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.

Claude Code auditing American Cloud infrastructure over the MCP server with a read-only token

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,dns

Group

Tools

Covers

compute (default)

25

VMs, packages, images, regions, SSH keys

storage (default)

27

block storage, snapshots, object storage and its access keys

networking (default)

57

isolated/VPC networks, VPC tiers, public IPs, firewall, port forwarding, load balancers, egress, ACLs

kubernetes (default)

11

managed Kubernetes clusters

databases

36

managed MySQL/PostgreSQL/Redis, backups, infrastructure, offerings

wordpress

16

managed WordPress

dns

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" to args.

  • Secrets need --allow-writes too. Five read tools return a secret: get_kubernetes_cluster_config (the kubeconfig), get_object_storage_keys and list_object_storage_access_keys (S3 keys), get_database_connection (the password, with includePassword) and get_database_backup_repo (S3 keys, with include_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-writes when 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:

Claude Code provisioning a server and deploying to it over the MCP server with --allow-writes — cost shown first, writes run through you

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_vm and runs ssh cloud@<public-ip> itself, with your own key. Before the first VM it registers the host's own public key with create_ssh_key and passes it to create_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's userdata argument.

  • 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

AMERICANCLOUD_API_TOKEN

one credential

API token (Authorization: Bearer amcld_…). Create one at console.americancloud.com/api-tokens.

AMERICANCLOUD_API_CLIENT_ID

legacy

Legacy API key: client ID (X-API-Client-ID). Use with the secret, instead of the token.

AMERICANCLOUD_API_CLIENT_SECRET

legacy

Legacy API key: client secret (X-API-Client-Secret)

AMERICANCLOUD_API_URL

no

API base URL override

Guides

Full documentation on the American Cloud docs site:

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

Apache-2.0 — see LICENSE and NOTICE.

Available Tools

53 tools
get_block_storage_volumeGet block storage volumeA
Read-onlyIdempotent
Inspect

Get one block storage volume by ID: size, region, and attachment state.

Inputs: id (required).

get_cost_estimate_block_storageGet block storage cost estimateA
Read-onlyIdempotent
Inspect

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 estimateA
Read-onlyIdempotent
Inspect

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 estimateA
Read-onlyIdempotent
Inspect

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 estimateA
Read-onlyIdempotent
Inspect

Get the price of a public IP address. Takes no arguments.

Inputs: no named parameters.

get_cost_estimate_snapshotGet snapshot cost estimateA
Read-onlyIdempotent
Inspect

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 estimateA
Read-onlyIdempotent
Inspect

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 estimateA
Read-onlyIdempotent
Inspect

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 ruleA
Read-onlyIdempotent
Inspect

Get one egress rule by ID (from list_egress_rules), including its protocol, ports, and CIDRs.

Inputs: id (required).

get_imageGet imageA
Read-onlyIdempotent
Inspect

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 labelA
Read-onlyIdempotent
Inspect

Get one OS image by its public label (e.g. "ubuntu-24.04-050826").

Inputs: label (required).

get_isolated_networkGet isolated networkA
Read-onlyIdempotent
Inspect

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 clusterA
Read-onlyIdempotent
Inspect

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 listB
Read-onlyIdempotent
Inspect

Get one network ACL list by ID.

Inputs: id (required).

get_network_acl_ruleGet network ACL ruleC
Read-onlyIdempotent
Inspect

Get one network ACL rule by ID.

Inputs: id (required).

get_public_ipGet public IPA
Read-onlyIdempotent
Inspect

Get one public IP by ID, including its NAT configuration.

Inputs: id (required).

get_regionGet regionA
Read-onlyIdempotent
Inspect

Get one region by its UUID (from list_regions), including its label and availability.

Inputs: id (required).

get_region_by_labelGet region by labelA
Read-onlyIdempotent
Inspect

Get one region by its public label (e.g. "us-west-0").

Inputs: label (required).

get_server_infoGet server infoA
Read-onlyIdempotent
Inspect

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 snapshotB
Read-onlyIdempotent
Inspect

Get one snapshot by ID: source volume, type, size, and creation time.

Inputs: id (required).

get_vmGet VMA
Read-onlyIdempotent
Inspect

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 metricsB
Read-onlyIdempotent
Inspect

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 packageA
Read-onlyIdempotent
Inspect

Get one VM package by its UUID, including CPU/memory/disk limits.

Inputs: id (required).

get_vm_package_by_labelGet VM package by labelA
Read-onlyIdempotent
Inspect

Get one VM package by its public label (e.g. "standard-custom"), including CPU/memory/disk limits.

Inputs: label (required).

get_vpc_networkGet VPC networkB
Read-onlyIdempotent
Inspect

Get one VPC network by ID, including its tiers and status.

Inputs: id (required).

get_vpc_tierGet VPC tierA
Read-onlyIdempotent
Inspect

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 snapshotsB
Read-onlyIdempotent
Inspect

List the snapshots taken of a specific block storage volume.

Inputs: id (required), page, pageSize.

list_block_storage_volumesList block storage volumesA
Read-onlyIdempotent
Inspect

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 rulesA
Read-onlyIdempotent
Inspect

List outbound (egress) traffic rules across your isolated networks.

Inputs: page, pageSize.

list_egress_rules_by_networkList egress rules by networkA
Read-onlyIdempotent
Inspect

List the egress rules for a specific isolated network.

Inputs: networkId (required), page, pageSize.

list_firewall_rulesList firewall rulesB
Read-onlyIdempotent
Inspect

List inbound firewall rules on a public IP.

Inputs: ipId (required), page, pageSize.

list_imagesList imagesA
Read-onlyIdempotent
Inspect

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 networksA
Read-onlyIdempotent
Inspect

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 clustersB
Read-onlyIdempotent
Inspect

List the Kubernetes clusters in your account with their IDs, status, version, and node counts.

Inputs: page, pageSize.

list_kubernetes_packagesList Kubernetes packagesA
Read-onlyIdempotent
Inspect

List the available Kubernetes node packages (sizing/pricing tiers) for cluster creation.

Inputs: page, pageSize.

list_kubernetes_versionsList Kubernetes versionsA
Read-onlyIdempotent
Inspect

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 instancesB
Read-onlyIdempotent
Inspect

List the VMs assigned (or assignable) to a load balancer rule.

Inputs: ruleId (required), page, applied, pageSize.

list_load_balancer_rulesList load balancer rulesC
Read-onlyIdempotent
Inspect

List load balancer rules on a public IP.

Inputs: ipId (required), page, pageSize.

list_network_acl_listsList network ACL listsC
Read-onlyIdempotent
Inspect

List network ACL lists, which are applied to VPC tiers.

Inputs: page, pageSize.

list_network_acl_lists_by_vpcList network ACL lists by VPCB
Read-onlyIdempotent
Inspect

List the ACL lists belonging to a specific VPC.

Inputs: vpcId (required), page, pageSize.

list_network_acl_rulesList network ACL rulesC
Read-onlyIdempotent
Inspect

List the rules within a network ACL list.

Inputs: listId (required), page, pageSize.

list_object_storage_bucketsList object storage bucketsC
Read-onlyIdempotent
Inspect

List the buckets within an object storage unit.

Inputs: storageUnitId (required), page, pageSize.

list_object_storage_unitsList object storage unitsA
Read-onlyIdempotent
Inspect

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 rulesB
Read-onlyIdempotent
Inspect

List port forwarding rules on a public IP.

Inputs: ipId (required), page, pageSize.

list_public_ipsList public IPsB
Read-onlyIdempotent
Inspect

List the public IP addresses allocated to your account.

Inputs: page, pageSize.

list_public_ips_by_isolated_networkList public IPs by isolated networkC
Read-onlyIdempotent
Inspect

List the public IPs allocated within a specific isolated network.

Inputs: isolatedNetworkId (required), page, pageSize.

list_public_ips_by_vpcList public IPs by VPCB
Read-onlyIdempotent
Inspect

List the public IPs allocated within a specific VPC.

Inputs: vpcId (required), page, pageSize.

list_regionsList regionsA
Read-onlyIdempotent
Inspect

List the regions where infrastructure can be provisioned. Region labels are required by create_vm and most create tools.

Inputs: page, pageSize.

list_snapshotsList snapshotsB
Read-onlyIdempotent
Inspect

List all volume snapshots in your account with their IDs, source volumes, and types.

Inputs: page, pageSize.

list_ssh_keysList SSH keysA
Read-onlyIdempotent
Inspect

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 packagesA
Read-onlyIdempotent
Inspect

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 VMsA
Read-onlyIdempotent
Inspect

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 networksB
Read-onlyIdempotent
Inspect

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

    B3.3/5.0

    Scored across 53 tools

    Disambiguation4/5

    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.

    Naming Consistency5/5

    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.

    Tool Count2/5

    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.

    Completeness2/5

    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

    ActivityMaintained
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      B
      quality
      C
      maintenance
      MCP 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.
      57
      309 npm
      4
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      An 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 npm
      1
      MIT
    • A
      license
      A
      quality
      C
      maintenance
      Enables 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.
      14
      MIT