inspect
Summarize a saved Figma .fig node by ID or URL to get layout, typography, text previews, fill colors, annotations, and child counts without opening Figma or using the API.
Instructions
Compact expanded node summary with path, the node's ancestors from the document down ([{id, name}] as in find; for a layer, path[1] is its page), so a pasted link's screen needs no find: bounds, layout, typography, text previews (fullText=true for complete text), Dev Mode annotation label previews and Ready for dev devStatus, and child counts. colors=true adds resolved solid fill colors with bound variables; other paints stay in nodes. A parent without auto-layout has childSpacing "derived": gaps between its children are coordinate differences, not an auto-layout rule; constraints may still pin them. For image decisions, images=true adds original dimensions/bytes and source-pixel rectangles before masks, not blur diagnoses. Depth and a 200-node budget bound the summary; image paints have their own 200-item limit. nodes returns full design data.
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": "inspect"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| file | Yes | the saved .fig: a local path (absolute recommended), or gs://bucket/object using gcloud; remote sources are unavailable with --root | |
| flat | No | one line per node instead of node JSON, for scanning a screen against an implementation: id, type, name, @x,y WxH relative to the inspected node, then hidden, rot, component, devStatus=READY_FOR_DEV|COMPLETED, annotations=N (a count; notes are in the JSON form), text, font=family size/weight/lineHeight, fill, stroke=paint/weight, r, visible effects (shadow|inner-shadow=x,y,blur[,spread],color, blur=, bg-blur=), H|V gap or GRID RxC gap=row,col rows=… cols=… (stored track sizes: flexN, px, hug or min..max; ? when unstored), pad=top,right,bottom,left, align=main/cross unless both min, size=w/h (fixed|fill|hug) unless both hug (or spacing=derived without auto-layout), span=rows,cols on grid children, opacity when set; children=N and '… N more' mark omitted nodes; same depth and node limits; not combinable with images, states or compareVariant; default false | |
| 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= | |
| depth | No | 0-10 levels below the node, default 1; text previews up to 200 characters | |
| colors | No | add solidFills to nodes with visible SOLID fills (TEXT color, frame and shape fills): hex, opacity when the paint is below 1 (paint alpha x paint opacity, not ancestor or node opacity) and the bound color variableId/variableName; with flat, a fill shows a $variable suffix. Gradients, images, strokes, effects and vector geometry are not included (use nodes); default false | |
| images | No | include source bitmap dimensions/bytes and per-paint source-pixel crop rectangles; no files written | |
| states | No | include bounded variants and prototype field evidence with exact sources/unknowns; retains instance overrides, infers no business conditions and renders no other variants | |
| compare | No | compare node with any other stored node of the file (another frame, breakpoint or state; no component set needed) with the same bounded raw-field differences, per-pair changes, unpaired nodes and exact sources as compareVariant, plus rootDelta (size and parent-relative position); children pair by unique name, then unique main component, then stacking order in equal-sized same-name groups (pairedBy), the rest are reported unpaired as ambiguous-name; instances are not expanded; an ancestor or descendant is rejected; adds comparison | |
| fullText | No | return the complete characters of each TEXT node (up to 10000 characters, textTruncated beyond) instead of the 200-character preview; also applies to flat; the node and reply budgets still apply; default false | |
| compareVariant | No | compare node with this other stored variant in the same component set; adds bounded raw-field differences, per-pair changes for children paired by unique name, main component or equal-count stacking order (check pairedBy; order is the weakest evidence), other descendants' value multisets, exact sources and bound variable names; no alternate rendering or business inference |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flat | No | the one-line-per-node text when flat=true, instead of node | |
| node | No | Compact node with partial layout semantics and type-only property definitions; childSpacing "derived" marks a parent without auto-layout; _figlens.semantics records source and state (a missing entry means the field is not stored); the top-level _figlens.semantics.verification applies to all nodes. Definitions, definition evidence, annotations (plain label previews, labelTruncated when cut; at most 20 properties each) and _figlens.renderDiagnostics each have at most 20 entries per node; truncated includes omitted nodes or entries; with colors=true, nodes with visible SOLID fills carry solidFills [{hex, opacity?, variableId?, variableName?}] | |
| path | No | the node's ancestors from the document down to the node itself, find's path shape; an instance sublayer's path continues through its expanded parents; absent with flat=true | |
| images | No | optional source image evidence when images=true | |
| states | No | optional variants and prototype field evidence when states=true; independent truncation, source file, node/override provenance and unknown markers; no inferred business logic | |
| _figlens | No | semantics.verification: whether every node's _figlens.semantics was compared with Figma exports (not-compared-with-figma) | |
| truncated | Yes | ||
| comparison | No | optional any-two-nodes definition comparison when compare is supplied; same shape as variantComparison without componentSetId, plus rootDelta and a reason on each unpaired node (ambiguous-name, name-truncated, no-counterpart); not a pixel comparison | |
| variantComparison | No | optional same-set definition comparison when compareVariant is supplied; raw fields, paired children, descendant value multisets, unpaired nodes, unknowns and independent truncation; not a pixel comparison | |
| handoffDiagnostics | No | optional known stored semantics not emitted by the projection; counts cover the selected expanded subtree independently of summary depth, with at most five example IDs per feature and explicit coverage limits | |
| annotationCategories | No | optional {categoryId: {label, isPreset, color?, labelTruncated?}} for the categories the kept annotations name |