# Agentic Mermaid (remote · agentic-mermaid.dev)

Render, verify, describe, and safely edit Mermaid diagrams through MCP.

- Trust score: 70/100 (medium)
- Change this week: +54
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- remote · `agentic-mermaid.dev`: 70/100 (this document), [markdown](https://verifymcp.io/servers/adewale-agentic-mermaid/agentic-mermaid.md), [page](https://verifymcp.io/servers/adewale-agentic-mermaid/agentic-mermaid)
- npm · `agentic-mermaid`: 49/100, [markdown](https://verifymcp.io/servers/adewale-agentic-mermaid/agentic-mermaid-2.md), [page](https://verifymcp.io/servers/adewale-agentic-mermaid/agentic-mermaid-2)

## Channel facts

- Endpoint: `https://agentic-mermaid.dev/mcp`
- Transports: `streamable-http`
- Auth: `none`
- Version: `0.4.1`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically against the live server, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Endpoint Security**: 80/100
  - The endpoint's TLS certificate is valid, in date, and uses a strong key.
  - No authorisation is required to call this server. Every tool declares its destructiveHint and none is destructive, so open access doesn't expose one.
  - HTTPS is enforced; there's no plaintext access path.
  - The HSTS (Strict-Transport-Security) header is present.
  - DNSSEC check failed: this domain isn't protected by DNSSEC.
- **Transport & Reachability**: 100/100
  - Verified streamable-http transport via a live MCP handshake.
- **Schema Quality & AI Usability**: 48/100
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 5241 tokens (~582/item across 9 items; 9 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 20/100
  - Stability observed for 6 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Capabilities**: 100/100
  - Implements a current MCP spec version (2026-07-28).

## Install

### Claude

```bash
claude mcp add --transport http adewale-agentic-mermaid https://agentic-mermaid.dev/mcp
```

### Codex

```toml
[mcp_servers.adewale-agentic-mermaid]
url = "https://agentic-mermaid.dev/mcp"
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "adewale-agentic-mermaid": {
      "type": "remote",
      "url": "https://agentic-mermaid.dev/mcp",
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add adewale-agentic-mermaid --url https://agentic-mermaid.dev/mcp --transport streamable-http
```

### Hermes

```yaml
mcp_servers:
  adewale-agentic-mermaid:
    url: "https://agentic-mermaid.dev/mcp"
```

### Other

```json
{
  "mcpServers": {
    "adewale-agentic-mermaid": {
      "type": "http",
      "url": "https://agentic-mermaid.dev/mcp"
    }
  }
}
```

The mcpServers block is a cross-client convention. Remote transports vary, so check your client's docs.

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-03 (score 70, +1)

No change was recorded against any check on this day. Stability & Change Management went from 17 to 20. That category is still filling its 30-day observation window: 5 days of observed history at the previous scan, 6 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-08-01 (score 69, +1)

No change was recorded against any check on this day. Stability & Change Management went from 10 to 13. That category is still filling its 30-day observation window: 3 days of observed history at the previous scan, 4 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-07-31 (score 68, +5)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server
- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 63, 0)

- [functional] The server no longer declares the “prompts” capability
- [functional] The server no longer declares the “resources” capability
- [functional] Server version: 0.3.2 → 0.4.0

### 2026-07-29 (score 63, +1)

- [functional improvement] Stability: unverified → 0.03

### 2026-07-28 (score 62, +46)

- [security improvement] Authorization: unverified → partial
- [security improvement] Transport: fail → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: fail
- [functional] First check of Schema quality: fail
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: good

### 2026-07-27 (score 16, 0)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-26 (score 16)

First indexed and scored.

## MCP tools (9)

### `execute` (~3766 tokens)

Execute Mermaid SDK code

Run JavaScript in an isolated sandbox; return a value.
One call composes edits. Submit JavaScript; declaration types are guidance.
No promises, async/await, dynamic import, or type annotations.
Hosted note: execute runs in an on-demand isolate and costs more than the direct
render_svg/render_ascii/render_png/verify/describe tools — prefer those for plain
render/verify calls. For straightforward structured edits, prefer the declarative
mutate/build tools; reserve execute for logic the ops don't express.
Hosted mermaid.renderMermaidSVG*, renderMermaidASCII*, and
layoutMermaidWithReceipt calls force security:'strict' and
embedFontImport:false; caller code cannot weaken that host policy.

SDK declaration:
type DiagramKind = 'flowchart' | 'state' | 'sequence' | 'timeline' | 'class' | 'er' | 'journey' | 'architecture' | 'xychart' | 'pie' | 'quadrant' | 'gantt' | 'mindmap' | 'gitgraph' | 'radar'
type MutationOp = { kind: string; [field: string]: unknown }
type Result<T, E = { code: string; message: string }> = { ok: true; value: T } | { ok: false; error: E }
interface SourceLocation { readonly line: number; readonly col: number }
interface SourceMapSpans { readonly preserved: PreservedSourceSpans; readonly nodes: ReadonlyMap<string, SourceSpan>; readonly edges: ReadonlyMap<string, SourceSpan>; readonly groups: ReadonlyMap<string, SourceSpan>; readonly labels: ReadonlyMap<string, SourceSpan> }
interface SourceMap { readonly nodes: ReadonlyMap<string, SourceLocation>; readonly edges: ReadonlyMap<string, SourceLocation>; readonly groups: ReadonlyMap<string, SourceLocation>; readonly labels: ReadonlyMap<string, SourceLocation>; readonly spans?: SourceMapSpans }
interface ValidDiagram { readonly kind: DiagramKind; readonly source: SourceMap }
type ExternalFamilyId = `family:${string}`
interface ExtensionCompatibility {
  readonly [contract: string]: string | undefined
  readonly core?: string
  readonly scene?: string
}
interface ExtensionProvenance { readonly owner: string; r…

Input parameters:

- `code` (string, required): JavaScript to execute; mermaid.* SDK is global.
- `timeoutMs` (integer): Optional CPU-time budget (default 5000ms, max 30000ms).

### `describe_sdk` (~106 tokens)

Describe Mermaid SDK operations

Return version-matched mutation operations for one diagram family.
Use detail=signatures for the compact op menu or detail=fields (default) for exact
field types, required flags, enum values, defaults, and constraints. Call this
before build, mutate, or execute when the family schema is not already known.

Input parameters:

- `detail` (string): signatures for a compact menu; fields for the complete schema (default).
- `family` (string, required): Diagram family whose mutation operations are needed.

### `render_svg` (~218 tokens)

Render Mermaid as SVG

Render a Mermaid source string to themeable SVG. Returns { ok, svg }.
Layout is deterministic: identical input produces identical geometry. The hosted
boundary forces security:'strict' and embedFontImport:false.

Input parameters:

- `options` (object): Shared advanced RenderOptions object. Styles accept a registered Look (crisp, hand-drawn, excalidraw, pen-and-ink, freehand, watercolor, blueprint, look:tufte, accessible-high-contrast, patent-drawin…
- `source` (string, required): Mermaid source.

### `render_ascii` (~129 tokens)

Render Mermaid as text

Render a Mermaid source string to text. Returns { ok, text }.
useAscii true → plain ASCII (+,-,|); false/absent → Unicode box drawing (┌,─,│).
targetWidth sets a hard terminal display-cell bound; impossible bounds return a typed error.

Input parameters:

- `options` (object): Shared advanced RenderOptions object, including style/palette/config/security.
- `source` (string, required): Mermaid source.
- `targetWidth` (integer): Hard maximum line width in terminal display cells.
- `useAscii` (boolean): true = ASCII characters, false = Unicode (default).

### `render_png` (~150 tokens)

Render Mermaid as PNG

Rasterize a Mermaid source string to PNG. Returns { ok, png_base64 }.
Hosted rendering uses resvg-wasm with bundled fonts; bytes may differ from the
local napi renderer, so hosted PNG is a convenience surface, not part of the
byte-determinism contract. For file/URL artifacts use the local stdio server.

Input parameters:

- `background` (string): Portable basic color or hex color painted behind the raster artifact.
- `fitTo` (object): Exactly one output width or height constraint.
- `options` (object): Shared advanced RenderOptions object.
- `scale` (number): Positive output scale used when no fitTo constraint is supplied.
- `source` (string, required): Mermaid source.

### `verify` (~115 tokens)

Verify Mermaid diagram

Parse and verify a Mermaid diagram without rendering it. Returns
{ ok, family, summary, warnings, layout: { bounds, nodes, edges } } for valid
diagrams and { ok: false, errors } for parse failures. `family` is the detected
diagram family and `summary` a one-line description — check them: ok:true only
means the diagram is structurally valid, not that it is the kind you intended.
Warnings use the layout-rubric codes.

Input parameters:

- `source` (string, required): Mermaid source.

### `describe` (~105 tokens)

Describe Mermaid diagram

Describe a Mermaid diagram. format=text returns { ok, text } with
one or two summary sentences; format=json returns { ok, tree } with the AX tree;
format=facts returns { ok, facts } with deterministic semantic fact lines for
machine checking (for example edge A -> B : label, member Duck +quack()).

Input parameters:

- `format` (string): text (default), json AX tree, or facts semantic read-back.
- `source` (string, required): Mermaid source.

### `mutate` (~239 tokens)

Edit Mermaid diagram

Apply a list of structured edit ops to an existing Mermaid `source` and
return the edited diagram. This is the declarative counterpart to `execute`:
plain JSON in, plain JSON out, no sandbox. Prefer it for straightforward edits;
reserve `execute` for logic the ops don't express.
Returns { ok, family, source, verify:{ ok, warnings } } on success, or
{ ok:false, family, opIndex, error } — where `error` names the offending field
and lists the valid ones — when an op is malformed or cannot apply. Ops apply in
order and are all-or-nothing: the first failing op stops the batch (its position
is `opIndex`) and the input is left untouched.
Each op is { "kind": <op>, …fields }. Call `describe_sdk` for the detected
family before authoring unfamiliar ops; it returns compact signatures or exact
field types, enum values, defaults, and constraints.

Input parameters:

- `ops` (array, required): Non-empty ordered list of edit ops; each is { kind, ...fields }.
- `source` (string, required): Mermaid source to edit.

### `build` (~158 tokens)

Build Mermaid diagram

Author a new Mermaid diagram from blank by folding a list of structured ops
over an empty diagram of `family`. The declarative counterpart to hand-writing
source. Returns the same envelope as `mutate`:
{ ok, family, source, verify } or { ok:false, family, opIndex, error }.
Call `describe_sdk` for the family before authoring unfamiliar ops.

Input parameters:

- `family` (string, required): Diagram family to author (one of: flowchart, state, sequence, timeline, class, er, journey, architecture, xychart, pie, quadrant, gantt, mindmap, gitgraph, radar).
- `ops` (array, required): Non-empty ordered list of ops; each is { kind, ...fields }.

## Diagnostics

Captured diagnostic sections: TLS, DNSSEC, Authorisation, Transports. The full working is on the page: https://verifymcp.io/servers/adewale-agentic-mermaid/agentic-mermaid#diagnostics

## Score history

- 2026-08-03: 70
- 2026-08-02: 69
- 2026-08-01: 69
- 2026-07-31: 68
- 2026-07-30: 63
- 2026-07-29: 63
- 2026-07-28: 62
- 2026-07-27: 16
- 2026-07-26: 16

## Links

- Remote endpoint: https://agentic-mermaid.dev/mcp
- Repository: https://github.com/adewale/agentic-mermaid
- Website: https://agentic-mermaid.dev/
- Changelog RSS feed: https://verifymcp.io/servers/adewale-agentic-mermaid/agentic-mermaid/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/adewale-agentic-mermaid/agentic-mermaid/changelog.json
- HTML version of this page: https://verifymcp.io/servers/adewale-agentic-mermaid/agentic-mermaid