MCP server

The Diagrams.so MCP server exposes the API as Model Context Protocol tools, so an AI agent can generate, review, fix, edit, and export diagrams as part of a larger task without you writing any HTTP. It ships on npm and installs with a single command.

Install

Claude Code / CLI
Claude Desktop / Cursor (JSON)

claude mcp add diagrams-so -- npx -y @diagrams-so/mcp
npx @diagrams-so/mcp login

Add this to your client’s MCP config:

{
  "mcpServers": {
    "diagrams-so": {
      "command": "npx",
      "args": ["-y", "@diagrams-so/mcp"]
    }
  }
}

Restart your client, then ask: “Generate an AWS 3-tier web app diagram and show me the warnings.” If this machine is not connected yet, the first tool call replies with a link. Open it, press Approve, and ask again. No terminal is needed, which is what makes this work in Claude Desktop.

Run npx @diagrams-so/mcp install to print ready-to-paste config for Claude Code, Claude Desktop, and Cursor.

Installing the package globally gives you a shorter command:

npm i -g @diagrams-so/mcp
diagrams-so login

npx @diagrams-so/mcp <command> works without installing anything, and the original diagrams-so-mcp name still works.

Commands

Command	What it does
`login [--test]`	Connect this machine. Add `--test` to mint a test-mode key.
`logout`	Remove the local credential.
`whoami`	Show the connected account and where the credential came from.
`install [client]`	Print config for Claude Code, Claude Desktop, or Cursor.

A one-click .mcpb bundle for Claude Desktop is distributed through the MCP registry and the Claude Desktop extensions directory. It does not ask for an API key: install it, then connect on first use. Until it is listed there, use the npx command above, which works in every MCP client from the public npm package.

Configuration

Env var	Required	Default
`DIAGRAMS_API_KEY`	No. Only for CI or headless use, where `login` cannot open a browser.	none
`DIAGRAMS_API_BASE`	No	`https://api.diagrams.so/api/v2` (production)
`DIAGRAMS_API_TIMEOUT_MS`	No	`450000`
`DIAGRAMS_BROWSER`	No	none. Set a browser name, for example `Google Chrome`, when your account session lives in a non-default browser.
`DIAGRAMS_NO_BROWSER`	No	none. Set it to stop `login` opening a browser. The URL is always printed.
`DIAGRAMS_NO_AUTO_LOGIN`	No	none. Set it to disable the in-chat connect prompt, for CI.

Prefer login. It stores a scoped, revocable, 90-day credential outside your client config. Never share a key or paste it into a chat.

What the agent can do

The server provides 23 tools covering the full API. Reads and exports are free; generate, edit, fix, re-layout, and fork cost credits, attributed to source="mcp" in your usage history. See the complete Tools reference for every tool and example prompts.

Getting started

Model Context Protocol (MCP)

SDKs

Guides

Billing

Resources

Install

Commands

Configuration

What the agent can do

Next steps

Tools reference

Authentication

​Install

​Commands

​Configuration

​What the agent can do

​Next steps

Tools reference

Authentication

Install

Commands

Configuration

What the agent can do

Next steps