Skip to content
Agentmart
Submit a tool

Diagrams.so

Generate and edit AWS, Azure, GCP and Kubernetes architecture diagrams as editable draw.io files.

Connector by RedHold · GitHub account verified by the MCP Registry

IndexedApache-2.0Local (stdio)
Write a review

Install

Works with Claude Code, Codex, VS Code, Cursor, Windsurf, Claude Desktop. Read the repository before you give any tool access to your data.

npx agentmarket install connector/redhold-diagrams-so-mcp

Asks which of your tools to add it to (Claude Code, Codex, Cursor, VS Code, Windsurf, Gemini CLI, Claude Desktop) and shows the change first. See https://agentmart.dev/cli.

Get the weekly diff

The weekly diff: one email a week with new agent tools, notable updates and grade changes, plus security alerts for tools you follow. Double opt-in, one-click unsubscribe.

We use your email only for this newsletter. Privacy

About

Generate and edit AWS, Azure, GCP and Kubernetes architecture diagrams as editable draw.io files.

Reviews

Write a review

No reviews yet. Installed it? Reviews come from verified installers only. How reviews work

Permissions

What this server can do and what it asks for, from its tool list, install config and code. Checked Oct 26, 2026.

Tools
14 read · 7 write · 2 delete
Secrets
1 (API keys, tokens or passwords)
Install scripts
None found
Runs as
Node.js package

Tools by what they do 23

Read from the source code; the running server may list different tools.

Read 14 · Look things up without changing anything.

  • clarify_prompt
  • enhance_prompt
  • export_diagram
  • get_diagram
  • get_relayout_status
  • get_usage
  • get_usage_history
  • get_version
  • get_warnings
  • list_capabilities
  • list_diagrams
  • list_versions
Show 2 more tools
  • search_gallery
  • whoami

Write 7 · Create, change, send or run things.

  • edit_diagram
  • fix_warning
  • fork_template
  • generate_diagram
  • import_diagram
  • relayout_diagram
  • update_diagram

Delete 2 · Delete, drop, revoke or wipe things.

  • delete_diagram
  • revert_diagram

Secrets and settings it asks for

Secrets: values you paste in that let it act as you.

  • DIAGRAMS_API_KEY

Other settings (environment variables or headers).

  • DIAGRAMS_API_BASE
  • DIAGRAMS_API_TIMEOUT_MS

Network hosts it talks to 4

  • api.diagrams.so · found in code
  • diagrams.so · found in code
  • github.com · found in code
  • glama.ai · found in code

Files it touches

  • Your home directory (~)
  • Any path the agent passes to its tools

Tools (23)

Read from the source code; the running server may differ. Descriptions are the server’s own words; hidden characters are shown as [U+…].

  • clarify_promptClarify a vague promptread-only

    Get 1–3 clarifying questions (and a suggested diagram type) for a vague prompt, before generating. Free.

  • delete_diagramDelete a diagramcan change or delete data

    Delete (soft-delete) a diagram you own. It stops appearing in list_diagrams and can no longer be fetched. Confirm with the user before calling — this is destructive.

  • edit_diagramEdit a diagram

    Apply a natural-language change to an existing diagram (e.g. 'add a Redis cache'). Creates a new version and returns the updated XML (Paid plan; Free gets a link to the watermarked image). Confirm with the user before calling: it mutates the diagram.

  • enhance_promptEnhance a promptread-only

    Turn a rough idea into a detailed generation prompt. Free.

  • export_diagramExport a diagramread-only

    Export a diagram as a raw file: `drawio` (open at app.diagrams.net) or `svg`. Returns the file content directly. `svg` works on every plan; Free-plan images carry a watermark. The editable `drawio` file needs the Paid plan: on Free, asking for `drawio` returns the watermarked SVG instead.

  • fix_warningFix one warning

    Resolve a single Well-Architected warning (from get_warnings), leaving the rest of the diagram untouched. Creates a new version.

  • fork_templateFork a public diagram

    Copy a PUBLIC gallery diagram or curated library template into your own account (private) so you can edit it. Returns the new diagram id.

  • generate_diagramGenerate a diagram

    Create a new cloud architecture diagram from a natural-language prompt. Returns the diagram id, Well-Architected warnings and score, and its draw.io XML on the Paid plan (on Free, a link to the watermarked image instead).

  • get_diagramGet a diagramread-only

    Fetch a diagram by id. Returns its title, Well-Architected score, and draw.io XML on the Paid plan (on Free, a link to the watermarked image instead).

  • get_relayout_statusPoll a re-layout jobread-only

    Check the status of an async re-layout job started by relayout_diagram. Returns pending/done/failed; when done+applied it includes the re-laid XML + fresh warnings/score. Free.

  • get_usageGet usage & planread-only

    Show your current plan and usage. Every plan has unlimited diagrams and edits. Free.

  • get_usage_historyTask historyread-only

    List past tasks (generate/edit/fix/relayout), newest first, with the diagram each one touched and the surface (api/sdk/mcp) that ran it. Use this to check whether a task already ran. Also shows a running tally of tasks performed in THIS session. Free (read-only).

  • get_versionGet a diagram versionread-only

    Fetch a specific version's Well-Architected score and XML (XML on the Paid plan; Free gets a link to the watermarked image), e.g. to inspect before reverting. No charge.

  • get_warningsGet Well-Architected warningsread-only

    List the Well-Architected findings for a diagram (each has type, component, message). Free.

  • import_diagramImport a diagram

    Import an existing draw.io (mxGraphModel/mxfile) XML document as a new diagram in your account. Validated and sanitized. Free (no AI).

Show 8 more tools
  • list_capabilitiesList capabilitiesread-only

    Discover the valid diagram types, cloud providers, and export formats the API supports — so you pass valid values to generate_diagram / export_diagram. Free.

  • list_diagramsList my diagramsread-only

    List your diagrams (newest first, cursor-paginated). Returns id, title, cloud, type.

  • list_versionsList diagram versionsread-only

    List a diagram's version history (ascending; `is_current` marks the live one). Use with revert_diagram / get_version.

  • relayout_diagramRe-arrange layout with AI

    Automatically re-arrange a diagram's layout for readability (async). Starts the job and waits for it to finish, returning the re-laid XML + fresh warnings/score. Requires confirm=true, because it replaces the current layout. If the job is still running when the wait elapses, returns a job_id you can poll with get_relayout_status.

  • revert_diagramRevert to a version

    Revert a diagram to an earlier version (from list_versions). Pass either version_id or version_number. Free (no AI).

  • search_gallerySearch the galleryread-only

    Search public community diagrams and curated library templates to reuse as a starting point. Returns id, title, and source (community/library). Fork one with fork_template.

  • update_diagramUpdate a diagram

    Update a diagram's metadata or XML: rename it, change visibility (public/private — paid plans for private), or replace its XML. Pass only the fields you want to change. Free (no AI).

  • whoamiWho am Iread-only

    Show the account, plan, scopes, and live/test mode of the configured API key. Free.

Signals

Stars
0
Forks
0
Open issues
5
Weekly downloads
96
Last commit
Oct 9, 2026 (19 days ago)
Last release
Oct 9, 2026 (19 days ago)
Last package publish
Oct 9, 2026 (19 days ago)

From GitHub (fetched Oct 24, 2026) and the package registry.

Details

Registry name
io.github.RedHold/diagrams-so-mcp
Version
1.4.7
Auth
API key
Packages
npm @diagrams-so/mcp
License
Apache-2.0
Repository
github.com/RedHold/diagrams-mcp-app-core
Website
diagrams.so/developers
First seen
Oct 24, 2026
Last checked
Oct 24, 2026
Source
Official MCP Registrygithub-graphql
Cite this page

Diagrams.so MCP server. Agent Mart. https://agentmart.dev/connectors/redhold-diagrams-so-mcp (last updated 2026-10-24)