CloudForge MCP Server

npm version License: MIT

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

Tool	Description
`cloudforge_diagram_to_mermaid`	Fetch a saved diagram and render it as an inline Mermaid flowchart
`cloudforge_architecture_summary`	Structured summary: resource counts by category, central components, inline diagram
`cloudforge_mermaid_from_json`	Convert raw diagram JSON to Mermaid without fetching from the server

Terraform

Tool	Description
`cloudforge_generate_terraform`	Generate Terraform HCL from a natural-language architecture description
`cloudforge_export_terraform_from_diagram`	Export Terraform HCL from an existing saved diagram in one step
`cloudforge_import_terraform`	Parse existing HCL → diagram structure + Mermaid preview

AI Architect

Tool	Description
`cloudforge_chat`	Ask the CloudForge AI Architect for IaC advice, cost estimates, security reviews
`cloudforge_suggest_resources`	Get AI-recommended resources and connections for a described use case

Mold Library

Tool	Description
`cloudforge_list_molds`	Browse 90 curated architecture templates (30 per cloud) — filter by provider, category, or search
`cloudforge_get_mold`	Full detail for one Mold: layout, "why this shape" best practices, inline Mermaid preview, forge link

Diagram Management

Tool	Description
`cloudforge_list_diagrams`	List saved diagrams with metadata
`cloudforge_recent_diagrams`	Get recently accessed/modified diagrams
`cloudforge_get_diagram`	Fetch a diagram by ID (full JSON)
`cloudforge_save_diagram`	Save or update a diagram
`cloudforge_delete_diagram`	Permanently delete a diagram

Organisation

Tool	Description
`cloudforge_org_details`	Organisation overview: name, plan, member count, MFA policy, custom assistant name
`cloudforge_list_members`	List organisation members (name, email, role, status)
`cloudforge_invite_member`	Send an organisation invitation
`cloudforge_list_invitations`	List pending invitations
`cloudforge_cancel_invitation`	Cancel a pending invitation
`cloudforge_remove_member`	Remove a member from the organisation

Pricing

Tool	Description
`cloudforge_get_pricing`	Get CloudForge's current plans & pricing (Free, Pro, Team, Business), incl. the 14-day free trial — fetched live

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

Sign in at cloudforge.cloud
Go to Account → API Keys
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
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

Variable	Default	Description
`CLOUDFORGE_TOKEN`	(required)	CloudForge API key — must start with `cf_live_`
`CLOUDFORGE_API_URL`	`https://cloudforge.cloud/api`	API base URL — only change if self-hosting

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:

Plan	Price
Free	$0 — visual designer, limited export, community support
Pro	US$9.99/mo or US$99/yr · 14-day free trial
Team	US$12/user/mo (3-seat min) · 14-day free trial
Business	Contact us — volume/annual pricing

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"
}