Skip to content
MCP server

Diagrams.so

MCP server that generates and edits AWS, Azure, GCP and Kubernetes diagrams as draw.io

Runs locallyStatus and history
Install
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/mcp

Add 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

  1. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  2. ffmpeg-skill

    MCP server

    Local FFmpeg video and audio editing tools for coding agents over MCP

    Runs locally
    • Open source
    • 6.9K GitHub stars
    • Design and media
  3. ChartAnt

    MCP server

    Remote MCP server returning charts, maps and dashboards as hosted PNG links

    • 51 tools
    • Remote
    • Freemium
    • Design and media
  4. VfxSmith

    MCP server

    Search, generate, refine and export pixel art game effects from Claude Code or Codex

    Not checked yet
    • Remote
    • Freemium
    • Design and media
  5. CalderFlow

    MCP server

    Turn notes or specs into editable flowcharts, timelines and funnels from an AI assistant

    • 10 tools
    • Remote
    • Free
    • Design and media