Diagrams.so
MCP server that generates and edits AWS, Azure, GCP and Kubernetes diagrams as draw.io
- Pricing
- Freemium
- Platforms
- CLI, API, Web
- Runs
- Locally
- Version
- 1.4.7
- Listing updated
- 1 day ago
About Diagrams.so
Diagrams.so is a freemium MCP server for cloud and infrastructure. It runs locally on your machine and is started by your AI client.
The server is a thin stdio client over the Diagrams.so REST API, exposing 23 tools to Claude Desktop, Claude Code and Cursor. You describe an architecture in plain language, and the assistant generates a diagram, reports design warnings with a score, and exports it. Follow-up requests such as adding a CloudFront distribution or fixing a no-encryption warning create new versions.
A setup quirk is worth knowing: instead of copying an API key you run an npx login command once and approve in a browser, or set an email so the first tool call sends a one-time sign-in code. The README says every plan has unlimited diagrams and edits with only a per-minute rate limit. The Paid plan adds draw.io export and removes the watermark; the Free plan returns a watermarked SVG.
It needs Node 18 or later.
Install
Run in a terminal
claude mcp add diagrams-so-mcp --env DIAGRAMS_API_KEY='<DIAGRAMS_API_KEY>' -- npx -y @diagrams-so/mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"diagrams-so-mcp": {
"command": "npx",
"args": [
"-y",
"@diagrams-so/mcp"
],
"env": {
"DIAGRAMS_API_KEY": "<DIAGRAMS_API_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"diagrams-so-mcp": {
"command": "npx",
"args": [
"-y",
"@diagrams-so/mcp"
],
"env": {
"DIAGRAMS_API_KEY": "<DIAGRAMS_API_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"diagrams-so-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@diagrams-so/mcp"
],
"env": {
"DIAGRAMS_API_KEY": "<DIAGRAMS_API_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"diagrams-so-mcp": {
"command": "npx",
"args": [
"-y",
"@diagrams-so/mcp"
],
"env": {
"DIAGRAMS_API_KEY": "<DIAGRAMS_API_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"diagrams-so-mcp": {
"command": "npx",
"args": [
"-y",
"@diagrams-so/mcp"
],
"env": {
"DIAGRAMS_API_KEY": "<DIAGRAMS_API_KEY>"
}
}
}
}Configuration
DIAGRAMS_API_KEYDiagrams.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_BASEAPI base URL. Defaults to production; override only for a local or self-hosted API.DIAGRAMS_API_TIMEOUT_MSPer-request timeout in milliseconds for slow generate/edit/fix calls.
Tools this server provides (7)
Taken from the project documentation; the running server may differ.
- generate_diagram
- Creates a diagram from a prompt and returns warnings and a score.
- edit_diagram
- Applies a natural-language change as a new version.
- fix_warning
- Resolves one Well-Architected warning.
- relayout_diagram
- Re-arranges the layout using AI.
- import_diagram
- Imports an existing diagram.
- get_warnings
- Lists design warnings for a diagram.
- export_diagram
- Exports a diagram, for example as draw.io or SVG.
What it does
- Prompt to diagram
- Creates cloud architecture diagrams from a text description.
- Design warnings
- Returns Well-Architected warnings and a score.
- Warning fixes
- Resolves one flagged warning at a time.
- Natural-language edits
- Applies changes as new versions.
- draw.io export
- Paid plan saves real editable draw.io XML.
- Browser login
- Approve once in a browser instead of copying a key.
Good for
- Draft an AWS three-tier architecture from a sentence
- Fix a design warning and check the new score
- Add a component to an existing diagram
- Export a diagram as SVG for a README
Pricing
Freemium
Free plan with watermarked images; Paid plan adds draw.io export and removes watermark (price not shown)
Prices change. Check diagrams.so before you buy.
Diagrams.so FAQ
Do I need an API key?
Not necessarily. Run npx @diagrams-so/mcp login and approve in the browser, or set DIAGRAMS_API_KEY.
What does the free plan give?
Diagrams as a watermarked image; the editable draw.io file needs the Paid plan.
Which clouds are covered?
AWS, Azure, GCP and Kubernetes per the registry entry.
Is there a web alternative?
Yes, diagrams.so/create offers the same thing without MCP.
Is Diagrams.so free?
Diagrams.so has a free plan, with paid plans for more usage or features.
How do I add Diagrams.so to Claude Code?
Run this command in your terminal: claude mcp add diagrams-so-mcp --env DIAGRAMS_API_KEY='<DIAGRAMS_API_KEY>' -- npx -y @diagrams-so/mcp
What are the best alternatives to Diagrams.so?
The closest alternatives to Diagrams.so are HyperFrames by HeyGen, ffmpeg-skill, AvatarSay — Fictional Character & Talking Video MCP, ChartAnt and VfxSmith.
Alternatives to Diagrams.so

HyperFrames by HeyGen
MCP serverHosted MCP connector for creating and rendering videos from HTML through AI chat
- Remote
- Freemium
- 85.3K GitHub stars
- Design and media

ffmpeg-skill
MCP serverLocal FFmpeg video and audio editing tools for coding agents over MCP
Runs locally- Open source
- 6.9K GitHub stars
- Design and media

Generate fictional character portraits and lip-synced talking videos from text over MCP
- 10 tools
- Remote
- Freemium
- Design and media

ChartAnt
MCP serverRemote MCP server returning charts, maps and dashboards as hosted PNG links
- 51 tools
- Remote
- Freemium
- Design and media

VfxSmith
MCP serverSearch, generate, refine and export pixel art game effects from Claude Code or Codex
Not checked yet- Remote
- Freemium
- Design and media

CalderFlow
MCP serverTurn notes or specs into editable flowcharts, timelines and funnels from an AI assistant
- 10 tools
- Remote
- Free
- Design and media