Skip to content
MCP server

Mermaid Online MCP — Share Links & Source

Encodes Mermaid diagrams into share tokens and recovers the source from them

Runs locallyStatus and history
Pricing
Open source
Platforms
CLI, macOS, Linux
Runs
Locally
Version
0.1.0
Listing updated
3 days ago

About Mermaid Online MCP — Share Links & Source

Mermaid Online MCP — Share Links & Source is an open-source MCP server for developer tools. It runs locally on your machine and is started by your AI client.

Sharing a diagram usually means pasting a link and hoping the receiver can get the code back. This local server does that round trip as plain text handling: it compresses Mermaid source into a reversible pako token and decodes a token, fragment or URL back into the original source.

It is explicit about what it skips. It does not render, validate Mermaid syntax, fetch URLs or read and write files, and it is independent of Mermaid.js. The base URL for a share link must be given by the caller, and no tracking parameters are added.

Limits are 48,000 bytes of source and 8,000 bytes of config, with share tokens up to 65,536 characters. A link holds the whole diagram state and is not encrypted. It is the open-source companion to the Mermaid Online editor.

Install

Run in a terminal

claude mcp add mermaidonline -- npx -y mermaidonline-mcp

Add to claude_desktop_config.json

{
  "mcpServers": {
    "mermaidonline": {
      "command": "npx",
      "args": [
        "-y",
        "mermaidonline-mcp"
      ]
    }
  }
}
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "mermaidonline": {
      "command": "npx",
      "args": [
        "-y",
        "mermaidonline-mcp"
      ]
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "mermaidonline": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "mermaidonline-mcp"
      ]
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "mermaidonline": {
      "command": "npx",
      "args": [
        "-y",
        "mermaidonline-mcp"
      ]
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "mermaidonline": {
      "command": "npx",
      "args": [
        "-y",
        "mermaidonline-mcp"
      ]
    }
  }
}

Tools this server provides (2)

Taken from the project documentation; the running server may differ.

encode_mermaid_share
Encode Mermaid code into a reversible share token and optional URL
decode_mermaid_share
Recover original source from a share token or URL

What it does

Share token encoding
Turns diagram code into a reversible token and optional URL.
Source recovery
Decodes a token, fragment or URL into the original code.
Explicit destination
Never swaps in a default base URL.
Bounded inputs
Size limits on source, config and decoded JSON.
No network use
Never requests a decoded address.

Good for

  • Generate a share link for an agent-written diagram
  • Recover source from a pasted share URL
  • Verify a diagram round-trips unchanged
  • Keep diagram links in docs without hosting them

Pricing

Open source

Open source; no account, key or paid backend

Prices change. Check mermaidonline.org before you buy.

Mermaid Online MCP — Share Links & Source FAQ

Does it draw the diagram?

No. It only serialises text; rendering happens in an editor such as Mermaid Online.

Are share links private?

No. A link contains the full state, is reversible and not encrypted.

Is it the official Mermaid server?

No, it is an independent companion to Mermaid Online.

Is Mermaid Online MCP — Share Links & Source free?

Yes. Mermaid Online MCP — Share Links & Source is open source, so you can use and self-host it for free.

How do I add Mermaid Online MCP — Share Links & Source to Claude Code?

Run this command in your terminal: claude mcp add mermaidonline -- npx -y mermaidonline-mcp

What are the best alternatives to Mermaid Online MCP — Share Links & Source?

The closest alternatives to Mermaid Online MCP — Share Links & Source are REA, HyperFrames by HeyGen, Codebase Memory, GitHub and Serena MCP: the IDE for your agent.

Alternatives to Mermaid Online MCP — Share Links & Source

  1. REA

    MCP server

    CLI and MCP server that lets coding agents reverse engineer apps and binaries

    Runs locally
    • Open source
    • 464K GitHub stars
    • Developer tools
  2. Hosted MCP connector for creating and rendering videos from HTML through AI chat

    • Remote
    • Freemium
    • 85.3K GitHub stars
    • Design and media
  3. Codebase Memory

    MCP server

    Local MCP server that builds a code knowledge graph for AI coding agents

    Runs locally
    • Open source
    • 48.7K GitHub stars
    • Knowledge and memory
  4. GitHub

    MCP server

    Official MCP server connecting AI assistants to GitHub repos, issues and workflows

    Not checked yet
    • Remote
    • Open source
    • 34.5K GitHub stars
    • Developer tools
  5. MCP toolkit giving coding agents symbol-level code retrieval and editing

    Runs locally
    • Open source
    • 31.5K GitHub stars
    • Developer tools
  6. XERJ

    MCP server

    Local search engine for AI agents with cited answers over your code and docs

    Runs locally
    • Open source
    • 19.2K GitHub stars
    • Knowledge and memory