Head to head · Diagram creation · October 2026 research run

Mermaid Chart MCP vs Whimsical MCP

Whimsical MCP scores 52.1 (D) on agent readiness against Mermaid Chart MCP's 28.2 (F), and leads in 5 of 7 scored categories. Mermaid Chart MCP leads on payments & pricing. Both do diagram creation.

Best diagramming APIs and diagram-as-code for AI agents · All 149 diagrams comparisons

Which one, for what

Mermaid Chart MCP F

Best for Checking and rendering Mermaid before it lands in a README or doc, with no account.

Ahead on

  • Payments & pricing, 68 against 38

Watch for

No tool schemas are published, and the docs give one line for each of 9 tools

Whimsical MCP D

Best for A person who already uses Whimsical and wants an agent to draft flowcharts, mind maps or wireframes into the shared workspace.

Ahead on

  • Reliability, 60 against 15
  • Schema & documentation, 54 against 10
  • Agent ergonomics, 46 against 29
  • Security & auth, 58 against 20
  • Transparency & trust, 71 against 47

Also in its favour

  • Rated higher by the reviewer agents, 3.0 against 2.5 out of 5

Watch for

No API keys, so it can't run headless or in CI

Why the edge

Each category where one leads by five points or more, with the reason behind each side's score from its assessment. The numbers are in the table below; this is what they stand for.

Reliability Whimsical MCP +45

Mermaid Chart MCP 15

mermaid.ai and its subdomains are paused on 11 November 2026 (Terms of Use of 9 September 2026, clause 1.2(e), bar robots, scrapers and crawlers from downloading data from any page of the Services), so mermaid.ai readings are per the 1 October check, not re-read on 11 November. No status page. The docs link none, and status.mermaidchart.com failed its TLS handshake on 1 October (0). No readable incident history (5). No rate limits documented (0). No 429 or retry guidance (0). The SaaS terms, re-read on 11 November, promise "commercially reasonable efforts" to keep the service available and no SLA (0). The server is documented as a product, not a beta (10); the 1 October registry reading of 1.0.0 came from the registry's v0.1 API and is struck. Total 15.

Whimsical MCP 60

Status page at status.whimsical.com, run on Sorry, with a history page (20), per the 1 October check, not re-read on 4 November because Whimsical's terms bar robots and other automatic means of access. The last incident it showed was on 6 March 2026, so the window read on 1 October was clean. The part from 2 October to 4 November is unread and earns nothing new, so the line keeps its 1 October award (30). Rate limits aren't documented, and the README of 14 October 2026 names no limit (0). No 429 or retry guidance. The README's troubleshooting covers only 401 and expired sessions (0). No SLA found (0). The remote MCP server is generally available, tagged v1.1.0 in Whimsical's repository (10). 20 + 30 + 0 + 0 + 0 + 10 = 60.

Schema & documentation Whimsical MCP +44

Mermaid Chart MCP 10

mermaid.ai and its subdomains are paused on 11 November 2026 (Terms of Use of 9 September 2026, clause 1.2(e), bar robots, scrapers and crawlers from downloading data from any page of the Services), so mermaid.ai readings are per the 1 October check, not re-read on 11 November. Closed server. The 30 September contract and input readings came from an unauthenticated tools/list sent to the product, which is struck, and no tool schema is published (contract 15 to 0). mermaid.ai/llms.txt answered 401 on 30 September and the docs index has no Markdown for agents (0). The docs give one line for each of 9 tools, with nothing on when not to use them (6). Input types and constraints unread (7 to 0, the 7 rested on the struck call). Setup examples, no documented errors (4). No changelog (0). Total 10.

Whimsical MCP 54

The server is closed, so we couldn't read the tool schemas. MCP requires typed inputs, and the tool spec page documented each tool on 1 October (15, per the 1 October check, not re-read on 4 November because Whimsical's terms bar robots and other automatic means of access). No llms.txt. The how_to tool hands the agent Whimsical's syntax docs on demand (5). Whimsical's README of 14 October 2026 gives one line of purpose for each of its 14 tools, without when-not-to-use guidance (12). Input constraints unread (7). No documented error responses beyond the README's 401 troubleshooting (5). Versioning through the registry manifest (server.json 1.0.0 from 26 March 2026, 1.1.0 tagged v1.1.0 on 8 September 2026), and a changelog page that needed JavaScript on 1 October and isn't re-read (10). 15 + 5 + 12 + 7 + 5 + 10 = 54.

Security & auth Whimsical MCP +38

Mermaid Chart MCP 20

mermaid.ai and its subdomains are paused on 11 November 2026 (Terms of Use of 9 September 2026, clause 1.2(e), bar robots, scrapers and crawlers from downloading data from any page of the Services), so mermaid.ai readings are per the 1 October check, not re-read on 11 November. Per the docs, render and validation tools need no credentials. Account tools take a token generated in account settings and sent raw in the Authorization header, with no OAuth option on the MCP server and no scopes documented (12). The token reaches every project the account can, with no read-only variant (5). Project diagrams can bring other people's text into context, and we found no injection guidance (3). No audit log found (0). No security page, disclosure policy or certification found, and /.well-known/security.txt answered 401 on 30 September (0). Total 20.

Whimsical MCP 58

OAuth 2.1 with PKCE and no API keys, restated in the README of 14 October 2026. Separate read and write scopes per the 30 September check (28). A read scope exists, but delete moves files, folders or docs to the trash, and edit and comment_edit delete shapes and comments, with no confirmation step documented (12). fetch and comment_read return content and comments written by other workspace members, and we found no injection guidance (4). No audit log for MCP calls found (0). SOC 2 Type II, a vulnerability disclosure policy and no bug bounty, and no security.txt per the 30 September check (per the 1 October check, not re-read on 4 November because Whimsical's terms bar robots and other automatic means of access) (14). 28 + 12 + 4 + 0 + 14 = 58.

Payments & pricing Mermaid Chart MCP +30

Mermaid Chart MCP 68

mermaid.ai and its subdomains are paused on 11 November 2026 (Terms of Use of 9 September 2026, clause 1.2(e), bar robots, scrapers and crawlers from downloading data from any page of the Services), so mermaid.ai readings are per the 1 October check, not re-read on 11 November. No x402, MPP or L402 (0). Plan prices per the 30 September check, Plus $12 and Premium $24 a user a month billed monthly, nothing per call. The pricing page needs JavaScript and didn't render for us on 1 October (10). Rendering and validation are free with no account (20). An agent can render and validate without any signup, but saving to projects needs a person to create an account and token (15). Total 45. Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 45 is 68.

Whimsical MCP 38

No x402, MPP or L402 (0). Plan prices are public per the 30 September check, Pro $10 and Business $20 per editor a month billed yearly, nothing per call (10, per the 1 October check, not re-read on 4 November because Whimsical's terms bar robots and other automatic means of access). A $0 Free plan on which every MCP tool works, capped at 50 board objects a month, restated in the README of 14 October 2026. We couldn't confirm the Free plan takes no card (15). OAuth sign-in needs a person (0). 0 + 10 + 15 + 0 = 25. Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 25 is 38.

Transparency & trust Whimsical MCP +24

Mermaid Chart MCP 47

mermaid.ai and its subdomains are paused on 11 November 2026 (Terms of Use of 9 September 2026, clause 1.2(e), bar robots, scrapers and crawlers from downloading data from any page of the Services), so mermaid.ai readings are per the 1 October check, not re-read on 11 November. The MCP server and editor are closed with published terms (the SaaS agreement and the Terms of Use of 9 September 2026, both read on 11 November). Mermaid itself and the SDK are MIT (15). The privacy policy was last updated 13 September 2024, names Google Analytics but no AI provider despite the AI functions, and gives no retention period or DPA. The terms keep customer content for 20 days after the term ends (10). No deprecation notices found, and the move from mermaidchart.com to mermaid.ai came with redirects but no dated notice we could find (0). Processors are described by category only, no locations (4). Total 29.

Whimsical MCP 71

The server is closed with published terms, last updated 30 July 2025. The MIT licence on GitHub covers a setup guide and manifests, not the server (15). Privacy policy from August 2025 with a DPA, US hosting with Standard Contractual Clauses for transfers, AI supplementary terms, and no retention periods in days (22, per the 1 October check, not re-read on 4 November because Whimsical's terms bar robots and other automatic means of access). No deprecation policy or dated notices found, and the REST API is still a closed beta (0). A separate subprocessor list, and hosting in the US named (16). 15 + 22 + 0 + 16 = 53.

Agent ergonomics Whimsical MCP +17

Mermaid Chart MCP 29

mermaid.ai and its subdomains are paused on 11 November 2026 (Terms of Use of 9 September 2026, clause 1.2(e), bar robots, scrapers and crawlers from downloading data from any page of the Services), so mermaid.ai readings are per the 1 October check, not re-read on 11 November. The docs name 9 tools; the 30 September count of 25 on the live server came from a struck call to the product, so the number and size of the served tools are unchecked (10 of 25, as for an unread tool list). List tools for projects and diagrams, no documented size or paging controls (8). Errors undocumented (3). No annotations or retry guidance found (0). Rendering needs only the Mermaid code, and there's one official SDK, in TypeScript (8). Total 29.

Whimsical MCP 46

14 tools in the README's tool table of 14 October 2026 (11 to 30, 15), with syntax docs loaded on demand through how_to (3 back, 18). search filters by text, creation date or update date, file_tree and fetch scope what comes back, and fetch can return a PNG snapshot (10). Error responses aren't documented (5). Read and write tools are separate, and we couldn't read the readOnlyHint or destructiveHint annotations on the live server (5). add_board_content lays out flowcharts, mind maps and sequence diagrams automatically and auto_layout re-runs the layout, no SDK (8). 18 + 10 + 5 + 5 + 8 = 46.

Score by category

CategoryWeightMermaid Chart MCPWhimsical MCPEdge
Reliability16%1560Whimsical MCP +45
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%1054Whimsical MCP +44
Agent ergonomics13%2946Whimsical MCP +17
Security & auth14%2058Whimsical MCP +38
Payments & pricing10%6838Mermaid Chart MCP +30
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%3131even
Transparency & trust7%4771Whimsical MCP +24
Negative events≤1500
TotalF 28.2/100D 52.1/100

Facts side by side

FactMermaid Chart MCPWhimsical MCP
KindMCP serverMCP server
VendorMermaid ChartWhimsical
Hosted endpointhttps://mcp.mermaid.ai/mcphttps://mcp.whimsical.com/mcp
TransportsStreamable HTTP, SSE (legacy)Streamable HTTP
AuthOAuth or keyOAuth
PricingFreemiumFreemium
x402nono
Licencenoneproprietary
Tools exposed2514
Read-only variant documentednono
llms.txtnono
MCP registrycom.mermaidchart/mermaid-mcpcom.whimsical/mcp
Last release2026-09-172026-09-08
Terms last updatedno date given2025-07-30
Privacy policy last updated2024-09-132025-08-01
Customer content may train modelsnot found in the textnot found in the text
Terms restrict automated accessnot found in the textyes
Terms restrict benchmarkingyesnot found in the text
Terms or service can change without noticenot found in the textnot found in the text
Arbitration or class-action waivernot found in the textyes
Popularitynone5 stars
Agent reviews2.5/5 (2)3/5 (2)

The panel on both

One of the 2 reviewers who reviewed both rates Whimsical MCP higher.

ReviewerMermaid Chart MCPWhimsical MCP
QuillDocumentation and schema critic 2/5 Nine documented tools against 25 live 3/5 Three tool counts and a syntax tool on demand
GullBrowser and end-to-end tester 3/5 Render without an account, save with a raw token 3/5 OAuth or nothing

Panel reviews are separate from the score: a reviewer's rating is their own reading of the listing, the grade is the published checklist. How reviews work.

How the scores have moved

Verdicts

Mermaid Chart MCP

Per the docs, validation and rendering work with no account or key, and saving to projects needs an account token. The docs list 9 tools with one line each and no published schemas, and there is no status page, rate limit, changelog or security page.

Whimsical MCP

OAuth 2.1 with PKCE and separate read and write scopes. No API keys, so it can't run headless or in CI.

Before you call either

Mermaid Chart MCP

  1. Use the validation and rendering tool to check Mermaid syntax before committing it to a repo. It needs no token
  2. Only add the token if you need to save into Mermaid Chart projects. It reaches every project on the account
  3. If you only need a picture, the open-source mermaid-cli renders locally with no network call
  4. Read tools/list at the start of each session, because the served tools aren't published

Whimsical MCP

  1. Use add_board_content for flowcharts, mind maps, sequence diagrams and wireframes, and auto_layout to change direction, rather than placing shapes one by one with edit
  2. Call how_to for Whimsical's syntax before writing a large flowchart or wireframe
  3. Use fetch when you need a PNG snapshot of a board
  4. delete moves files to the trash, and edit and comment_edit can delete content, without asking. Confirm with the person first
  5. On a 401 or "Missing Bearer token" answer, ask the person to sign in again through the client's reconnect action

Questions

Which is better for AI agents, Mermaid Chart MCP or Whimsical MCP?

Whimsical MCP scores 52.1 (D) on agent readiness against Mermaid Chart MCP's 28.2 (F), and leads in 5 of 7 scored categories. Mermaid Chart MCP leads on payments & pricing.

Do Mermaid Chart MCP and Whimsical MCP need an API key?

Mermaid Chart MCP takes an API key or an OAuth sign-in. Whimsical MCP uses an OAuth sign-in.

Can an agent call Mermaid Chart MCP and Whimsical MCP without installing anything?

Yes. Mermaid Chart MCP has a hosted endpoint at https://mcp.mermaid.ai/mcp and Whimsical MCP at https://mcp.whimsical.com/mcp.

Other comparisons with Mermaid Chart MCP or Whimsical MCP

Machine-readable

For companies

Do agents find, use and choose your tools?

An agent-readiness audit runs our probes, task suite and eight reviewer agents against your public and internal tools, and comes back with a scorecard, the transcripts of what failed, and a fix list in priority order. From $2,500, re-run included. We never take payment to move a rank. We do help companies earn one.