{"report":{"v":1,"package":"@diagrammo/dgmo-mcp","version":"0.29.15","ranAt":"2026-11-16T11:44:53.177Z","install":{"ok":true,"integrity":"sha512-JBggRlMsH2dk4/oEmu+0mT9EJdJ3V0RO4BVKE+DivEt6MW6cVaQiu9MO8eJF1P2uxTV7Q/6gNrfqRujrQdILtg==","deps":148,"scripts":[],"bins":["dgmo-mcp"],"license":"MIT","engines":"node >=20.6","repository":"https://github.com/diagrammo/dgmo-mcp.git","bin":"dgmo-mcp"},"start":{"ok":true,"ms":338,"serverName":"dgmo","serverVersion":"0.29.15","protocol":"2025-06-18"},"tools":[{"name":"render_diagram","description":"Render DGMO markup to SVG or PNG. Returns SVG text or base64 PNG image. When format is \"png\", also saves the image to a temp file and returns the path. For DGMO syntax call get_language_reference.","params":["dgmo","format","theme","palette","width","height"]},{"name":"share_diagram","description":"Generate a shareable diagrammo.app URL for a DGMO diagram. The source is compressed into the URL fragment, so nothing is uploaded and the link works for anyone who opens it; returns the URL as text. Errors when the compressed source exceeds the URL size limit (the error reports both sizes) — split or simplify the diagram, or use open_in_app / render_diagram instead. The source is not validated here; call validate_diagram first.","params":["dgmo"]},{"name":"open_in_app","description":"Open a DGMO diagram in the Diagrammo desktop app (macOS only). Falls back to browser preview if the app is not installed. Pass `filePath` to open a saved .dgmo file directly — the app opens THAT file, so in-app edits autosave back to it (one editable source of truth, live re-render). This is the preferred path when the app is installed: write the .dgmo source first, then open it here. Omit `filePath` for an ephemeral diagram (sends a deep link; the app creates its own copy).","params":["dgmo","filePath"]},{"name":"check_app_installed","description":"Check whether the Diagrammo desktop app is installed. Returns a sentence naming the output route the product prefers, plus JSON `{ installed, paths, platform }`. Detection is macOS-only; other platforms always report not installed. The answer does not change within a session, so one call is enough before deciding how to show a diagram: when installed, the preferred route is open_in_app with `filePath`; otherwise share_diagram.","params":[]},{"name":"list_chart_types","description":"List all supported DGMO chart types with descriptions.","params":[]},{"name":"get_language_reference","description":"Get the DGMO language reference. With `chart_type`, returns that type's section plus the universal rules every diagram follows (the closed color set, titles, categorize-and-color). Without it, returns the entire reference for all chart types, which is very large (hundreds of KB); pass `chart_type` whenever the type is known. Errors when the type has no documented section — call list_chart_types for the valid ids. suggest_chart_type already appends the chosen type's section, so a call here is only needed after the user picks a type or when switching types.","params":["chart_type"]},{"name":"preview_diagram","description":"Render one or more DGMO diagrams and open an HTML preview in the browser. Supports theme toggle and optional source display. For DGMO syntax call get_language_reference.","params":["diagrams","theme","palette","include_source"]},{"name":"generate_report","description":"Generate a polished HTML report with multiple DGMO diagrams, table of contents, and optional source blocks. Opens in browser by default. For DGMO syntax call get_language_reference.","params":["title","subtitle","sections","theme","palette","include_source","open"]},{"name":"validate_diagram","description":"Validate DGMO markup without rendering. Returns structured parse errors and warnings. Much faster than render_diagram — use this to check syntax before rendering.","params":["dgmo"]},{"name":"suggest_chart_type","description":"Suggest the best DGMO chart type for a user's plain-English diagram request.\n\nCall this first when creating a new diagram: it ranks the chart types against the request and, on a confident pick, appends that type's language-reference section, so no separate get_language_reference call is needed. It is not needed when editing an existing diagram, whose first line already declares its type.\n\nReturns one of two shapes: (1) a confident pick (high/medium) with the top match's syntax, or (2) an '⚠️ ASK THE USER' result when the choice is ambiguous or nothing matched. On an ASK-THE-USER result, present the listed candidates to the user and wait for their choice before generating, because the request alone does not settle which type they want.","params":["prompt"]},{"name":"get_examples","description":"Get example DGMO diagrams for a chart type. Returns real-world examples from the gallery that demonstrate syntax patterns. Use these as few-shot references when generating new diagrams.","params":["chart_type"]},{"name":"put_space_diagram","description":"Write a DGMO diagram into a Diagrammo Cloud space, by folder and title: updates the diagram with that title in that folder, or creates it (private) when there is none. Re-sending identical source changes nothing. Returns JSON `{ action: \"created\" | \"updated\", id, title, folder, version }`. Needs DGMO_API_KEY (a space API key) in the server environment. Errors name the cause: 401 bad or revoked key, 403 not allowed, 404 no such space or folder, 409 another write landed first (call again). Call validate_diagram first; this does not validate.","params":["space_id","title","dgmo","folder"]},{"name":"get_space_diagram","description":"Read a diagram from a Diagrammo Cloud space, by `id` or by `title` in `folder`. Titles match case-insensitively. Returns JSON `{ id, title, folder, chartType, version, updatedAt, source }`. Needs DGMO_API_KEY (a space API key) in the server environment. Errors when the key is refused (401/403) or nothing matches (404); list_space_diagrams shows what is there.","params":["space_id","id","title","folder"]},{"name":"list_space_diagrams","description":"List every diagram in a Diagrammo Cloud space. Returns JSON `{ diagrams: [{ id, title, folder, chartType, version, updatedAt }] }`, sorted by folder then title. Needs DGMO_API_KEY (a space API key) in the server environment.","params":["space_id"]}],"toolsHash":"796c0220ed6f4675872388669ab823d44e7de0447918b804e4266c3ca7da7df5","wrote":[],"callsAt":"2026-11-16T11:45:01.178Z","calls":[{"tool":"list_chart_types","ok":true,"ms":3,"bytes":4079},{"tool":"get_language_reference","ok":true,"ms":6,"bytes":256138},{"tool":"get_examples","ok":true,"ms":2,"bytes":1777}],"host":{"commit":"eaaffffaf52255d1b77dc4aacffdfaf353f0c12c","run":"https://github.com/itsHaddad/bragproof/actions/runs/43857070216"},"network":{"names":["registry.npmjs.org"],"conns":[],"callNames":[],"callConns":[]}},"summary":{"outcome":"started","needs":[],"contacts":[],"flags":[],"tools":14,"wrote":0,"callsTried":3,"callsAnswered":3,"callContacts":[]},"history":[{"package":"@diagrammo/dgmo-mcp","version":"0.29.15","ranAt":"2026-11-16T11:44:53.177Z","outcome":"started","tools":14,"contacts":0,"flags":0,"serious":0,"toolsHash":"796c0220ed6f4675872388669ab823d44e7de0447918b804e4266c3ca7da7df5"}],"page":"https://bragproof.smaverk.com/r/%40diagrammo/dgmo-mcp"}