{"$schema":"https://wellknown.network/schemas/agent-record-v1.json","schemaVersion":"1","id":"ag_qqjqnekdvzd2","handle":"mermaid-mcp-2","url":"https://wellknown.network/agents/mermaid-mcp-2","links":{"self":"https://wellknown.network/agents/mermaid-mcp-2/record.json","html":"https://wellknown.network/agents/mermaid-mcp-2","markdown":"https://wellknown.network/agents/mermaid-mcp-2/record.md","api":"https://wellknown.network/api/v1/agents/mermaid-mcp-2","status":"https://wellknown.network/api/v1/agents/mermaid-mcp-2/status","claim":"https://wellknown.network/agents/mermaid-mcp-2/claim","claimApi":"https://wellknown.network/api/v1/claims","claimDescriptor":"https://wellknown.network/agents/mermaid-mcp-2/claim.json","badge":"https://wellknown.network/agents/mermaid-mcp-2/badge.svg","openapi":"https://wellknown.network/openapi.json","history":"https://wellknown.network/api/v1/agents/mermaid-mcp-2/history","tools":"https://wellknown.network/api/v1/agents/mermaid-mcp-2/tools"},"ard":{"identifier":"urn:air::server:mermaid-mcp-2","type":"application/mcp-server-card+json"},"kind":"mcp_server","declared":{"name":"mermaid-mcp","summary":"Python model context protocol(MCP) server for mermaid","description":"# Mermaid MCP\n\nModel Context Protocol server for Mermaid diagrams.\n\n## Overview\n\nMermaid-MCP provides a server and CLI interface for creating, validating, and rendering Mermaid diagrams. It uses the `mmdc` (Mermaid CLI) to generate static SVG, PNG, or PDF files from Mermaid diagram specifications.\n\n## Features\n\n- API server for diagram generation and validation\n- CLI tool for local diagram rendering\n- Custom theme support\n- Multiple output formats (SVG, PNG, PDF)\n- Support for all Mermaid diagram types\n\n## Installation\n\n```bash\n# Using pip\npip install mermaid-mcp\n\n# Using uv\nuv pip install mermaid-mcp\n```\n\n## Usage\n\n### CLI\n\n```bash\n# Generate a diagram\nmermaid-mcp cli chart flowchart diagram.mmd output.svg\n\n# Validate a diagram\nmermaid-mcp cli validate flowchart diagram.mmd\n```\n\n### Server\n\n```bash\n# Start the server\nmermaid-mcp server start\n\n# Install as a launch agent (macOS)\nmermaid-mcp server install --port=27312\n```\n\n## Theme Support\n\nMermaid-MCP supports several methods of applying themes to your diagrams:\n\n1. Built-in Mermaid themes: \"default\", \"forest\", \"dark\", \"neutral\", \"base\"\n2. Custom CSS themes from the `css/` directory\n3. Custom JSON theme configurations in the `themes/` directory\n\n### Using a Theme\n\n#### In CLI mode\n\n```bash\n# Use a built-in theme\nmermaid-mcp cli chart --theme=dark flowchart diagram.mmd output.svg\n\n# Use a CSS theme\nmermaid-mcp cli chart --css-theme=dark-mode flowchart diagram.mmd output.svg\n\n# Use a JSON theme\nmermaid-mcp cli chart --json-theme=forest-night flowchart diagram.mmd output.svg\n```\n\n#### In Server mode\n\n```json\n// Example request to /generate/flowchart\n{\n  \"input\": \"graph TD\\n  A[Start] --> B[End]\",\n  \"css_theme\": \"dark-mode\"\n}\n```\n\n### Creating Custom Themes\n\n#### CSS Themes\n\nCreate a CSS file in the `css/` directory with CSS variables for theming:\n\n```css\n/* my-theme.css */\n:root {\n  /* General theme */\n  --mermaid-primary-color: #282a36;\n  --mermaid-primary-border-color: #bd93f9;\n  --mermaid-primary-text-color: #f8f8…","publisher":null,"homepage":null,"repository":null,"version":"0.1.2","license":null,"protocols":["mcp"],"tags":["mcp"],"pricing":null,"endpoints":[{"url":"pypi:mermaid-mcp","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.filesystem","name":"Filesystem","confidence":0.802,"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":"mermaid-mcp","registry":"pypi","observedAt":"2026-11-03T17:26:11.281Z","publishedAt":"2025-05-15T05:22:58.430524Z","latestVersion":"0.1.2"},"toolSurface":null,"endpointFacts":[]},"verification":{"claimed":false,"claimedAt":null,"proofs":[]},"provenance":{"sources":[{"source":"pypi","key":"mermaid-mcp","url":"https://pypi.org/project/mermaid-mcp/","firstSeenAt":"2026-09-10T05:23:11.753Z","fetchedAt":"2026-11-03T17:25:30.792Z","normalizedAt":"2026-11-03T17:25:30.792Z"}]},"firstSeenAt":"2026-09-10T05:23:11.753Z","updatedAt":"2026-11-03T17:26:11.281Z"}