Diagrams.so runs on your own machine — the client starts it, so there is no endpoint to ping. 242 installs a week from npm. Last commit 9 Oct 2026.
Generate and edit AWS, Azure, GCP and Kubernetes architecture diagrams as editable draw.io files.
What the code does
We read the source, 7 d ago · rules 995398eba69f
What this server is able to do. For an MCP server this is often the job itself — a terminal server runs commands because that is what it is for. Listed so you know what you are plugging in, not as an accusation.
const child = spawn(cmd, args, { detached: true, stdio: "ignore" });
Is this your server and something here is wrong? Tell us — corrections are free and do not require a plan.
This code can reach further than it looks
We found places where it runs commands, builds paths or queries from values it is given. None of that is a flaw by itself — it becomes one when the code changes, and code changes quietly between releases. We re-read it on every one.
Connect this server
This server runs on your own machine — install it with the package manager and the client starts it for you. Package name taken from the official registry entry.
claude mcp add diagrams-so-mcp -- npx -y @diagrams-so/mcp{
"mcpServers": {
"diagrams-so-mcp": {
"command": "npx",
"args": [
"-y",
"@diagrams-so/mcp"
]
}
}
}[mcp_servers.diagrams-so-mcp]
command = "npx"
args = ["-y", "@diagrams-so/mcp"]{
"mcpServers": {
"diagrams-so-mcp": {
"command": "npx",
"args": [
"-y",
"@diagrams-so/mcp"
]
}
}
}{
"servers": {
"diagrams-so-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@diagrams-so/mcp"
]
}
}
}Optional settings from the registry entry, left out of the block above:
DIAGRAMS_API_KEY (Diagrams.so API key (dgz_live_... or dgz_test_...). Optional since 1.4.0: run `npx @diagrams-so/mcp login` once instead. Or create a key at https://diagrams.so under Settings then API Keys), DIAGRAMS_API_BASE (API base URL. Defaults to production; override only for a local or self-hosted API), DIAGRAMS_API_TIMEOUT_MS (Per-request timeout in milliseconds for slow generate/edit/fix calls).
Alternatives to Diagrams.so
same job, measured the same wayArchitecture diagrams with official AWS, Azure, GCP and Kubernetes icons, to SVG, PNG and draw.io
Draw cloud architecture diagrams with official AWS, Azure and GCP icons from a prompt or Terraform.
Local-first FinOps copilot: ask AWS, Azure, GCP, Kubernetes and SaaS cost questions in your editor.
AWS, Azure and GCP architecture diagrams with official icons, reviews, Terraform and GCP import
Visualise diagrams, generate Terraform HCL, and manage Azure/AWS/GCP infrastructure with AI.
Manage AWS, Azure, GCP, Kubernetes, CI/CD, Docker, Terraform and more. 704 tools.
Scan AWS/Azure/GCP and generate Terraform HCL with import blocks, deterministically, for AI agents.
Cited cloud best practices and a rules-based review of Terraform, CloudFormation, and Kubernetes.
Diagrams.so — questions
Answers built from our own checks of this server.