DiagramZu

ai.diagramzuv0.0.3Updated Sep 29, 2026

Let Claude, Cursor, or ChatGPT author Mermaid diagrams your team can read and share.

VerifiedStreamable HTTPWeb executableAI & ML

Installation

In SourceWeft

  1. Open DiagramZu in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "mcp": {
      "type": "http",
      "url": "https://mcp.diagramzu.ai/mcp"
    }
  }
}

README

@diagramzu/mcp

[smithery badge]

MCP server for diagramzu.ai. Lets Claude Code, Claude Desktop, Cursor, Windsurf, ChatGPT custom GPTs, and any MCP client read and write Mermaid diagrams in your Space.

You author diagrams by talking to your AI — it stores them in your Space at diagramzu.ai/app/d/<id>, where your team can read them and publish a public link.

Available in the official MCP Registry as ai.diagramzu/mcp.

1. Get a token

Sign up at diagramzu.ai, then create an API token at diagramzu.ai/app/settings/connections. Tokens look like dz_live_… and are scoped to one Space — no separate space-id needed.

2. Connect your client

The hosted server is the easy path: no install, no build. Just paste a config.

Claude Code

bash
claude mcp add --scope user --transport http diagramzu https://mcp.diagramzu.ai/mcp \  --header "Authorization: Bearer dz_live_xxx"

Claude Desktop, Cursor, Windsurf, Cline

Add to your client's MCP config (~/Library/Application Support/Claude/claude_desktop_config.json on macOS for Claude Desktop, ~/.cursor/mcp.json for Cursor, etc.):

json
{  "mcpServers": {    "diagramzu": {      "type": "http",      "url": "https://mcp.diagramzu.ai/mcp",      "headers": { "Authorization": "Bearer dz_live_xxx" }    }  }}

ChatGPT custom GPT (Actions)

In the GPT builder, add an MCP server action pointing to https://mcp.diagramzu.ai/mcp with a Bearer-token authentication header set to your dz_live_… token.

Local stdio (for clients that don't speak remote MCP)

bash
npx -y @diagramzu/mcp

with environment:

DIAGRAMZU_BASE_URL=https://diagramzu.aiDIAGRAMZU_API_TOKEN=dz_live_xxxDIAGRAMZU_SPACE_ID=<your space id>

Most users should prefer the remote HTTP transport above — the stdio path exists for clients without HTTP MCP support.

Tools

ToolDescription
list_diagramsList diagrams in the Space (filter with q, sort by updated / created)
list_foldersList folders in the Space
get_diagramFetch one diagram by id (title, description, Mermaid source)
create_diagramCreate a new diagram (returns its id and its /app/d/<id> URL)
update_diagramUpdate title, Mermaid source, description, or style of an existing diagram
analyze_diagramGet a structural summary of a diagram (nodes, edges, density)
list_versionsList version history for a diagram
get_versionFetch a specific historical version of a diagram
list_commentsList a diagram's comments, oldest first (optionally only one node's thread)
add_commentPost a comment, optionally pinned to a node or replying to a thread
list_decksList presentation decks in the Space, newest-edited first
get_deckFetch one deck by id, with its ordered slides
create_deckAssemble existing diagrams into an ordered presentation deck
update_deckChange a deck's title, description, or slide order (slides is declarative)

Which URLs are public

Two different things get called "a link" here, and only one of them works for someone outside your Space:

URLWho can open it
diagramzu.ai/app/d/<id>Space members only — the diagram in the app.
diagramzu.ai/app/present/<deck id>Space members only — the deck's presentation view.
diagramzu.ai/s/<slug>Anyone with the link — the public, read-only diagram page.
diagramzu.ai/s/p/<slug>Anyone with the link — the public, read-only deck.

The tools hand back the /app/… URLs, so a link pasted straight out of a chat is a members-only one: send it to someone outside the Space and they land on sign-in. To publish, open the diagram or deck in DiagramZu and use its Share button. This MCP server deliberately ships no tool that mints a public link — not because a token cannot (a dz_live_… token can mint one over the REST API), but because publishing a Space's content should be a deliberate human action rather than a side effect of a conversation. Once a diagram has a public link, get_diagram and update_diagram report it on a Share (public, read-only): line of their own.

Show off your setup

If you publish your MCP / Claude Code config in a dotfiles or example repo, drop this in the README so the next person knows where the diagrams come from:

markdown
[![MCP: diagramzu](https://diagramzu.ai/badge/mcp.svg)](https://diagramzu.ai)

Renders as a small shields-style badge — gray MCP + indigo diagramzu.

Local development (this repo)

For hacking on diagramzu itself, build from source:

bash
cd packages/mcp-diagramzupnpm installpnpm run build# point your client at: node dist/index.js# with DIAGRAMZU_BASE_URL / DIAGRAMZU_API_TOKEN / DIAGRAMZU_SPACE_ID

License

MIT

Source: README.md at commit 1ca30cc

Tools

0
Tool metadata has not been indexed yet.

Version history

1
  1. v0.0.3LatestSep 16, 2026