# American Cloud

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.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1 repo stars
- Author: American-Cloud
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/American-Cloud/americancloud-mcp
- Updated: 2026-11-12
- Security check: automated, 2026-11-17 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/american-cloud

## What it 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`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://mcp.americancloud.com/mcp`
- Environment variables: `AMERICANCLOUD_API_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http mcp https://mcp.americancloud.com/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env AMERICANCLOUD_API_TOKEN=<AMERICANCLOUD_API_TOKEN> --transport stdio american-cloud -- npx -y @americancloud/mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add american-cloud --url https://mcp.americancloud.com/mcp
```

2. **Platform CLI**
```bash
codex mcp add american-cloud --env AMERICANCLOUD_API_TOKEN=<AMERICANCLOUD_API_TOKEN> -- npx -y @americancloud/mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "american-cloud": {
            "url": "https://mcp.americancloud.com/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "american-cloud": {
            "command": "npx",
            "args": [
                "-y",
                "@americancloud/mcp"
            ],
            "env": {
                "AMERICANCLOUD_API_TOKEN": "<AMERICANCLOUD_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "american-cloud": {
            "type": "http",
            "url": "https://mcp.americancloud.com/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "american-cloud": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@americancloud/mcp"
            ],
            "env": {
                "AMERICANCLOUD_API_TOKEN": "<AMERICANCLOUD_API_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http american-cloud https://mcp.americancloud.com/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e AMERICANCLOUD_API_TOKEN=<AMERICANCLOUD_API_TOKEN> american-cloud npx -y @americancloud/mcp
```
Replace <…> with your own values

## When to use it
- 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
- 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.

## Similar
- [American Default Research](https://affpapa.org/en/nevibecode/mcp/american-default-research.md) — MCP server · 939 installs
- [cloud-security-scanner](https://affpapa.org/en/nevibecode/mcp/cloud-security-scanner.md) — MCP server · 3008 installs
- [huawei-cloud-find-skills](https://affpapa.org/en/nevibecode/skills/huawei-cloud-find-skills.md) — skill · 19300 installs
- [huawei-cloud-terraform-installer](https://affpapa.org/en/nevibecode/skills/huawei-cloud-terraform-installer.md) — skill · 19100 installs
- [google-cloud-waf-cost-optimization](https://affpapa.org/en/nevibecode/skills/google-cloud-waf-cost-optimization.md) — skill · 14266 installs
- [google-cloud-networking-observability](https://affpapa.org/en/nevibecode/skills/google-cloud-networking-observability.md) — skill · 11856 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
