Cloudforge README

CloudForge MCP Server

MCP server for CloudForge — lets Claude and other AI assistants visualise cloud architecture diagrams, generate Terraform HCL, import existing IaC, and manage your infrastructure resources directly from chat.

Tools

Visualisation

Terraform

AI Architect

Mold Library

Diagram Management

Organisation

Pricing

Deploy

Real infrastructure changes. apply and destroy stop at a human approval gate and change nothing until cloudforge_approve_deployment is called, so an agent cannot deploy on its own.

Quality & cost

Drift & compliance

Self-healing — detect, approve, heal

Three steps, always in that order. There is deliberately no tool that approves a fix: approval means a person read what would change and consented to it, and a tool that let an assistant grant that consent on their behalf would remove the only guarantee the feature offers. Detect and report freely; the user approves in the CloudForge panel, the VS Code extension or the JetBrains tool window; then heal.

Governance

Shared work

Setup

Claude Desktop (recommended)

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "cloudforge": {
      "command": "npx",
      "args": ["-y", "cloudforge-mcp"],
      "env": {
        "CLOUDFORGE_TOKEN": "your-bearer-token"
      }
    }
  }
}

Claude Code / .mcp.json

{
  "mcpServers": {
    "cloudforge": {
      "command": "npx",
      "args": ["-y", "cloudforge-mcp"],
      "env": {
        "CLOUDFORGE_TOKEN": "your-bearer-token"
      }
    }
  }
}

Authentication

1. Sign in at cloudforge.cloud
2. Go to Account → API Keys
3. Click Generate API Key, give it a name (e.g. CloudForge MCP), and copy the key — it starts with cf_live_ and is shown only once
4. Set it as CLOUDFORGE_TOKEN in your MCP config

The key is long-lived and can be revoked from the same page at any time.

Environment Variables

Example prompts

Show me my recent diagrams

What serverless Molds do you have for AWS?

Show me the azure-3-tier-web-app Mold and explain why it's shaped that way

Render diagram <id> as a Mermaid chart

Generate Terraform for a 3-tier Azure web app with a private SQL database in UK South

Import this Terraform and show me a diagram: <paste HCL>

What are the security best practices for the resources in diagram <id>?

Invite john@example.com as a Member to my organisation

Pricing

The cloudforge_get_pricing tool returns CloudForge's current plans live (so they're always up to date). All prices USD; paid plans include a 14-day free trial:

Full details: cloudforge.cloud/pricing.

Self-hosting

If you run CloudForge on-premises, point the server at your own API:

"env": {
  "CLOUDFORGE_API_URL": "https://your-cloudforge-host/api",
  "CLOUDFORGE_TOKEN": "your-token"
}

License

MIT © CloudForge