{"report":{"v":1,"package":"@gethopp/figma-mcp-bridge","version":"0.0.27","ranAt":"2026-11-16T11:31:33.050Z","install":{"ok":true,"integrity":"sha512-gzbEsIl2HWAZL6MiUT7yvFnM3pu1qKMn1FcEoVx/WkYT6MLcyApSTBSVM0ncArd/7ChVna/InCXWcJadgXMmhg==","deps":97,"scripts":[],"bins":["figma-mcp-bridge"],"license":"MIT","engines":"node >=20.0.0","repository":"git+https://github.com/gethopp/figma-mcp-bridge.git","bin":"figma-mcp-bridge"},"start":{"ok":true,"ms":165,"serverName":"figma-bridge","serverVersion":"0.0.27","protocol":"2025-06-18","stderr":"Leader listening on 127.0.0.1:1994\nBecame LEADER\nStarting MCP server (role: LEADER)\n"},"tools":[{"name":"list_files","description":"List all currently connected Figma/FigJam files. Returns fileKey and fileName for each. Use the fileKey to target a specific file in other tools.","params":[]},{"name":"get_document","description":"Get the current Figma/FigJam page document tree. When multiple files are connected, specify fileKey.","params":["fileKey"]},{"name":"get_selection","description":"Get the currently selected nodes in Figma/FigJam. When multiple files are connected, specify fileKey.","params":["fileKey"]},{"name":"get_layout_tree","description":"Read absolute node transforms and layout bounds for a capture root. Separate screenshot calls are non-atomic.","params":["rootId","maxNodes","fileKey"]},{"name":"get_node","description":"Get a specific Figma/FigJam node by ID. Accepts top-level IDs like '4029:12345' and instance-child IDs like 'I12740:17806;12740:17793'. Never use hyphens. Pass includePrototype: true to also get the prototype interactions on the node and its descendants. When multiple files are connected, specify fileKey.","params":["nodeId","includePrototype","fileKey"]},{"name":"get_prototype_connections","description":"Read-only. List the prototype interactions on a node and all its descendants, including instance sublayers. Each reaction is Figma's own trigger and actions (navigate/swap/overlay/scroll-to/change-to, back, close, URL, set variable/mode, conditional blocks, media), with each destination resolved to its name, screen, and page, and variables and modes resolved to names. Also returns the page's flow starting points. Not available in FigJam. When multiple files are connected, specify fileKey.","params":["nodeId","maxNodes","includeEmpty","fileKey"]},{"name":"trace_prototype_flow","description":"Read-only. Follow prototype navigation breadth-first from a screen: returns the screens reached (with depth and the node that reached them) and every interaction edge with its source node, trigger, action, enclosing conditional branches, and destination screen. Screens reached again are marked as revisits; unresolvable destinations are listed. Not available in FigJam. When multiple files are connected, specify fileKey.","params":["nodeId","maxScreens","maxNodesPerScreen","fileKey"]},{"name":"get_styles","description":"Get all local styles in the document. When multiple files are connected, specify fileKey.","params":["fileKey"]},{"name":"get_metadata","description":"Get metadata about the current Figma/FigJam document including file name, pages, and current page info. When multiple files are connected, specify fileKey.","params":["fileKey"]},{"name":"get_design_context","description":"Get the design context for the current selection or page. Returns a summarized tree structure optimized for understanding the current design context. Works in both Figma and FigJam. When multiple files are connected, specify fileKey.","params":["depth","fileKey"]},{"name":"get_variable_defs","description":"Get all local variable definitions including variable collections, modes, and variable values. Variables are Figma's system for design tokens (colors, numbers, strings, booleans). When multiple files are connected, specify fileKey.","params":["fileKey"]},{"name":"get_screenshot","description":"Export a screenshot of the selected nodes or specific nodes by ID. Returns base64-encoded image data. Works in both Figma and FigJam. When multiple files are connected, specify fileKey.","params":["nodeIds","format","scale","clip","fileKey"]},{"name":"set_node_visibility","description":"Show or hide specific Figma nodes. Returns previous visibility for each node so you can restore them after. Useful for isolating a single layer before exporting: hide all siblings, export the frame, then restore visibility.","params":["items","fileKey"]},{"name":"set_text_content","description":"Update the contents of a text node. Works on TEXT nodes plus FigJam STICKY and SHAPE_WITH_TEXT nodes (their text sublayer). The plugin loads the node's fonts before applying the new text. Accepts either text or characters. When multiple files are connected, specify fileKey.","params":["nodeId","text","characters","fileKey"]},{"name":"set_text_properties","description":"Patch common text properties such as font family/style, size, line height, letter spacing, and fill color, plus alignment, auto-resize, and bounds on TEXT nodes. Also targets FigJam STICKY and SHAPE_WITH_TEXT text sublayers (alignment/auto-resize are TEXT-only). When multiple files are connected, specify fileKey.","params":["nodeId","fontFamily","fontStyle","fontSize","textAlignHorizontal","textAlignVertical","textAutoResize","lineHeightPx","letterSpacingPx","fillHex","fillOpacity","x","y","width","height","fileKey"]},{"name":"set_node_properties","description":"Patch common node properties such as name, position, size, visibility, opacity, and corner radius. Accepts either a single nodeId or a nodeIds array to apply the same changes to multiple nodes in one call. Only supported properties for the target node type may be changed. Use set_solid_fill or set_gradient_fill to change paints. Works in both Figma and FigJam. When multiple files are connected, specify fileKey.","params":["nodeId","nodeIds","name","x","y","width","height","rotation","opacity","visible","cornerRadius","fileKey"]},{"name":"set_node_constraints","description":"Set native Figma horizontal and/or vertical constraints on layers inside frames, components, or instances. Values: MIN, MAX, CENTER, STRETCH, SCALE. Rejects incompatible Auto Layout children (unless absolute positioned) and FigJam nodes. Accepts nodeId or nodeIds, preserves the unspecified axis, and returns previous and applied constraints.","params":["nodeId","nodeIds","horizontal","vertical","fileKey"]},{"name":"apply_paint_style","description":"Link an existing local Figma Paint Style to fills or strokes, preserving native style association. Supports nodeId or nodeIds; validates compatible nodes and returns verified style IDs with per-node errors for batches. Available in Figma Design, not FigJam or Dev Mode.","params":["nodeId","nodeIds","styleId","target","fileKey"]},{"name":"set_solid_fill","description":"Replace a node's fill (or stroke) with a single solid paint. Provide a hex color and optional paint opacity — fillHex/fillOpacity are accepted as aliases. Use set_gradient_fill for gradient paints.","params":["nodeId","hex","fillHex","opacity","fillOpacity","target","fileKey"]},{"name":"set_gradient_fill","description":"Replace a node's fill (or stroke) with a gradient paint. Provide ordered stops (position 0..1, hex color, optional alpha) and an optional 2x3 gradientTransform matching Figma's gradientTransform format. Useful for setting linear/radial/angular/diamond gradients programmatically.","params":["nodeId","gradientType","gradientStops","gradientTransform","opacity","target","fileKey"]},{"name":"set_effects","description":"Replace a node's effects list (drop/inner shadows, layer/background blurs). Pass an empty array to clear all effects. Each entry mirrors the shape returned by get_node's `effects` field.","params":["nodeId","effects","fileKey"]},{"name":"set_stroke_properties","description":"Patch stroke geometry properties: weight, align, dash pattern, cap, join. Use set_solid_fill/set_gradient_fill with target='stroke' to set the paint itself.","params":["nodeId","strokeWeight","strokeAlign","dashPattern","strokeCap","strokeJoin","fileKey"]},{"name":"set_auto_layout","description":"Configure auto-layout on a frame: direction, gap, padding, alignment, sizing modes, wrap. Set layoutMode='NONE' to disable auto-layout on the frame. Not supported on SECTION nodes (Figma's API has no section auto-layout).","params":["nodeId","layoutMode","itemSpacing","counterAxisSpacing","paddingTop","paddingRight","paddingBottom","paddingLeft","primaryAxisAlignItems","counterAxisAlignItems","primaryAxisSizingMode","counterAxisSizingMode","layoutWrap","fileKey"]},{"name":"create_page","description":"Create a new page in the Figma document, optionally naming it and switching the editor to it. Returns the new page's ID, which can be passed as parentId to create_frame / create_text / create_shape / create_image to author content on that page. When multiple files are connected, specify fileKey.","params":["name","setAsCurrent","fileKey"]},{"name":"create_frame","description":"Create a new frame, optionally inside a specified parent. You can set name, size, position, and a solid fill. When multiple files are connected, specify fileKey.","params":["name","parentId","x","y","width","height","fillHex","fillOpacity","fileKey"]},{"name":"create_section","description":"Create a new section — a named container with its own background, resizable independently of its contents. Works in Figma and FigJam. When multiple files are connected, specify fileKey.","params":["name","parentId","x","y","width","height","fillHex","fillOpacity","sectionContentsHidden","fileKey"]},{"name":"create_text","description":"Create a new text node, optionally inside a specified parent. You can set its content, font, size, alignment, color, position, and bounds. Works in both Figma and FigJam. When multiple files are connected, specify fileKey.","params":["name","parentId","characters","fontFamily","fontStyle","fontSize","textAlignHorizontal","textAutoResize","fillHex","fillOpacity","x","y","width","height","fileKey"]},{"name":"create_shape","description":"Create a rectangle, ellipse, or line, optionally inside a specified parent. You can set its size, position, rotation, fill, and stroke. Works in both Figma and FigJam. When multiple files are connected, specify fileKey.","params":["shapeType","name","parentId","x","y","width","height","rotation","cornerRadius","fillHex","fillOpacity","strokeHex","strokeOpacity","strokeWeight","fileKey"]},{"name":"create_shape_with_text","description":"Create a FigJam shape that carries its own text label (SHAPE_WITH_TEXT), e.g. ROUNDED_RECTANGLE, DIAMOND, or ENG_DATABASE. You can set its shape type, text (and text fill via textFillHex), fill, stroke, position, and size. Only available in FigJam. When multiple files are connected, specify fileKey.","params":["shapeType","name","parentId","characters","fontFamily","fontStyle","fontSize","x","y","width","height","rotation","fillHex","fillOpacity","strokeHex","strokeOpacity","strokeWeight","textFillHex","textFillOpacity","fileKey"]},{"name":"create_image","description":"Create an image-backed rectangle from a local file path, remote URL, or data URI. You can set its parent, position, size, corner radius, and fit mode. Works in both Figma and FigJam. When multiple files are connected, specify fileKey.","params":["source","name","parentId","x","y","width","height","cornerRadius","scaleMode","fileKey"]},{"name":"create_svg","description":"Insert raw SVG markup or a workspace-local SVG file as editable Figma vector layers using figma.createNodeFromSvg. You can set its parent, position, size, and semantic name. When multiple files are connected, specify fileKey.","params":["source","name","parentId","x","y","width","height","fileKey"]},{"name":"import_html_layers","description":"Import a DOM serialization (JSON produced by html-figma's browser htmlToFigma()) as editable Figma layers inside a new wrapper frame — frames, text, rectangles, and SVG vectors in one call. Source must be a JSON file path inside the MCP server working directory. Optionally append the wrapper into an existing frame/section via parentId. Requires the plugin to be open in the design editor. When multiple files are connected, specify fileKey.","params":["source","name","parentId","x","y","fileKey"]},{"name":"create_sticky","description":"Create a new sticky note in FigJam. You can set its text content, position, and whether it uses the wide shape (isWideWidth). Only available in FigJam. When multiple files are connected, specify fileKey.","params":["name","parentId","characters","x","y","isWideWidth","fileKey"]},{"name":"create_connector","description":"Create a connector between two nodes in FigJam. You can specify start/end node IDs or absolute positions, plus the attachment side on each node (startAnchor/endAnchor: top, bottom, left, right, auto). Only available in FigJam. When multiple files are connected, specify fileKey.","params":["name","parentId","startNodeId","endNodeId","startX","startY","endX","endY","startAnchor","endAnchor","strokeWeight","strokeHex","fileKey"]},{"name":"duplicate_nodes","description":"Duplicate one or more nodes in place. The duplicates remain under the same parent as the originals. Works in both Figma and FigJam. When multiple files are connected, specify fileKey.","params":["nodeIds","fileKey"]},{"name":"duplicate_with_offset","description":"Duplicate nodes and move each duplicate by a fixed offset in one call. Returns the mapping from source node IDs to duplicate node IDs. Works in both Figma and FigJam. When multiple files are connected, specify fileKey.","params":["nodeIds","offsetX","offsetY","fileKey"]},{"name":"fit_to_content","description":"Resize a SECTION so it tightly wraps its children with optional padding: children are shifted so their bounding box starts at the padding, then the section is resized to bbox + 2×padding. SECTION nodes only — Figma's API has no equivalent for other containers. Works in Figma and FigJam. When multiple files are connected, specify fileKey.","params":["nodeId","padding","fileKey"]},{"name":"distribute_horizontally","description":"Space three or more nodes with equal horizontal gaps, keeping the leftmost and rightmost nodes fixed. Works in both Figma and FigJam. When multiple files are connected, specify fileKey.","params":["nodeIds","fileKey"]},{"name":"distribute_vertically","description":"Space three or more nodes with equal vertical gaps, keeping the topmost and bottommost nodes fixed. Works in both Figma and FigJam. When multiple files are connected, specify fileKey.","params":["nodeIds","fileKey"]},{"name":"align_to_grid","description":"Snap each node's x/y position to a grid of the given size. Works in both Figma and FigJam. When multiple files are connected, specify fileKey.","params":["nodeIds","gridSize","fileKey"]},{"name":"place_below","description":"Move a node directly below a reference node with an optional gap and start/center alignment across the reference's width. Works in both Figma and FigJam. When multiple files are connected, specify fileKey.","params":["nodeId","relativeToId","gap","align","fileKey"]},{"name":"place_right_of","description":"Move a node directly to the right of a reference node with an optional gap and start/center alignment across the reference's height. Works in both Figma and FigJam. When multiple files are connected, specify fileKey.","params":["nodeId","relativeToId","gap","align","fileKey"]},{"name":"reparent_nodes","description":"Move one or more nodes into a different parent container. Works in both Figma and FigJam. When multiple files are connected, specify fileKey.","params":["nodeIds","parentId","fileKey"]},{"name":"group_nodes","description":"Wrap a list of nodes in a new group. Nodes must share a common parent (or supply parentId explicitly). Returns the new group's node ID.","params":["nodeIds","parentId","name","fileKey"]},{"name":"ungroup_node","description":"Ungroup a group or frame — its children move up to its parent and the wrapper is removed. Returns the IDs of the orphaned children in their new parent.","params":["nodeId","fileKey"]},{"name":"set_selection","description":"Set the current page selection to a list of node IDs. Pass an empty array to clear the selection. Works in Figma design editor, Dev Mode, and FigJam.","params":["nodeIds","fileKey"]},{"name":"scroll_and_zoom_into_view","description":"Scroll and zoom the Figma/FigJam viewport so the given nodes are framed in view. Works in Figma design editor, Dev Mode, and FigJam.","params":["nodeIds","fileKey"]},{"name":"delete_nodes","description":"Delete one or more nodes. This is destructive and requires confirm: true. Page and document nodes cannot be deleted through this tool. Works in both Figma and FigJam. When multiple files are connected, specify fileKey.","params":["nodeIds","confirm","fileKey"]},{"name":"get_motion_styles","description":"List all available animation presets in Figma (Motion API beta). When multiple files are connected, specify fileKey.","params":["fileKey"]},{"name":"get_node_motion","description":"Read a node's current animationStyles, animations, manualKeyframeTracks, and timelines (Motion API beta). When multiple files are connected, specify fileKey.","params":["nodeId","fileKey"]},{"name":"apply_animation_style","description":"Apply a preset animation style to a node (Motion API beta). When multiple files are connected, specify fileKey.","params":["nodeId","styleId","animationStyleData","fileKey"]},{"name":"remove_animation_style","description":"Remove an applied animation style from a node (Motion API beta). If no animationStyleId is provided, removes all styles. When multiple files are connected, specify fileKey.","params":["nodeId","animationStyleId","fileKey"]},{"name":"apply_manual_keyframe_track","description":"Applies or replaces the manual Motion keyframe track for a property, paint, or effect field on a node. When multiple files are connected, specify fileKey.","params":["nodeId","field","track","fileKey"]},{"name":"remove_manual_keyframe_track","description":"Removes the manual Motion keyframe track for a property, paint, or effect field on a node. When multiple files are connected, specify fileKey.","params":["nodeId","field","fileKey"]},{"name":"set_timeline_duration","description":"Sets the duration (in seconds) for a timeline. When multiple files are connected, specify fileKey.","params":["nodeId","timelineId","duration","fileKey"]},{"name":"save_screenshots","description":"Export screenshots for multiple nodes and save them directly to the local filesystem. Returns metadata only (no base64). When multiple files are connected, specify fileKey.","params":["items","format","scale","clip","fileKey"]}],"toolsHash":"5edbb1f90124f9a39483642ac3d83eb97ccd7ec4afb6d293adc4b8b1811a7956","wrote":[],"callsAt":"2026-11-16T11:31:39.444Z","calls":[{"tool":"list_files","ok":true,"ms":2,"bytes":2},{"tool":"get_document","ok":false,"ms":2,"bytes":0,"error":"tool reported an error: No plugin connected. Open a Figma file and run the bridge plugin."},{"tool":"get_selection","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: No plugin connected. Open a Figma file and run the bridge plugin."},{"tool":"get_prototype_connections","ok":false,"ms":0,"bytes":0,"error":"tool reported an error: No plugin connected. Open a Figma file and run the bridge plugin."},{"tool":"get_styles","ok":false,"ms":1,"bytes":0,"error":"tool reported an error: No plugin connected. Open a Figma file and run the bridge plugin."}],"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":56,"wrote":0,"callsTried":5,"callsAnswered":1,"callContacts":[]},"history":[{"package":"@gethopp/figma-mcp-bridge","version":"0.0.27","ranAt":"2026-11-16T11:31:33.050Z","outcome":"started","tools":56,"contacts":0,"flags":0,"serious":0,"toolsHash":"5edbb1f90124f9a39483642ac3d83eb97ccd7ec4afb6d293adc4b8b1811a7956"},{"package":"@gethopp/figma-mcp-bridge","version":"0.0.26","ranAt":"2026-11-12T17:52:49.781Z","outcome":"started","tools":55,"contacts":0,"flags":0,"serious":0,"toolsHash":"a509eeb7c225cc82963c24a61a5f1d253b93d576d01e47a6cbf849eaa055d829"}],"page":"https://bragproof.smaverk.com/r/%40gethopp/figma-mcp-bridge"}