Let Claude, Cursor, or ChatGPT author Mermaid diagrams your team can read and share.
ai.diagramzu/mcp MCP Server
The ai.diagramzu/mcp server is an MCP server for diagramzu.ai. It enables MCP clients to read and write Mermaid diagrams in your Space. Tools including Claude Code, Claude Desktop, Cursor, Windsurf, ChatGPT custom GPTs, and other MCP clients can access the stored diagrams.
🛠️ Key Features
Supports Mermaid diagram read and write via MCP clients
Integrates with diagramzu.ai Spaces
Persists diagrams at diagramzu.ai/d/<id>
🚀 Use Cases
Authoring Mermaid diagrams by talking to your AI
Sharing diagrams your team can read and reuse
⚡ Developer Benefits
Provides an MCP-accessible workflow for Mermaid diagrams
Uses a stable diagram storage path: diagramzu.ai/d/<id>
Publishable/discoverable in the official MCP Registry as ai.diagramzu/m
⚠️ Limitations
Diagram storage and collaboration are tied to diagramzu.ai Spaces
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.
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.):
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:
code
DIAGRAMZU_BASE_URL=https://diagramzu.ai
DIAGRAMZU_API_TOKEN=dz_live_xxx
DIAGRAMZU_SPACE_ID=<your space id> # optional
DIAGRAMZU_SPACE_ID is optional. Left unset, the server uses the token's own default workspace — the one chosen when the token was minted. Set it to pin a different workspace as the default for this process.
Most users should prefer the remote HTTP transport above — the stdio path exists for clients without HTTP MCP support.
Workspaces
A token is scoped either to one workspace or to all the workspaces its owner belongs to, chosen when the token is authorized (the consent page's Access radio, or Settings → API tokens). An account-scoped token follows its owner's live memberships: joining a workspace adds it, being removed from one closes it on the next call.
list_spaces shows every workspace this connection can act in, which one is the default, and your role in each.
Every other tool takes an optional space — a workspace id, slug, or exact name (case-insensitive). Omit it to act in the default workspace. A name matching more than one workspace is refused rather than guessed; pass the id or slug.
Every tool result ends with the workspace it acted in.
Returned /app/... links carry ?space=, so opening one switches the browser to that workspace when you are a member.
Tools
Tool
Description
list_spaces
List every workspace this connection can act in, with ids, slugs, roles, and which is the default
list_diagrams
List diagrams in the Space (filter with q, sort by updated / created)
list_folders
List folders in the Space
get_diagram
Fetch one diagram by id (title, description, Mermaid source)
create_diagram
Create a new diagram (returns its id and its /app/d/<id> URL)
update_diagram
Update title, Mermaid source, description, or style of an existing diagram
analyze_diagram
Get a structural summary of a diagram (nodes, edges, density)
list_versions
List version history for a diagram
get_version
Fetch a specific historical version of a diagram
list_comments
List a diagram's comments, oldest first (optionally only one node's thread)
add_comment
Post a comment, optionally pinned to a node or replying to a thread
list_decks
List presentation decks in the Space, newest-edited first
get_deck
Fetch one deck by id, with its ordered slides
create_deck
Assemble existing diagrams into an ordered presentation deck
update_deck
Change a deck's title, description, or slide order (slides is declarative)
list_pages
List the workspace's Markdown pages (id, title, revision, snippet; filter with q)
get_page
Fetch one page by id — the whole body, or just its outline or one section
create_page
Create a Markdown page (title comes from the body's front matter or first heading)
update_page
Edit a page: targeted edits, or baseRevision + a whole new body
Which URLs are public
Two different things get called "a link" here, and only one of them works for
someone outside your Space:
URL
Who 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/app/pages/<id>
Space members only — the Markdown page in the app.
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.
diagramzu.ai/s/pg/<slug>
Anyone with the link — the public, read-only Markdown page.
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, deck or page 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.
A Markdown page is shared the same way.diagramzu.ai/s/pg/<slug> is its
public, read-only address, minted by a person from the page's Share button, so
get_page, create_page and update_page print the members-only
/app/pages/<id> URL and point at that button for anything wider. They do NOT
look a page's link up: unlike get_diagram they report no
Share (public, read-only): line, so a page's public address is something a
human hands over, not something an agent discovers.
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:
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-diagramzu
pnpm install
pnpm run build
# point your client at: node dist/index.js# with DIAGRAMZU_BASE_URL / DIAGRAMZU_API_TOKEN (DIAGRAMZU_SPACE_ID optional)
License
MIT
Install
Remote endpoint
Streamable HTTP
Hosted server - connect over the network, no local install.