Generate and edit AWS, Azure, GCP and Kubernetes architecture diagrams as editable draw.io files.
Connect Runs on your machine
claude mcp add diagrams-so-mcp -e DIAGRAMS_API_KEY=<DIAGRAMS_API_KEY> -e DIAGRAMS_API_BASE=<DIAGRAMS_API_BASE> -e DIAGRAMS_API_TIMEOUT_MS=<DIAGRAMS_API_TIMEOUT_MS> -- npx -y @diagrams-so/[email protected]
{
"mcpServers": {
"diagrams-so-mcp": {
"command": "npx",
"args": [
"-y",
"@diagrams-so/[email protected]"
],
"env": {
"DIAGRAMS_API_KEY": "<DIAGRAMS_API_KEY>",
"DIAGRAMS_API_BASE": "<DIAGRAMS_API_BASE>",
"DIAGRAMS_API_TIMEOUT_MS": "<DIAGRAMS_API_TIMEOUT_MS>"
}
}
}
}
{
"mcpServers": {
"diagrams-so-mcp": {
"command": "npx",
"args": [
"-y",
"@diagrams-so/[email protected]"
],
"env": {
"DIAGRAMS_API_KEY": "<DIAGRAMS_API_KEY>",
"DIAGRAMS_API_BASE": "<DIAGRAMS_API_BASE>",
"DIAGRAMS_API_TIMEOUT_MS": "<DIAGRAMS_API_TIMEOUT_MS>"
}
}
}
}
{
"servers": {
"diagrams-so-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@diagrams-so/[email protected]"
],
"env": {
"DIAGRAMS_API_KEY": "<DIAGRAMS_API_KEY>",
"DIAGRAMS_API_BASE": "<DIAGRAMS_API_BASE>",
"DIAGRAMS_API_TIMEOUT_MS": "<DIAGRAMS_API_TIMEOUT_MS>"
}
}
}
}
Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
DIAGRAMS_API_KEYOptional, secret | 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_BASEOptional | API base URL. Defaults to production; override only for a local or self-hosted API. |
DIAGRAMS_API_TIMEOUT_MSOptional | Per-request timeout in milliseconds for slow generate/edit/fix calls. |
Details
| Package | @diagrams-so/[email protected] (NPM, stdio) |
| First published | 9 Oct 2026 |
| Last updated | 9 Oct 2026 |
| Registry name | io.github.RedHold/diagrams-so-mcp |
More cloud and devops servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.
