{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_353yk9hjcsz5","handle":"iflow-mcp-andrewginns-mermaid-mcp-server","url":"https://wellknown.network/agents/iflow-mcp-andrewginns-mermaid-mcp-server","links":{"self":"https://wellknown.network/agents/iflow-mcp-andrewginns-mermaid-mcp-server/record.json","html":"https://wellknown.network/agents/iflow-mcp-andrewginns-mermaid-mcp-server","markdown":"https://wellknown.network/agents/iflow-mcp-andrewginns-mermaid-mcp-server/record.md","api":"https://wellknown.network/api/v1/agents/iflow-mcp-andrewginns-mermaid-mcp-server","status":"https://wellknown.network/api/v1/agents/iflow-mcp-andrewginns-mermaid-mcp-server/status","claim":"https://wellknown.network/agents/iflow-mcp-andrewginns-mermaid-mcp-server/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/iflow-mcp-andrewginns-mermaid-mcp-server/claim.json","badge":"https://wellknown.network/agents/iflow-mcp-andrewginns-mermaid-mcp-server/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/iflow-mcp-andrewginns-mermaid-mcp-server/history","tools":"https://wellknown.network/api/v1/agents/iflow-mcp-andrewginns-mermaid-mcp-server/tools"},"ard":{"identifier":"urn:air::server:iflow-mcp-andrewginns-mermaid-mcp-server","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"iflow-mcp_andrewginns-mermaid-mcp-server","summary":"MCP server for validating Mermaid diagrams","description":"# Mermaid MCP Server\n\nA Model Context Protocol (MCP) server for validating Mermaid diagrams.\n\nImplements a minimal Python wrapper over https://github.com/mermaid-js/mermaid-cli for simpler out of the box use.\n\n## Overview\n\nPython MCP server for validating Mermaid diagrams and (optionally) rendering them as PNG images. It uses the Mermaid CLI tool to perform the validation and rendering.\n\nThe server provides LLMs with structured validation results including:\n- **Boolean validation status** (`is_valid: true/false`) indicating whether the Mermaid diagram syntax is correct\n- **Detailed error messages** explaining exactly what went wrong if validation fails (e.g., syntax errors, unsupported diagram types, malformed nodes)\n- **Optional base64-encoded PNG images** of successfully rendered diagrams for visual verification\n\nThis enables LLMs to programmatically validate Mermaid diagram syntax, understand specific errors to provide helpful corrections, and optionally receive visual confirmation of the rendered output.\n\nAlso provides a simple Pydantic-AI MCP Client to invoke the MCP server using a Gemini model for testing.\n\n## Prerequisites\n\n**Important**: This MCP server requires Node.js to be installed on your system, even if you're only using the server component (not the client). The server internally calls `npx @mermaid-js/mermaid-cli` as a subprocess to perform diagram validation and rendering.\n\n### Required Dependencies\n\n- **Node.js** with npm (required for all usage)\n- **Mermaid CLI**: Install with `npm install -g @mermaid-js/mermaid-cli`\n- **Python** with uv (for running the MCP server)\n\n### Quick Dependency Setup\n\n```bash\n# Install Mermaid CLI globally\nnpm install -g @mermaid-js/mermaid-cli\n\n# Verify installation\nnpx @mermaid-js/mermaid-cli --version\n```\n\n## Quickstart\n\nTo use this server with an MCP client (like Claude Desktop), add the following configuration to your MCP settings:\n\n**Note**: Make sure you have Node.js and Mermaid CLI installed (see Prerequisites a…","publisher":null,"homepage":null,"repository":null,"version":"11.4.2","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:iflow-mcp_andrewginns-mermaid-mcp-server","type":"package_pypi","auth":null,"probeable":false}],"skills":null,"tools":null,"extra":null,"attribution":{"kind":"pypi","name":"pypi","summary":"pypi","version":"pypi","description":"pypi"}},"derived":{"capabilities":[{"slug":"dev.package-management","name":"Packages & Dependencies","confidence":0.814,"provenance":"derived"}],"categories":["dev"],"language":"en"},"observed":{"status":"unknown","statusReason":"Distributed as a package to run locally; no network endpoint to check.","lastOkAt":null,"lastProbedAt":null,"statusComputedAt":null,"reliability30d":null,"latestObservations":[],"tools":null,"package":{"name":"iflow-mcp_andrewginns-mermaid-mcp-server","registry":"pypi","observedAt":"2026-11-09T07:25:27.419Z","publishedAt":"2026-02-05T06:38:45.642004Z","latestVersion":"11.4.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"iflow-mcp_andrewginns-mermaid-mcp-server","url":"https://pypi.org/project/iflow-mcp_andrewginns-mermaid-mcp-server/","firstSeenAt":"2026-09-09T17:22:32.569Z","fetchedAt":"2026-11-09T07:24:11.118Z","normalizedAt":"2026-11-09T07:24:11.118Z"}]},"firstSeenAt":"2026-09-09T17:22:32.569Z","updatedAt":"2026-11-09T07:25:27.419Z"}