Other clients

The American Cloud MCP server works with any client that supports MCP stdio servers. This page covers Windsurf and VS Code, plus the generic configuration that applies to everything else.

In every case you need:

• Node.js 20 or newer
• An American Cloud API key from console.americancloud.com/api-keys — start with a read-only key

Windsurf

Windsurf reads MCP servers from ~/.codeium/windsurf/mcp_config.json. Open it from the Cascade panel (MCP icon → Configure) or edit it directly:

{
  "mcpServers": {
    "americancloud": {
      "command": "npx",
      "args": ["-y", "@americancloud/mcp"],
      "env": {
        "AMERICANCLOUD_API_CLIENT_ID": "your-client-id",
        "AMERICANCLOUD_API_CLIENT_SECRET": "your-client-secret"
      }
    }
  }
}

Refresh the MCP server list in Cascade (or restart Windsurf), then ask:

What regions can I deploy to on American Cloud?

VS Code

VS Code configures MCP servers for agent mode in .vscode/mcp.json (workspace) or your user profile. VS Code uses a servers key and supports prompted inputs, so you never write secrets into the file:

{
  "inputs": [
    {
      "type": "promptString",
      "id": "ac-client-id",
      "description": "American Cloud API client ID"
    },
    {
      "type": "promptString",
      "id": "ac-client-secret",
      "description": "American Cloud API client secret",
      "password": true
    }
  ],
  "servers": {
    "americancloud": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@americancloud/mcp"],
      "env": {
        "AMERICANCLOUD_API_CLIENT_ID": "${input:ac-client-id}",
        "AMERICANCLOUD_API_CLIENT_SECRET": "${input:ac-client-secret}"
      }
    }
  }
}

VS Code prompts for both values the first time the server starts and stores them securely. Start the server from the MCP view (or when an agent first uses it), then test with the same regions question in Copilot's agent mode.

Any other MCP client

The server is a standard MCP stdio server. Whatever your client's configuration looks like, the three things it needs are:

Optional flags go after the package name in the arguments — for example --services all or --allow-writes. See the overview for what they do.

Enable resource management (optional)

By default the server is read-only in every client. To enable create/update/delete tools, use a read-write API key and add --allow-writes to the arguments:

"args": ["-y", "@americancloud/mcp", "--allow-writes"]

Destructive operations are flagged, so clients that support confirmations will prompt you before running them.

Next steps

• Things to try — prompt ideas from quick audits to full provisioning
• Overview — service groups, --services scoping, and safety details