# Cloudcraft MCP

> Cloudcraft MCP is a free MCP server for cloud and infrastructure. Unofficial server to list, export and build Cloudcraft cloud architecture blueprints. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Free
- **Platforms:** CLI, self-hosted, macOS, Linux, Windows
- **Repository:** https://github.com/hypark5540/cloudcraft-mcp
- **MCP Registry name:** io.github.hypark5540/cloudcraft-mcp
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-18

## About

This community-built server wraps the Cloudcraft API so an assistant can work with cloud architecture diagrams. It is unofficial, uses a Cloudcraft API key from the user settings page, and exposes 13 tools: whoami, list_blueprints, get_blueprint, create_blueprint, update_blueprint, delete_blueprint, export_blueprint_image, export_blueprint_budget, list_teams, list_aws_accounts, snapshot_aws, list_azure_accounts and snapshot_azure.

It is read-only by default. Creating or updating blueprints needs CLOUDCRAFT_ENABLE_WRITES=true, and deletes additionally need CLOUDCRAFT_ENABLE_DELETES=true. Exports of images (PNG, SVG, PDF, mxgraph) and budget sheets (CSV or XLSX) are written only under a configured export directory, and responses above a size cap (about 25 MB by default) are rejected. snapshot_aws and snapshot_azure live-scan one region of a connected cloud account into blueprint JSON, with optional filter and exclude settings.

It installs as a pinned PyPI package through uvx or pipx, an npm launcher that still needs uv, a GHCR container image, or a Claude Desktop bundle.

## Features

- **Blueprint CRUD:** List, fetch, create, update and delete blueprints via their JSON.
- **Image export:** Render blueprints to PNG, SVG, PDF or mxgraph on disk.
- **Budget export:** Save cost estimates as CSV or XLSX.
- **AWS and Azure snapshots:** Live-scan a single region into blueprint JSON.
- **Safe defaults:** Writes and deletes are off unless enabled by environment variables.
- **Several install paths:** PyPI, npm, Docker and a Claude Desktop bundle.

## Good for

- Summarise every Cloudcraft blueprint in an account
- Export an architecture diagram as PNG to your desktop
- Snapshot an AWS region and exclude security groups
- Create a blueprint from an architecture an assistant drafted

## Install

### Claude Code (Terminal)

```sh
claude mcp add cloudcraft-mcp --env CLOUDCRAFT_API_KEY='<CLOUDCRAFT_API_KEY>' -- npx -y @hypark5540/cloudcraft-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "cloudcraft-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hypark5540/cloudcraft-mcp"
      ],
      "env": {
        "CLOUDCRAFT_API_KEY": "<CLOUDCRAFT_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "cloudcraft-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hypark5540/cloudcraft-mcp"
      ],
      "env": {
        "CLOUDCRAFT_API_KEY": "<CLOUDCRAFT_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "cloudcraft-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@hypark5540/cloudcraft-mcp"
      ],
      "env": {
        "CLOUDCRAFT_API_KEY": "<CLOUDCRAFT_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "cloudcraft-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hypark5540/cloudcraft-mcp"
      ],
      "env": {
        "CLOUDCRAFT_API_KEY": "<CLOUDCRAFT_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "cloudcraft-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@hypark5540/cloudcraft-mcp"
      ],
      "env": {
        "CLOUDCRAFT_API_KEY": "<CLOUDCRAFT_API_KEY>"
      }
    }
  }
}
```

## Tools

- `whoami`: Return the Cloudcraft user profile for the configured key
- `list_blueprints`: List every blueprint in the account
- `get_blueprint`: Fetch a blueprint's node and edge JSON
- `create_blueprint`: Create a blueprint from a JSON payload
- `update_blueprint`: Replace an existing blueprint's payload
- `delete_blueprint`: Delete a blueprint irreversibly
- `export_blueprint_image`: Render a blueprint to PNG, SVG, PDF or mxgraph
- `export_blueprint_budget`: Export a blueprint's cost estimate as CSV or XLSX
- `list_teams`: List teams linked to the account
- `list_aws_accounts`: List AWS accounts connected for snapshots
- `snapshot_aws`: Live-scan one AWS region into blueprint JSON
- `list_azure_accounts`: List Azure accounts connected for snapshots
- `snapshot_azure`: Live-scan one Azure region into blueprint JSON

## FAQ

### Is it official?

No. The README calls it an unofficial MCP server for Cloudcraft.

### What do I need to run it?

A Cloudcraft API key, plus uv; Node.js 22 or later only for the npm launcher.

### Can it delete my blueprints?

Only if both writes and deletes are enabled through environment variables; both are off by default.

### Which accounts can it scan?

Connected AWS and Azure accounts, one region per snapshot.

### Is Cloudcraft MCP free?

Yes. Cloudcraft MCP is free to use.

### How do I add Cloudcraft MCP to Claude Code?

Run this command in your terminal: claude mcp add cloudcraft-mcp --env CLOUDCRAFT_API_KEY='<CLOUDCRAFT_API_KEY>' -- npx -y @hypark5540/cloudcraft-mcp

### What are the best alternatives to Cloudcraft MCP?

The closest alternatives to Cloudcraft MCP are mcp, Webflow, Ripe Stat, Vercel MCP and OpenWrt MCP.

## Where this comes from

- Description: written from the project's README.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [mcp](https://ai-powered.com/mcp/mcp-mwfu4c84): mcp is an open-source MCP server for cloud and infrastructure.
- [Webflow](https://ai-powered.com/mcp/webflow): Webflow is a freemium MCP server for cloud and infrastructure.
- [Ripe Stat](https://ai-powered.com/mcp/ripe-stat): Ripe Stat is a freemium MCP server for cloud and infrastructure.
- [Vercel MCP](https://ai-powered.com/mcp/vercel-mcp): Vercel MCP is an MCP server for cloud and infrastructure.
- [OpenWrt MCP](https://ai-powered.com/mcp/openwrt-mcp): OpenWrt MCP is an open-source MCP server for cloud and infrastructure.
- [Opendatasoft](https://ai-powered.com/mcp/opendatasoft): Opendatasoft is a freemium MCP server for cloud and infrastructure.
- [Nist Beacon](https://ai-powered.com/mcp/nist-beacon): Nist Beacon is a freemium MCP server for cloud and infrastructure.
- [Gateway SSH](https://ai-powered.com/mcp/gateway-ssh): Gateway SSH is a freemium MCP server for cloud and infrastructure.

---
Source: https://ai-powered.com/mcp/cloudcraft-mcp
