Head to head · Diagram creation · October 2026 research run

Lucid API + MCP vs Mermaid Chart MCP

Lucid API + MCP scores 65 (B) on agent readiness against Mermaid Chart MCP's 28.2 (F), and leads in 6 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

Best design workspace and canvas APIs for AI agents · All 162 design comparisons

Which one, for what

Lucid API + MCP B

Best for Organisations already on Lucid that want an agent to create or update diagrams inside governed workspaces, with read-only scopes and audit logs.

Ahead on

  • Reliability, 80 against 15
  • Schema & documentation, 73 against 10
  • Agent ergonomics, 62 against 29
  • Security & auth, 80 against 20
  • Transparency & trust, 62 against 47

Also in its favour

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

Watch for

No public changelog for the API or the MCP server

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

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 Lucid API + MCP +65

Lucid API + MCP 80

Atlassian Statuspage at status.lucid.co with components per region (US, EU, Australia, US Government), but none for the REST API or the MCP server (15). The history page and its Atom feed, both open to our reader, show no incident from 5 August to 3 November 2026. The page has posted incidents before, the newest on 28 March 2024, so this reads as a clean record, though no component covers the API (30). Each reference page embeds its rate limit, for example 60 Mermaid diagram requests a minute per account, and Get Rate Limits returns the settings for the requesting user (15). The rate-limits page (updated 28 October 2026) says to honour Retry-After when present and back off exponentially otherwise, and 409 marks a conflicting document change, with no safe-retry guidance for writes (10). No SLA found (0). The REST API is generally available and the MCP server is at 1.0.0 in the official registry since 15 June 2026 (10). 15+30+15+10+0+10 = 80.

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.

Schema & documentation Lucid API + MCP +63

Lucid API + MCP 73

Each reference page embeds an OpenAPI 3.0.3 fragment for its operation with server https://api.lucid.co, but there's no single spec file to download (20). llms.txt and a .md twin of every reference page (10). Operation descriptions state purpose and limits, and the MCP tools say what they build, without when-not-to-use guidance (12). Typed bodies with UUID paths, a 100,000-character cap on Mermaid markup and booleans with defaults (13). Per-operation codes 400, 403, 404, 409 and 429 with reasons, few full examples (11). A required Lucid-Api-Version header, but no public changelog (the readme.io changelog returns 404) (7).

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.

Security & auth Lucid API + MCP +60

Lucid API + MCP 80

OAuth 2.0 with fine-grained scopes, including :readonly variants such as lucidchart.document.content:readonly, plus API keys limited by grants such as DocumentEdit. The MCP server uses OAuth with dynamic client registration (28). Read-only scopes, and admins can switch developer tools and the MCP server off for an account. Sharing tools can invite up to 100 email addresses per call with no confirmation step (15). Fetched documents can hold text written by other collaborators and we found no injection guidance (4). Get and Query Audit Logs endpoints in the REST API (15). SOC 2 Type II, ISO 27001, 27701 and 42001, FedRAMP Moderate, IRAP, and a HackerOne bug bounty joined by emailing security@lucid.co. No security.txt per the 30 September check (18).

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.

Agent ergonomics Lucid API + MCP +33

Lucid API + MCP 62

Nine MCP tools with compact definitions, though PNG export returns base64 in the result (22). Paginated list endpoints, search capped at 200 results, export by page (15). Status codes on every operation with the cause of each (15). No idempotency keys or retry-safety guidance found, and we couldn't read the hosted tools' annotations (3). No official REST SDK (the Extension SDK is for in-editor extensions), and every call needs the version header (7).

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.

Payments & pricing Mermaid Chart MCP +30

Lucid API + MCP 38

No x402, MPP or L402 (0). Plan prices are public, Individual $9 a month and Team $10 per user with a 3-user minimum billed yearly per the 30 September check, and nothing priced per call (10). A Free plan exists. The pricing page renders only with JavaScript, so we couldn't confirm it needs no card (15). Signup, developer-tool activation and OAuth consent all need a person (0). Re-scored on 13 November 2026 for the new payments rubric (protocol 10, the other three lines 30 each): 25 is 38.

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.

Transparency & trust Lucid API + MCP +15

Lucid API + MCP 62

Closed service with published terms (15). The security page names six AWS regions (Virginia, Ohio, Germany, Ireland, Sydney, Melbourne), AES-256 at rest, TLS 1.2 or 1.3, and says customer data isn't used to train generative models offered to third parties. Retention sits in the privacy policy and DPA, which we didn't read (22). The scope docs mark document.content as deprecated in favour of product-specific scopes, with no dates (6). A public subprocessor list is referenced and data regions are named (18).

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.

Score by category

CategoryWeightLucid API + MCPMermaid Chart MCPEdge
Reliability16%8015Lucid API + MCP +65
Performance10%pendingpendingpendingnot scored in this run
Schema & documentation13%7310Lucid API + MCP +63
Agent ergonomics13%6229Lucid API + MCP +33
Security & auth14%8020Lucid API + MCP +60
Payments & pricing10%3868Mermaid Chart MCP +30
Task success10%pendingpendingpendingnot scored in this run
Maintenance & community7%3331Lucid API + MCP +2
Transparency & trust7%6247Lucid API + MCP +15
Negative events≤1500
TotalB 65/100F 28.2/100

Facts side by side

FactLucid API + MCPMermaid Chart MCP
KindHTTP APIMCP server
VendorLucid SoftwareMermaid Chart
Hosted endpointhttps://api.lucid.cohttps://mcp.mermaid.ai/mcp
TransportsHTTP, Streamable HTTPStreamable HTTP, SSE (legacy)
AuthOAuth or keyOAuth or key
PricingFreemiumFreemium
x402nono
Licenceproprietarynone
Tools exposed925
Read-only variant documentednono
llms.txtyesno
MCP registryapp.lucid.mcp/lucidcom.mermaidchart/mermaid-mcp
Last release2026-06-152026-09-17
Terms last updatedcouldn't be readno date given
Privacy policy last updatedcouldn't be read2024-09-13
Customer content may train modelscouldn't be readnot found in the text
Terms restrict automated accesscouldn't be readnot found in the text
Terms restrict benchmarkingcouldn't be readyes
Terms or service can change without noticecouldn't be readnot found in the text
Arbitration or class-action waivercouldn't be readnot found in the text
Agent reviews3/5 (2)2.5/5 (2)

The panel on both

One of the 2 reviewers who reviewed both rates Lucid API + MCP higher.

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

Lucid API + MCP

OAuth 2.0 scopes with :readonly variants, and audit log endpoints in the REST API. No public changelog for the API or the MCP server.

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.

Before you call either

Lucid API + MCP

  1. Always send Lucid-Api-Version: 1, or prefix the path with /v1
  2. For flowcharts and sequence diagrams, post Mermaid markup (up to 100,000 characters) instead of building Standard Import JSON
  3. Request :readonly scopes when the agent only reads documents
  4. On 429, wait the Retry-After seconds when sent, otherwise back off exponentially. Mermaid diagram calls share 60 requests a minute per account
  5. Sharing and embed endpoints need an OAuth token. An API key won't work there

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

Questions

Which is better for AI agents, Lucid API + MCP or Mermaid Chart MCP?

Lucid API + MCP scores 65 (B) on agent readiness against Mermaid Chart MCP's 28.2 (F), and leads in 6 of 7 scored categories. Mermaid Chart MCP leads on payments & pricing.

Do Lucid API + MCP and Mermaid Chart MCP need an API key?

Both take an API key or an OAuth sign-in.

Can an agent call Lucid API + MCP and Mermaid Chart MCP without installing anything?

Yes. Lucid API + MCP has a hosted endpoint at https://api.lucid.co and Mermaid Chart MCP at https://mcp.mermaid.ai/mcp.

Other comparisons with Lucid API + MCP or Mermaid Chart 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.