Cloudcraft MCP
Unofficial server to list, export and build Cloudcraft cloud architecture blueprints
- Pricing
- Free
- Platforms
- CLI, self-hosted, macOS
- Runs
- Locally
- Version
- 0.1.8
- Listing updated
- today
Similar MCP servers
About Cloudcraft MCP
Cloudcraft MCP is a free MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.
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.
Install
Run in a terminal
claude mcp add cloudcraft-mcp --env CLOUDCRAFT_API_KEY='<CLOUDCRAFT_API_KEY>' -- npx -y @hypark5540/cloudcraft-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"cloudcraft-mcp": {
"command": "npx",
"args": [
"-y",
"@hypark5540/cloudcraft-mcp"
],
"env": {
"CLOUDCRAFT_API_KEY": "<CLOUDCRAFT_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"cloudcraft-mcp": {
"command": "npx",
"args": [
"-y",
"@hypark5540/cloudcraft-mcp"
],
"env": {
"CLOUDCRAFT_API_KEY": "<CLOUDCRAFT_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"cloudcraft-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@hypark5540/cloudcraft-mcp"
],
"env": {
"CLOUDCRAFT_API_KEY": "<CLOUDCRAFT_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"cloudcraft-mcp": {
"command": "npx",
"args": [
"-y",
"@hypark5540/cloudcraft-mcp"
],
"env": {
"CLOUDCRAFT_API_KEY": "<CLOUDCRAFT_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"cloudcraft-mcp": {
"command": "npx",
"args": [
"-y",
"@hypark5540/cloudcraft-mcp"
],
"env": {
"CLOUDCRAFT_API_KEY": "<CLOUDCRAFT_API_KEY>"
}
}
}
}Using several servers? Build one config file with the MCP config generator.
Configuration
CLOUDCRAFT_API_KEYCloudcraft API key with access to the target accountRequiredCLOUDCRAFT_BASE_URLCloudcraft API base URL; HTTPS is required except for loopback testingCLOUDCRAFT_LOG_LEVELMinimum log level written to stderrCLOUDCRAFT_EXPORT_DIRDirectory under which exported blueprint files may be writtenCLOUDCRAFT_ENABLE_WRITESEnable create and update operationsCLOUDCRAFT_ENABLE_DELETESEnable irreversible deletes; writes must also be enabledCLOUDCRAFT_MAX_RESPONSE_BYTESMaximum bytes accepted from one Cloudcraft API responseCLOUDCRAFT_API_KEYCloudcraft API key with access to the target accountRequiredCLOUDCRAFT_BASE_URLCloudcraft API base URL; HTTPS is required except for loopback testingCLOUDCRAFT_LOG_LEVELMinimum log level written to stderrCLOUDCRAFT_EXPORT_DIRDirectory under which exported blueprint files may be writtenCLOUDCRAFT_ENABLE_WRITESEnable create and update operationsCLOUDCRAFT_ENABLE_DELETESEnable irreversible deletes; writes must also be enabledCLOUDCRAFT_MAX_RESPONSE_BYTESMaximum bytes accepted from one Cloudcraft API responseCLOUDCRAFT_API_KEYCloudcraft API key with access to the target accountRequiredCLOUDCRAFT_BASE_URLCloudcraft API base URL; HTTPS is required except for loopback testingCLOUDCRAFT_LOG_LEVELMinimum log level written to stderrCLOUDCRAFT_EXPORT_DIRDirectory under which exported blueprint files may be writtenCLOUDCRAFT_ENABLE_WRITESEnable create and update operationsCLOUDCRAFT_ENABLE_DELETESEnable irreversible deletes; writes must also be enabledCLOUDCRAFT_MAX_RESPONSE_BYTESMaximum bytes accepted from one Cloudcraft API response
Tools this server provides (13)
Taken from the project documentation; the running server may differ.
- 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
What it does
- 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
Pricing
Free
Free server; requires a Cloudcraft API key and account
Cloudcraft MCP 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.

