Log inSubmit server
Diagrams.so logo

Diagrams.so

Create, edit, review, version, and export editable cloud architecture diagrams through MCP.

InstallRepositoryWebsite
Full README Compare alternatives Embed widget Claim this listing

Install Diagrams.so

Pick your client, then add it in one click or paste the config.

STDIONode.js
~/Library/Application Support/Claude/claude_desktop_config.json
claude_desktop_config.json
{
  "mcpServers": {
    "diagrams-so": {
      "command": "npx",
      "args": [
        "-y",
        "@diagrams-so/mcp"
      ]
    }
  }
}

Settings → Developer → Edit Config, merge this into mcpServers, then fully quit and reopen Claude Desktop.

Automated check passed— started and listed 23 tools correctly (22d ago).

Overview

Diagrams.so MCP server connects MCP clients to the Diagrams.so API for creating and managing editable draw.io architecture diagrams. It supports AWS, Azure, GCP, and Kubernetes diagrams, with tools for generation, natural-language edits, warnings, versioning, imports, exports, and gallery searches. The package runs as a Node.js stdio server and authenticates through browser approval or an API key for headless use. Reach for it when an agent needs to produce or maintain architecture diagrams rather than static images.

Use cases

  • Generate AWS, Azure, GCP, or Kubernetes architecture diagrams from prompts
  • Edit an existing draw.io architecture diagram with natural language
  • Review Well-Architected warnings and apply targeted fixes
  • Export editable draw.io or SVG files for documentation
  • Browse templates and maintain diagram version history

Key features

  • Natural-language diagram generation and editing
  • Editable draw.io XML output
  • AWS, Azure, GCP, and Kubernetes support
  • Well-Architected warnings and scores
  • Version history, imports, reverts, and exports
  • Gallery search and usage tracking

Tools23

What Diagrams.so lets your agent do. Expand a tool for its parameters.

Verified live~3.0k tokens of context

Security & health

What it can reach and how reliably it runs — from our own checks, not the maintainer’s claims.

ActiveLast checked Today

Recent health check succeeded.

20/22 checks healthy over the last 90d

What it can do

From the 23 tools this server returned when we ran it; 23 declare their own safety hints.

Can delete or modify data · 1Handles credentials · 1Makes network requests · 2Read-only tools · 22
Network at startup3 connections
Files written at startupNone
Install scriptsprepare
npm provenanceNot published
Package age75 days
Maintainers1

Observed 2026-10-17 in an isolated sandbox. A description of reach, not a security audit.

Supply-chain signal

No high-severity advisories surfaced by our automated scan.

Critical 0High 0Medium 0Low 0

Scanned 5d ago via OSV.dev · @diagrams-so/mcp (npm)

Adoption & maintenance

Factual signals from GitHub, npm, and our automated checks — not a rating.

npm downloads1.1kPackage downloads in the last 30 days.
Last commit1mo agoMost recent push to the default branch.
Availability100%Our rolling endpoint + install checks that succeeded.
Install checkPassedOur sandbox started it and listed its tools.
Tools exposed23Callable tools this server registers over MCP.
Directory activity1 viewsConfig copies, upvotes, and views on AllMCPs.

How Diagrams.so works

What Diagrams.so MCP server does

The Diagrams.so MCP server gives an MCP client access to Diagrams.so's cloud architecture diagram workflow. It can create diagrams for AWS, Azure, GCP, and Kubernetes from natural-language prompts, returning a diagram ID, editable draw.io XML, warnings, and a score. Existing draw.io XML can also be imported, updated, versioned, reverted, copied from public templates, or soft-deleted.

The output is a real draw.io file that can be opened in diagrams.net or its desktop application. Exports are available as raw draw.io or SVG files. SVG export is free on all plans, although the free plan adds a watermark.

How it works

The package is a thin stdio client for the public Diagrams.so REST API at /api/v2; each MCP tool maps to an API request. An assistant can call several tools in sequence from a normal chat request, such as generating a diagram, retrieving its Well-Architected findings, and exporting the result.

Read operations and exports are free. Generating, editing, fixing warnings, and re-layout operations use credits. Re-layout runs asynchronously, with a status tool for polling, and requires confirmation before a charge applies after the first two re-layouts for a diagram. Usage tools expose the current plan, credit estimates, itemized history, and session totals.

Setup and configuration

The Diagrams.so MCP server requires Node.js 18 or newer. Run it directly with npx -y @diagrams-so/mcp, or install the package globally with npm. The normal authentication flow uses npx @diagrams-so/mcp login; a browser opens for approval, and no API key needs to be copied. Clients must be restarted after adding the server so their MCP tool lists refresh.

Claude Desktop and Cursor use an MCP configuration that starts the package with npx; Claude Code can add it with claude mcp add. A one-click MCPB bundle is also available for Claude Desktop. For machines without a browser, set DIAGRAMS_API_KEY for CI or other headless environments. DIAGRAMS_LOGIN_EMAIL enables an email-based connection flow on the first tool call.

The default API endpoint is https://api.diagrams.so/api/v2. Set DIAGRAMS_API_BASE to use a local or self-hosted API. Optional settings include DIAGRAMS_API_TIMEOUT_MS, DIAGRAMS_BROWSER, DIAGRAMS_NO_BROWSER, and DIAGRAMS_NO_AUTO_LOGIN.

Tools and capabilities

The Diagrams.so MCP server exposes tools in four broad groups:

  • Create and change: generate, edit, fix a warning, re-layout, import, update, revert, delete, and fork a template.
  • Read and export: fetch diagrams, list diagrams, inspect warnings, export files, and retrieve version history or a specific version.
  • Discovery and prompting: search the public or curated gallery, expand rough prompts, ask clarification questions, and list supported diagram types, providers, and formats.
  • Account and billing: inspect identity, plan details, credit estimates, and filtered usage history.

Natural-language edits create new versions, while version tools expose which version is current. The warning tools provide Well-Architected findings and scores for review during design iteration.

Read the full README View source on GitHub

Reviews

No reviews yet — be the first to share how it worked for you.

Frequently Asked Questions about Diagrams.so

Diagrams.so is an MCP server that connects MCP clients to the Diagrams.so API for cloud architecture diagrams. Its main tools generate and edit AWS, Azure, GCP, and Kubernetes diagrams, inspect warnings and versions, import draw.io XML, and export editable draw.io or SVG files for further use.

Install it by running `npx -y @diagrams-so/mcp` through your MCP client, then authenticate with `npx @diagrams-so/mcp login`. You can also install the npm package globally or add the MCPB bundle to Claude Desktop.

Diagrams.so normally authenticates through browser approval after running its login command. For CI or headless machines, set `DIAGRAMS_API_KEY`; `DIAGRAMS_LOGIN_EMAIL` can start an email-based connection flow on the first tool call.

Yes, Diagrams.so works with Cursor through its MCP configuration. Add the server using the npm command, authenticate, restart Cursor, and request diagrams from the chat or composer panel.

Yes, it exports raw draw.io files that remain editable in diagrams.net or the desktop application. It can also export SVG; SVG is free on every plan, but free-plan exports are watermarked.

Related MCP servers

All in Cloud Platforms All alternatives
Add a badge to your READMEShow it’s listed — live SVG, Markdown or HTML.

AllMCPs Directory Badge

Full Badge Customizer

Showcase your server listing on GitHub or your project documentation. Embed this dynamic SVG badge to highlight official listing status and live engagement.

Badge Style:
Live Dynamic SVG PreviewDiagrams.so AllMCPs Directory Badge
Markdown (GitHub README)
[![AllMCPs](https://allmcps.com/api/badge/diagrams-so?style=directory)](https://allmcps.com/mcp/diagrams-so)
HTML Embed
<a href="https://allmcps.com/mcp/diagrams-so"><img src="https://allmcps.com/api/badge/diagrams-so?style=directory" alt="Diagrams.so on AllMCPs" /></a>