{"report":{"v":1,"package":"mcp-excalidraw-server","version":"2.2.0","ranAt":"2026-11-16T11:30:11.746Z","install":{"ok":true,"bin":"mcp-excalidraw-server","integrity":"sha512-hgvg8Q8o05YtY8vJk7XT6K+p7uoADR/g6iRq0Y61iBA9j6eIZRpNIeeqD7vg3Lwk/zfS+lfYVcYAZemPl8N9Zw==","deps":157,"scripts":[],"bins":["mcp-excalidraw-server","excalidraw-canvas"],"license":"MIT","engines":"node >=20.0.0","repository":"https://github.com/yctimlin/mcp_excalidraw.git"},"start":{"ok":true,"ms":292,"serverName":"mcp-excalidraw-server","serverVersion":"2.2.0","protocol":"2025-06-18","stderr":"Canvas server running at http://127.0.0.1:3000 — screenshots render headless; open it in a browser to watch or for mermaid conversion.\n"},"tools":[{"name":"create_element","description":"Create a new Excalidraw element. For arrows, use startElementId/endElementId to bind to shapes (auto-routes to edges).","params":["id","type","x","y","width","height","backgroundColor","strokeColor","strokeWidth","strokeStyle","roughness","opacity","text","fontSize","fontFamily","startElementId","endElementId","endArrowhead","startArrowhead"]},{"name":"update_element","description":"Update an existing Excalidraw element","params":["id","type","x","y","width","height","backgroundColor","strokeColor","strokeWidth","strokeStyle","roughness","opacity","text","fontSize","fontFamily"]},{"name":"delete_element","description":"Delete an Excalidraw element","params":["id"]},{"name":"query_elements","description":"Query Excalidraw elements with optional filters","params":["type","filter","bbox"]},{"name":"get_resource","description":"Get an Excalidraw resource","params":["resource"]},{"name":"group_elements","description":"Group multiple elements together","params":["elementIds"]},{"name":"ungroup_elements","description":"Ungroup a group of elements","params":["groupId"]},{"name":"align_elements","description":"Align elements to a specific position","params":["elementIds","alignment"]},{"name":"distribute_elements","description":"Distribute elements evenly","params":["elementIds","direction"]},{"name":"lock_elements","description":"Lock elements to prevent modification","params":["elementIds"]},{"name":"unlock_elements","description":"Unlock elements to allow modification","params":["elementIds"]},{"name":"create_from_mermaid","description":"Convert a Mermaid diagram to Excalidraw elements and render them on the canvas","params":["mermaidDiagram","config"]},{"name":"batch_create_elements","description":"Create multiple Excalidraw elements at once. For arrows, use startElementId/endElementId to bind arrows to shapes — Excalidraw auto-routes to element edges. Assign custom id to shapes so arrows can reference them.","params":["elements"]},{"name":"get_element","description":"Get a single Excalidraw element by ID","params":["id"]},{"name":"get_selection","description":"Get the IDs of currently selected elements on the canvas","params":[]},{"name":"clear_canvas","description":"Clear all elements from the canvas","params":[]},{"name":"export_scene","description":"Export the current canvas to .excalidraw JSON format. Optionally write to a file; a path ending in .md is written in the Obsidian Excalidraw plugin format (.excalidraw.md).","params":["filePath"]},{"name":"import_scene","description":"Import elements and image files from .excalidraw JSON, Obsidian .excalidraw.md, a PNG with an embedded Excalidraw scene, or raw JSON data","params":["filePath","data","mode"]},{"name":"export_to_image","description":"Export the current canvas to a PNG or SVG image. Renders headless in the canvas server (no browser tab needed); SVGs embed fonts. Set embedScene: true for a PNG that is also editable in Excalidraw.","params":["format","filePath","background","renderer","dark","scale","padding","elementIds","frameId","embedScene"]},{"name":"duplicate_elements","description":"Duplicate elements with a configurable offset","params":["elementIds","offsetX","offsetY"]},{"name":"snapshot_scene","description":"Save a named snapshot of the current canvas state for later restoration","params":["name"]},{"name":"restore_snapshot","description":"Restore the canvas from a previously saved named snapshot","params":["name"]},{"name":"describe_scene","description":"Get an AI-readable description of the current canvas: element types, positions, connections, labels, spatial layout, and bounding box. Use this to understand what is on the canvas before making changes.","params":[]},{"name":"get_canvas_screenshot","description":"Render the current canvas to a PNG and return it as an image. Renders headless in the canvas server (no browser tab needed). Use this to visually verify what the diagram looks like.","params":["background","renderer","dark","scale","padding","elementIds","frameId","embedScene"]},{"name":"read_diagram_guide","description":"Returns a comprehensive design guide for creating beautiful Excalidraw diagrams: color palette, sizing rules, layout patterns, arrow binding best practices, diagram templates, and anti-patterns. Call this before creating diagrams to produce professional results.","params":[]},{"name":"export_to_excalidraw_url","description":"Export the current canvas to a shareable excalidraw.com URL. The diagram is encrypted and uploaded; anyone with the URL can view it. Returns the shareable link.","params":[]},{"name":"set_viewport","description":"Control the canvas viewport (camera). Auto-fit all elements, zoom-to-fit a subset of elements, center on a specific element, or set zoom/scroll directly. Requires the canvas frontend open in a browser.","params":["scrollToContent","scrollToElementIds","viewportZoomFactor","scrollToElementId","zoom","offsetX","offsetY"]}],"toolsHash":"bd269b5b55b39540f93a924c4563590b227337127f672b4592e631eb438fb65c","wrote":["/tmp/.local/state/excalidraw-mcp/excalidraw.log","/tmp/.local/state/excalidraw-canvas/server-3000.pid"],"callsAt":"2026-11-16T11:30:25.216Z","calls":[{"tool":"get_selection","ok":true,"ms":10,"bytes":44},{"tool":"describe_scene","ok":true,"ms":5,"bytes":45},{"tool":"read_diagram_guide","ok":true,"ms":1,"bytes":4300}],"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":27,"wrote":2,"callsTried":3,"callsAnswered":3,"callContacts":[]},"history":[{"package":"mcp-excalidraw-server","version":"2.2.0","ranAt":"2026-11-16T11:30:11.746Z","outcome":"started","tools":27,"contacts":0,"flags":0,"serious":0,"toolsHash":"bd269b5b55b39540f93a924c4563590b227337127f672b4592e631eb438fb65c"}],"page":"https://bragproof.smaverk.com/r/mcp-excalidraw-server"}