nodes
Reads detailed Figma layer data—fills, strokes, text, auto-layout, masks, components—from saved .fig files when compact summaries lack detail; writes large JSON to a file to avoid reply limits.
Instructions
A node or exact instance sublayer as the per-node object of a Figma REST nodes response ({document, components, componentSets, styles, schemaVersion, _figlens}; _figlens.semantics.verification covers every node's _figlens.semantics): instances expanded, fills, strokes, effects, full text, auto-layout, masks, component data, Dev Mode annotations with labelMarkdown (named annotationCategories at the top level) and devStatus. Use it when inspect's compact summary lacks paints, masks or full text. A whole screen is often hundreds of KB, and agent hosts may show only part of a reply over about 20 KB, so read a screen with out, then query that file with jq or read it in parts; or scope to a smaller node, use inspect (flat for an outline), or write a bundle. Without out, replies over the MCP reply budget fail with response_budget_exceeded; with out, only a selection that outgrows that budget while being built does. Opt-in compact shares styles, and subtrees additionally shares templates; resolve the versioned references before passing to REST consumers. The reply budget applies to the compact result, with separate finite construction limits.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"file": "<file>",
"node": "<node>"
},
"name": "nodes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| out | No | write the JSON (the same text the reply would carry) to this .json file (other extensions are refused) and reply {path, bytes, lines} instead. Unless the user names one, use .figlens/exports/ under the project root, created with a .gitignore containing * so it stays out of Git; create the parent directory first; never overwrites the source design | |
| file | Yes | the saved .fig: a local path (absolute recommended), or gs://bucket/object using gcloud; remote sources are unavailable with --root | |
| node | Yes | a stored node id (12:345 or 12-345), full instance sublayer id (I12:345;67:89) from inspect/nodes, or a Figma URL with ?node-id= | |
| compact | No | lossless figlens.nodes.compact.v1 wrapper: data contains node style slots as {$style: index}, sharedStyles holds their literal values; default false; use for large full-paint reads, not REST consumers | |
| subtrees | No | with compact: true, also share repeated subtrees; {$subtree: index, placements: [...]} references subtrees templates with preorder id/absoluteBoundingBox/absoluteRenderBounds overrides; default false |