American Cloud — Claude Code MCP server: features and setup
This MCP server for Claude Code lets an AI assistant manage American Cloud infrastructure. It handles requests involving VMs, Kubernetes, databases, storage, networks, and DNS.
Apache-2.0 ★ 1 updated 2026-11-12
claude mcp add --transport http mcp https://mcp.americancloud.com/mcpWhat American Cloud does
The server gives an AI assistant tools for American Cloud infrastructure, including virtual machines, Kubernetes, databases, storage, networking, and DNS. It exposes 179 tools. Read operations are enabled by default; changes require the --allow-writes flag.
Connect to the hosted server by signing in with an American Cloud account, or run the local package with npx @americancloud/mcp. The local option needs an API token in AMERICANCLOUD_API_TOKEN; a legacy credential pair can be used instead: AMERICANCLOUD_API_CLIENT_ID and AMERICANCLOUD_API_CLIENT_SECRET. Creating resources can incur charges, and the server displays the cost and waits for approval before creation.
The tools manage cloud resources but do not run shell commands inside a VM. For shell access, an assistant needs the VM’s public IP and an SSH key. A new VM can also receive a cloud-init script through userdata.
What it helps with
- inspect virtual machines and view cost estimates
- create and configure managed Kubernetes clusters
- manage networks, public IPs, and firewall rules
- work with databases and their backups
- add DNS zones and records
Example prompts for the agent
- List the virtual machines in my American Cloud account and show their cost estimates.
- Create a Kubernetes cluster in American Cloud, then wait for my approval.
- Show my American Cloud DNS zones and add a record for the domain.
How to install American Cloud
1Platform CLI: remote server
claude mcp add --transport http mcp https://mcp.americancloud.com/mcp2Platform CLI
claude mcp add --env AMERICANCLOUD_API_TOKEN=<AMERICANCLOUD_API_TOKEN> --transport stdio american-cloud -- npx -y @americancloud/mcpReplace <…> with your own values
1Platform CLI: remote server
codex mcp add american-cloud --url https://mcp.americancloud.com/mcp2Platform CLI
codex mcp add american-cloud --env AMERICANCLOUD_API_TOKEN=<AMERICANCLOUD_API_TOKEN> -- npx -y @americancloud/mcpReplace <…> with your own values
Config file
{
"mcpServers": {
"american-cloud": {
"url": "https://mcp.americancloud.com/mcp"
}
}
}{
"mcpServers": {
"american-cloud": {
"command": "npx",
"args": [
"-y",
"@americancloud/mcp"
],
"env": {
"AMERICANCLOUD_API_TOKEN": "<AMERICANCLOUD_API_TOKEN>"
}
}
}
}Replace <…> with your own values
Config file
{
"servers": {
"american-cloud": {
"type": "http",
"url": "https://mcp.americancloud.com/mcp"
}
}
}{
"servers": {
"american-cloud": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@americancloud/mcp"
],
"env": {
"AMERICANCLOUD_API_TOKEN": "<AMERICANCLOUD_API_TOKEN>"
}
}
}
}Replace <…> with your own values
1Platform CLI: remote server
gemini mcp add -t http american-cloud https://mcp.americancloud.com/mcp2Platform CLI
gemini mcp add -e AMERICANCLOUD_API_TOKEN=<AMERICANCLOUD_API_TOKEN> american-cloud npx -y @americancloud/mcpReplace <…> with your own values
Step by step, with commands for each platform: How to add an MCP server to Claude Code, Codex, Cursor, VS Code, Gemini CLI and more
Questions about American Cloud
How do I install American Cloud in Claude Code?
For the hosted server, run claude mcp add --transport http american-cloud https://mcp.americancloud.com/mcp. To connect locally with an API token, run claude mcp add --env AMERICANCLOUD_API_TOKEN=<AMERICANCLOUD_API_TOKEN> --transport stdio american-cloud -- npx -y @americancloud/mcp.
What does American Cloud do?
This MCP server gives an AI assistant tools to manage American Cloud infrastructure, including VMs, Kubernetes, networks, storage, databases, and DNS. Read operations are available by default.
What does American Cloud need to run?
The hosted server requires an American Cloud account. The local server needs AMERICANCLOUD_API_TOKEN, or the pair AMERICANCLOUD_API_CLIENT_ID and AMERICANCLOUD_API_CLIENT_SECRET.