Skip to content
verify mcp Beta VerifyMCP is currently in beta. If you notice any issues, get in touch and we’ll put it right.

grafta

NPM · GRAFTA

Talk to any Figma file with your AI: ask what's in it, change it, or turn it into code.

Available components

+3 this week 72 Trust /100

Last scanned (15 hours ago)

Scores higher than 44% of npm servers

Category Design and Media

Trust breakdown (7 categories)

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. How we score → Why this is hard to score →

Supply Chain Security100
  • No malware found by supply-chain analysis.Pass
  • No known CVEs affecting this package version or its production dependencies.Pass
  • No install/post-install scripts declared.Pass
  • 0 of 5 dependencies flagged as unhealthy. View diagnostics → Pass
Provenance & Transparency48
  • Source repository is publicly reachable at the declared URL. View diagnostics → Pass
  • Provenance check failed: no build-provenance attestation is published. See how to fix → View diagnostics → Fail
  • Clear OSI-approved license (MIT).Pass
  • Actively maintained (last published 9 days ago).Pass
  • Publishes a security disclosure policy (SECURITY.md).Pass
Schema Quality & AI Usability57
  • AI-judged instruction clarity (good).Pass
  • Context-footprint check failed: tool/resource definitions use about 8868 tokens (~197/item across 45 items; 45 tools + 0 resources), over budget; trim descriptions and params. See how to fix → Fail
  • Usage-examples check failed: none of the tools include examples. See how to fix → Fail
Stability & Change Management47
  • Stability observed for 14 of 30 days with no destabilising changes; credit accrues until the full window elapses.Partial
Tool Coverage88
  • 100% of tools have a non-trivial description (not blank, and not just the tool's name).Pass
  • 65% of tool parameters carry a description.Partial
Tool Safety75
  • No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.Pass
  • 0 of 1 tool(s) whose name or description implies an irreversible operation declare an MCP destructiveHint annotation; "delete_node" implies "delete" and declares no destructiveHint at all, which the MCP spec reads as destructive by default. See how to fix → Fail
  • An AI judge read all 46 captured unit(s) of tool text and found none that tries to manipulate the model reading it.Pass
Capabilities100
  • Implements a current MCP spec version (2026-07-28).Pass
What we tested

Checks we ran (16)

  • Malware scan
  • Known CVEs
  • Install scripts
  • Dependency health
  • Source repository
  • Provenance
  • License
  • Maintenance
  • Security disclosure
  • Schema quality
  • Stability
  • Tool coverage
  • Injection markers
  • Destructive annotations
  • Judged manipulation
  • MCP protocol

Does not apply to this package (2)

  • Endpoint SecurityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.
  • Transport & ReachabilityScored on hosted endpoints only. A package has no live endpoint of its own for us to probe.

The score does not measure everything. What the score does not measure →

Changelog

Every change we have recorded for this component, newest first. Security-relevant changes are always shown. ▲ marks a change for the better, ▼ a change for the worse; unmarked changes are neutral.

  • 21 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.

  • 18 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 33 to 37. That category is still filling its 30-day observation window: 10 days of observed history at the previous scan, 11 at this one. The score rises as the window fills, whether or not the server changes.

  • 16 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 27 to 30. That category is still filling its 30-day observation window: 8 days of observed history at the previous scan, 9 at this one. The score rises as the window fills, whether or not the server changes.

  • 14 Nov 26 +1

    No change was recorded against any check on this day. Stability & Change Management went from 20 to 23. That category is still filling its 30-day observation window: 6 days of observed history at the previous scan, 7 at this one. The score rises as the window fills, whether or not the server changes.

  • 13 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 12 Nov 26 −14
    • Malware scan: pass → unverified ▼ security
    • Package version: 0.4.0 → 0.5.0 functional
  • 11 Nov 26 +15
    • Malware scan: unverified → pass ▲ security
  • 10 Nov 26 −14
    • Malware scan: pass → unverified ▼ security
    • Stability: unverified → 0.10 ▲ functional
    • Package version: 0.3.0 → 0.4.0 functional
Diagnostics

Diagnostic detail from the automated scan of this channel: what the scanner observed at each step, so you can see exactly where a check passed or failed. It is informational only and never changes the trust score.

Captured 21 Nov 2026 · Analysed npm/grafta@0.5.0

Provenance No attestation

The registry publishes no build provenance for this version, so there is nothing to verify.

Result No attestation
Ecosystem npm

Background: How many MCP packages publish verified provenance →

Dependencies 5 packages
Packages resolved 5
Tree resolution Complete

Background: SBOMs and build attestations, explained →

MCP tools · 45 exposed · ~8,529 tokens

The tools this component advertises to a client, with an estimated token cost for each. Expand a tool to see its parameters and schema. The per-tool counts are indicative and are not scored directly; the schema's total context footprint is one signal in Schema Quality & AI Usability. A tool's description is untrusted text the model reads on every call, which is what makes this list a security surface and not just an inventory: how tool poisoning works →

Tool Tokens
add_component_property ~150

Give a component a property its instances set: TEXT (a label), BOOLEAN (show a part or not) or INSTANCE_SWAP (which icon), with its default. Then bind a layer inside the component with set_properties componentPropertyReferences ({ characters | visible | mainComponent: <property> }), and set each instance's value with set_properties componentProperties ({ "Label": "Guardar" }).

NameTypeReqDescription
componentstringyesA component's id.
default–yesA string, true or false, or a component's name or id.
handlestringyesThe handle open_file returned.
namestringyese.g. "Label", "Show icon".
type–yes–

No output schema declared.

No examples provided.

check_contrast ~223

Check every visible text under a node (a screen, a frame, a component) against WCAG 2.2 AA: its colour against what is actually drawn behind it, as render_node draws it, in the frame's mode and with instances' overrides. 4.5:1 is required, 3:1 for large text (24 px, or 18.66 px bold). Lists the texts that fail, with colour, background, ratio and what is required, and those that cannot be measured, with why; `all: true` lists the passing ones too. Over a background of several colours, the lowest ratio is given. Paged.

NameTypeReqDescription
allboolean–List passing texts too. Default false.
budgetinteger–Maximum result size in bytes. Default 32768.
cursorstring–next_cursor from the previous page.
handlestringyesThe handle open_file returned.
idstringyesThe node whose texts are checked.
limitinteger–Results per page.

No output schema declared.

No examples provided.

close_file ~61

Close an open file and free the memory it holds. Edits not saved with save_as are discarded, for good: they are not recovered on the next open. The result says how many there were.

NameTypeReqDescription
handlestringyesThe handle open_file returned.

No output schema declared.

No examples provided.

component_instances ~103

Where a component is used: every instance of it (of any variant, for a component set), with id, name and path. Paged.

NameTypeReqDescription
budgetinteger–Maximum result size in bytes. Default 32768.
cursorstring–next_cursor from the previous page.
handlestringyesThe handle open_file returned.
idstringyesA component or component set id.
limitinteger–Results per page.

No output schema declared.

No examples provided.

create_component ~129

Turn a frame into a component, in place, keeping its children, so it can be reused: then place copies with create_instance (component: its id) and change what each copy shows with override_instance. Build the frame first (create_frame, create_text, create_vector, set_properties), then make it a component. A frame inside a component or an instance cannot be one.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
idstringyesThe frame to turn into a component.
namestring–A new name, e.g. "Button/Primary".

No output schema declared.

No examples provided.

create_frame ~128

Create an empty frame (no fill, no auto-layout) on a page or inside a frame, at x,y relative to the parent, with a width and height. Returns its id. Fills, strokes, auto-layout and text are not available yet: they have not been measured in Figma.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
heightnumberyes–
namestringyes–
parentstringyesA page or frame id.
widthnumberyes–
xnumber––
ynumber––

No output schema declared.

No examples provided.

create_instance ~136

Create an instance of a component this file defines, on a page or inside a frame, at x,y relative to the parent. It takes the component's own size. For a component set, pass one variant's id (the set's children, via read_node). Components from another file cannot be instantiated yet.

NameTypeReqDescription
componentstringyesA component (or variant) id.
handlestringyesThe handle open_file returned.
namestring–Default: the component's name.
parentstringyesA page or frame id.
xnumber––
ynumber––

No output schema declared.

No examples provided.

create_page ~53

Create a page at the end of the file's page list. Returns its id. Nothing is written to disk until save_as.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
namestringyes–

No output schema declared.

No examples provided.

create_section ~103

Make a section on a page, to organise screens ("Onboarding", "Checkout"). Then move frames into it with move_node (parent: the section), or create them in it.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
heightnumberyes–
namestring––
parentstringyesA page's id.
widthnumberyes–
xnumber––
ynumber––

No output schema declared.

No examples provided.

create_shape ~231

Draw a shape as Figma's own layer type: RECTANGLE (cornerRadius), ELLIPSE (arcData { startingAngle, endingAngle, innerRadius } in radians: a ring, a pie, a half arc), LINE (width is its length; needs strokes), POLYGON (pointCount sides) or STAR (pointCount points, innerRadius 0-1). Fills and strokes as set_properties takes them; nothing is painted unless named. Style it further with set_properties.

NameTypeReqDescription
arcDataobject––
cornerRadiusnumber––
fillsarray––
handlestringyesThe handle open_file returned.
heightnumber–Not for a LINE.
innerRadiusnumber––
namestring––
parentstringyesA page or frame id.
pointCountinteger––
strokeWeightnumber––
strokesarray––
type–yes–
widthnumberyes–
xnumber––
ynumber––

No output schema declared.

No examples provided.

create_style ~225

Make a style: type FILL with fills (paints, as set_properties takes them), TEXT with fontFamily, fontStyle, fontSize, lineHeight and letterSpacing, or EFFECT with effects. Figma lists it under Local styles. Apply it with set_properties: fillStyle or strokeStyle for a FILL style, effectStyle, textStyle.

NameTypeReqDescription
effectsarray–EFFECT: shadows and blurs, as set_properties takes them.
fillsarray–FILL: paints, as set_properties takes them.
fontFamilystring––
fontSizenumber––
fontStylestring–e.g. "Bold", "Semi Bold".
handlestringyesThe handle open_file returned.
letterSpacing––Pixels, or { value, unit: PIXELS | PERCENT }.
lineHeight––Pixels, or { value, unit: PIXELS | PERCENT }.
namestringyese.g. "Brand/Primary"; slashes group it.
type–yes–

No output schema declared.

No examples provided.

create_text ~527

Create a text layer on a page or in a frame. characters is the text (a line break starts a new paragraph). fontFamily and fontStyle name a font as Figma does (e.g. "Inter", "Semi Bold"); by default, the file's most used font. fontSize, fills (like set_properties: SOLID colour or a local colour variable; default black), x, y, textAlignHorizontal (LEFT, CENTER, RIGHT, JUSTIFIED), lineHeight (pixels, or { value, unit: PIXELS | PERCENT }), letterSpacing (likewise). Give width to wrap text inside a fixed width; give height too to fix the box (textAutoResize NONE); without either the box fits the text. Rich text: runs instead of characters, [{ characters, fontFamily?, fontStyle?, fontSize?, fills?, textDecoration?, textCase?, letterSpacing?, lineHeight?, hyperlink?: { type: URL, value } }], each run styled apart from the layer (a link is underlined unless it says otherwise); paragraphs, one per line of the text, [{ listType: NONE | UNORDERED | ORDERED, indentation?: 1 | 2 }]; paragraphSpacing, paragraphIndent, textDecoration (NONE, UNDERLINE, STRIKETHROUGH), textCase (ORIGINAL, UPPER, LOWER, TITLE, SMALL_CAPS, SMALL_CAPS_FORCED), textAlignVertical (TOP, CENTER, BOTTOM) and textAutoResize (NONE, WIDTH_AND_HEIGHT, HEIGHT). Figma lays the text out when the file is opened, so the size grafta reports is provisional.

NameTypeReqDescription
charactersstring––
fillsarray––
fontFamilystring––
fontSizenumber––
fontStylestring––
handlestringyesThe handle open_file returned.
heightnumber––
letterSpacing–––
lineHeight–––
namestring–Layer name. Default: the characters.
paragraphIndentnumber––
paragraphSpacingnumber––
paragraphsarray––
parentstringyesA page or frame id.
runsarray–The text as styled pieces; instead of characters.
textAlignHorizontal–––
textAlignVertical–––
textAutoResize–––
textCase–––
textDecoration–––
widthnumber––
xnumber––
ynumber––

No output schema declared.

No examples provided.

create_variable ~227

Add a variable to a collection, with a value for every mode: { "Light": "#7C3AED", "Dark": "#A78BFA" }. type is COLOR, FLOAT, STRING or BOOLEAN. A value may be { alias: <variable name or id> }, another local variable of the same type, as semantic tokens alias primitive ones. A COLOR variable can be bound at once with set_properties, fills: [{ type: SOLID, variable: <name> }].

NameTypeReqDescription
collectionstringyesA collection's name or id.
handlestringyesThe handle open_file returned.
namestringyese.g. "Brand/Primary"; slashes group it in Figma's panel.
type–yes–
valuesobjectyesMode name → value: "#RRGGBB" or "#RRGGBBAA" for COLOR, a number for FLOAT, a string for STRING, true or false for BOOLEAN, or { "alias": "<variable name or id>" } for another local variable of the sa…

No output schema declared.

No examples provided.

create_variable_collection ~121

Make a variable collection (a set of design tokens) with named modes, e.g. modes: ["Light", "Dark"]. Then create_variable adds variables to it, and set_properties binds a fill to one by name. In a file with no Internal Only Canvas (one from new_file), grafta writes one first, where Figma keeps variables.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
modesarrayyesMode names, in order.
namestringyesThe collection's name, e.g. "Colors".

No output schema declared.

No examples provided.

create_variant_set ~131

Group components into a variant set, as Figma's own sets: one component with properties, each component a variant of it. variants: [{ id, values: { "State": "Default" } }], every variant naming the same properties with a different combination. The components must share a parent; the set is placed around them. Then create_instance with any variant's id, and set_variant to switch an instance.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
namestringyesThe set's name, e.g. "Product row".
variantsarrayyes–

No output schema declared.

No examples provided.

create_vector ~296

Draw a vector from SVG path data (M L H V C S Q T A Z), as icon sets publish it: Lucide, Heroicons, Material Symbols. `path` is one path's d, or a list of them. `viewBox` is the box the data is drawn in ([0, 0, 24, 24] for Lucide), scaled to width and height; without it, the path's own bounds. For a line icon give strokes, strokeWeight (in the vector's pixels: Lucide's 2 at 24 px is 4 at 48 px), strokeCap and strokeJoin ROUND, and no fills. Figma draws the geometry itself.

NameTypeReqDescription
fillRule–––
fillsarray––
handlestringyesThe handle open_file returned.
heightnumber––
namestring––
parentstringyesA page or frame id.
path–yesSVG path data: a string, or a list of strings drawn together.
strokeCap–––
strokeJoin–––
strokeWeightnumber––
strokesarray––
viewBoxarray–[min x, min y, width, height] of the box the path is drawn in.
widthnumber––
xnumber––
ynumber––

No output schema declared.

No examples provided.

delete_node ~142

Delete a node (a page, frame, text or instance) and everything inside it. Returns the ids removed. Refused when another node points at it or at something inside it (an instance of a component in it, a prototype link to it, an override of one of its layers), naming who; and refused inside a component. `also` deletes more nodes in the same call: what they point at among themselves does not count, so components that use each other can go together.

NameTypeReqDescription
alsoarray–More nodes deleted with it, in one call.
handlestringyesThe handle open_file returned.
idstringyes–

No output schema declared.

No examples provided.

duplicate_node ~140

Duplicate a node with everything in it: every layer copied with a new id, instances still instances of their components, bindings and styles kept. The copy goes in the same parent unless one is named, at x, y (by default the original's), in front of its new siblings; then change it. A component, or anything holding one, is not duplicated.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
idstringyes–
namestring––
parentstring–Where the copy goes; by default the original's parent.
xnumber––
ynumber––

No output schema declared.

No examples provided.

export_pdf ~152

Write nodes (frames, boards, components) to a NEW .pdf file, a page each in the order given, each page the node's size in points: screens for review or handoff. Each page is the drawing render_node makes, unsaved edits and modes included, as vectors, with text grafta wrote kept as selectable text. The result's `pages` give each page's notes, as render_node's do; a shadow or blur makes what it covers an image. Never overwrites.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
idsarrayyesNode ids, one page each, in order.
pathstringyesA new path ending in .pdf.

No output schema declared.

No examples provided.

export_tokens ~193

Write the file's variables as W3C Design Tokens (DTCG 2025.10) JSON, one NEW file per collection and mode, the way Figma imports them: <dir>/<collection>.<mode>.tokens.json. Names split on / into groups; colours exact from the file (sRGB components and alpha, hex beside); numbers without an invented unit; an alias within its collection as a {group.token} reference, to another collection as its value with Figma's com.figma.aliasData. Lists what was not written (unresolved), every name changed to fit the format (renamed), and notes. The folder must exist; no file is written over.

NameTypeReqDescription
collectionstring–Only this collection (name or id); all when left out.
dirstringyesAn existing folder for the token files.
handlestringyesThe handle open_file returned.

No output schema declared.

No examples provided.

fill_template ~224

Place a component once per row of data, in a page or frame (an auto-layout frame flows them): product cards, list rows, localised screens. Rows are a JSON array of objects, or a CSV file whose first line names the keys. Each key of a row is, in this order: `name` (the instance's layer name); a variant property, when `component` is a variant set; a component property (TEXT, BOOLEAN, INSTANCE_SWAP); or the name of a layer in the component, whose text it sets, or whose image when the value is a .png or .jpg path. Any other key refuses the call before anything is written. One call, up to 1000 rows.

NameTypeReqDescription
componentstringyesA component, or a variant set.
csvstring–A CSV file instead of rows: its first line names the keys.
handlestringyesThe handle open_file returned.
parentstringyesA page or frame id.
rowsarray–One object per instance.

No output schema declared.

No examples provided.

get_image ~69

An image the file embeds, by the imageHash a fill carries (read_node shows it). Returned as an image, up to 4 MB; a larger one is described instead.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
hashstringyesThe fill's imageHash.

No output schema declared.

No examples provided.

group_nodes ~86

Group layers that share a parent, as Figma's Group: the group sits at their bounds and each layer keeps its place on the canvas. Moving or resizing a grouped layer with set_properties fits the group again. ungroup undoes it.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
idsarrayyes–
namestring–Default "Group".

No output schema declared.

No examples provided.

import_layout ~244

Write a web page's layout as design layers: a layout snapshot (JSON from grafta's snapshot.js, https://n0ss4.github.io/grafta/snapshot.js, run in a browser on the page: graftaSnapshot('<css selector>')) becomes frames, text, images and auto-layout in a page or frame. Flexbox becomes auto-layout with fill, hug or fixed sizing as the browser measured it (layout: "auto", the default), or every box is placed where the browser put it ("absolute"). Backgrounds, uniform borders, radii, box shadows, opacity, fonts and local or data: images are written; what is not (a gradient, a transform, an inline SVG, a remote image) is listed under not_imported, with its element. One call.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
layoutstring–Flexbox as auto-layout (default), or every box where the browser put it.
parentstringyesA page or frame id.
snapshotstringyesThe snapshot's JSON file.
xnumber––
ynumber––

No output schema declared.

No examples provided.

list_components ~140

The components this file defines: every component set (with its variant properties and their values) and every standalone component, with id, name, page, component property definitions and how many instances use it. Variants inside a set are not listed separately; read_node on the set lists them as children. Paged.

NameTypeReqDescription
budgetinteger–Maximum result size in bytes. Default 32768.
cursorstring–next_cursor from the previous page.
handlestringyesThe handle open_file returned.
limitinteger–Results per page.
namestring–Only components whose name contains this (case-insensitive).

No output schema declared.

No examples provided.

list_open ~38

List the files currently open, with their handles, node counts, unsaved edits, how long each took to open, and the process's memory.

Input schema present but exposes no named parameters.

No output schema declared.

No examples provided.

list_screens ~147

The screens of a page, as a person sees them in Figma, in their order: a page's top-level frames, components, sections and other layers; a deck's slides, across its rows; a site page's breakpoints. Each with id, name, type, size and whether it is visible, ready for render_node. Paged.

NameTypeReqDescription
budgetinteger–Maximum result size in bytes. Default 32768.
cursorstring–next_cursor from the previous page.
handlestringyesThe handle open_file returned.
limitinteger–Results per page.
pagestringyesA page's id, from summarize.

No output schema declared.

No examples provided.

list_styles ~91

The file's own colour, text and effect styles, with their values: paints in hex, a text style's font, size, line height and letter spacing, effects. Styles removed from the file and a library's are left out. Apply one with set_properties: fillStyle, strokeStyle, effectStyle or textStyle.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
type–––

No output schema declared.

No examples provided.

list_variables ~123

The file's design variables (tokens): each collection with its modes, and each variable's type and value per mode. Colours are hex; an alias is shown as { alias: <variable name> }, not flattened. Paged over variables.

NameTypeReqDescription
budgetinteger–Maximum result size in bytes. Default 32768.
collectionstring–Only this collection (name or id).
cursorstring–next_cursor from the previous page.
handlestringyesThe handle open_file returned.
limitinteger–Results per page.

No output schema declared.

No examples provided.

move_node ~233

Move a frame, component or component set, instance, text layer, shape or vector: into another page or frame, or among its siblings. Siblings are drawn in order, the last on top; in an auto-layout frame the order is also the flow. Give `parent` (with `to`: "front", the default, or "back"), or `behind` / `in_front_of` a sibling to go right behind or in front of it, in that sibling's parent. x,y are relative to the new parent; by default the node keeps them.

NameTypeReqDescription
behindstring–A node to go right behind, in its parent.
handlestringyesThe handle open_file returned.
idstringyes–
in_front_ofstring–A node to go right in front of, in its parent.
parentstring–A page or frame id.
tostring–With parent: the top of the stack (last, the default) or the bottom (first).
xnumber––
ynumber––

No output schema declared.

No examples provided.

new_file ~134

Create a new, empty .fig at a path that does not exist, and open it: one page and nothing else. `from` is any .fig you have; only its format is used (Figma's schema, which grafta does not invent), none of its content: no pages, components, styles, variables or images. Returns the handle, as open_file does.

NameTypeReqDescription
fromstringyesAny .fig, whose format the new file uses.
pagestring–The page's name. Default "Page 1".
pathstringyesA new path ending in .fig.

No output schema declared.

No examples provided.

open_file ~154

Open a Figma .fig file and keep it open for later calls. Returns a handle and a summary: pages, node counts, components, variable collections, images. Opening a path that is already open returns the same handle without reading it again. Large files take seconds to open; every later call on the handle is fast. Edits the file had not saved when grafta last stopped are replayed, and `recovered` says how many; edits all saved to another file are not, and it says which file.

NameTypeReqDescription
pathstringyesPath to a .fig file.
recoverboolean–Replay edits this file had not saved when grafta last stopped. Default true; false discards them.

No output schema declared.

No examples provided.

override_instance ~205

Change what an instance shows, without changing its component: the colour of an icon, a button's label, a hidden part. properties: fills and strokes (paints, as in set_properties), characters (text layers), visible. layer names the component's layer by its id, as read_node on the component shows it; for a layer inside a nested instance, give a path of ids [nested instance, layer]. Without layer, fills and strokes recolour every vector layer of the component that already has fills (or strokes), and never add paint to a layer that had none. Many icons are drawn with strokes, not fills: read_node on the component shows which, and a stroked icon is recoloured with strokes.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
idstringyesAn instance you created.
layer––A layer id in the component, or a path of ids through nested instances.
propertiesobjectyes–

No output schema declared.

No examples provided.

read_node ~281

Read one node exactly, in Figma's terms: geometry, fills/strokes (hex colours, bound variable names), effects, corner radii, auto-layout, constraints, text and its style, and for an instance its component and variant. A layer's prototype is `reactions` (trigger, actions, destination, transition), as the plugin API names them; a page gives its `flowStartingPoints`, a frame `overflowDirection` and overlay settings. Children to `depth` (default 1). Properties at Figma's default are left out: visible true, opacity 1, rotation 0, no fills/strokes/effects, radius 0, no auto-layout, constraints MIN/MIN. `undecoded` names stored fields this view does not model; read_raw returns them.

NameTypeReqDescription
budgetinteger–Maximum result size in bytes. Default 32768.
children_frominteger–Skip this many children of the node: to resume a result cut for budget.
depthinteger–Levels of children to include. 0 = the node alone. Default 1.
geometryboolean–Include vector path data (SVG d strings). Default false.
handlestringyesThe handle open_file returned.
idstringyesNode id, e.g. 12:345.

No output schema declared.

No examples provided.

read_raw ~104

The node exactly as the file stores it: every field of its node change, including the ones read_node does not model (listed there as `undecoded`). Byte fields are shown as their length and a fingerprint.

NameTypeReqDescription
budgetinteger––
fieldsarray–Only these top-level fields. Default: all.
handlestringyesThe handle open_file returned.
idstringyesNode id, e.g. 12:345.

No output schema declared.

No examples provided.

render_node ~155

Draw a node (a board, frame, component, instance, shape or text) as a PNG you can look at, from the open file including unsaved edits. Use it to see a screen you read, or to check a change before save_as. Drawn offline: the caption's `notes` name everything drawn approximately or left out, and an empty list means nothing was.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
idstringyesNode id, e.g. 12:345.
max_sizeinteger–Largest side in pixels; a larger picture is scaled down to fit. Default 2048.
scalenumber–Pixels per unit. Default 1.

No output schema declared.

No examples provided.

save_as ~143

Write the open file, with its edits, to a NEW path ending in its product's extension: .fig, or .deck for a Figma Slides file, .jam for FigJam, .site for Figma Sites. Never overwrites: a path that exists, or the source file, is refused. The written file is read back and compared before success is reported. Open the result in Figma to see it.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
pathstringyesA new path ending in .fig, or .deck, .jam or .site for a Figma Slides, FigJam or Figma Sites file.

No output schema declared.

No examples provided.

search_nodes ~182

Find nodes by name (case-insensitive substring), by type (FRAME, TEXT, INSTANCE, COMPONENT, COMPONENT_SET, PAGE, SECTION, GROUP, RECTANGLE, VECTOR, …), or both, optionally only inside one node. Returns id, name, type and the path from the page, in document order, paged. Hidden nodes are included.

NameTypeReqDescription
budgetinteger–Maximum result size in bytes. Default 32768.
cursorstring–next_cursor from the previous page.
handlestringyesThe handle open_file returned.
limitinteger–Results per page.
namestring–Case-insensitive substring of the node name.
typestring–Node type, in the plugin API's spelling.
withinstring–Only search inside this node id (a page, a frame…).

No output schema declared.

No examples provided.

set_properties ~1,560

Change a frame, instance or text layer you created, using read_node's names: x, y, width, height, name, visible, clipsContent (clip children to the frame), auto-layout (layoutMode NONE | HORIZONTAL | VERTICAL, itemSpacing, counterAxisSpacing, padding or paddingTop/Right/Bottom/Left, primaryAxisSizingMode and counterAxisSizingMode FIXED | AUTO, primaryAxisAlignItems MIN | CENTER | MAX | SPACE_BETWEEN, counterAxisAlignItems MIN | CENTER | MAX, layoutWrap), a child's layoutGrow (0 | 1), layoutAlign (INHERIT | STRETCH) and layoutPositioning (AUTO | ABSOLUTE), fills and strokes (SOLID paints: { type: SOLID, color: "#RRGGBB", opacity?, variable? }, where variable binds the paint to one of the file's local colour variables by name; or { type: GRADIENT_LINEAR | GRADIENT_RADIAL, gradientStops: [{ position: 0-1, color, opacity? }], angle? (linear, degrees: 180 top to bottom, 90 left to right) or gradientTransform? }; or { type: IMAGE, image: "<PNG or JPEG path>" or imageHash, scaleMode?: FILL | FIT | STRETCH }), strokeWeight, strokeAlign (INSIDE, CENTER, OUTSIDE), cornerRadius or topLeftRadius/topRightRadius/bottomRightRadius/bottomLeftRadius, effects ({ type: DROP_SHADOW | INNER_SHADOW | LAYER_BLUR | BACKGROUND_BLUR, color?, opacity?, offset?: {x,y}, radius, spread? }) and opacity, and dashPattern (dash then gap lengths, [] for solid). On an instance: x, y, name, visible, size, and its own fills, strokes, strokeWeight, strokeAlign and dashPattern, which it keeps while the rest follows its component. On a text layer: x, y, width (fixes the width and wraps), height (fixes the box), name, visible, characters, fontFamily, fontStyle, fontSize, fills, textAlignHorizontal, lineHeight, letterSpacing, opacity, and as create_text takes them: runs (replacing the characters and their styles), paragraphs, paragraphSpacing, paragraphIndent, textDecoration, textCase, textAlignVertical, textAutoResize. A font, size, colour, spacing, decoration or case set on the layer applies to every char…

NameTypeReqDescription
handlestringyesThe handle open_file returned.
idstringyesA frame, instance or text layer you created.
propertiesobjectyes–

No output schema declared.

No examples provided.

set_style ~239

Change a colour, text or effect style, grafta's or one the file already has (a kit's brand colour, changed once): rename it, or change its values (as create_style takes them for its type). Every node using it follows, in Figma and in read_node, instances are derived again, and a text style's texts are estimated again (texts_resized). Library styles are refused.

NameTypeReqDescription
effectsarray–EFFECT: shadows and blurs, as set_properties takes them.
fillsarray–FILL: paints, as set_properties takes them.
fontFamilystring––
fontSizenumber––
fontStylestring–e.g. "Bold", "Semi Bold".
handlestringyesThe handle open_file returned.
idstringyesA style's id, or its name when only one has it.
letterSpacing––Pixels, or { value, unit: PIXELS | PERCENT }.
lineHeight––Pixels, or { value, unit: PIXELS | PERCENT }.
namestring––

No output schema declared.

No examples provided.

set_variable ~177

Change a variable grafta made: rename it, or change its value in the modes named (the others keep theirs). Values are as create_variable takes them, aliases included. Every fill bound to it follows, and a text whose size it binds is estimated again (texts_resized). The file's own variables are refused.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
idstringyesA variable's id, or its name when only one has it.
namestring––
valuesobject–Mode name → value: "#RRGGBB" or "#RRGGBBAA" for COLOR, a number for FLOAT, a string for STRING, true or false for BOOLEAN, or { "alias": "<variable name or id>" } for another local variable of the sa…

No output schema declared.

No examples provided.

set_variable_collection ~99

Change a collection grafta made: rename it, or add a mode (add_mode: "High contrast"). In a new mode every variable takes its value in the first mode, to change with set_variable. The file's own collections are refused.

NameTypeReqDescription
add_modestring––
handlestringyesThe handle open_file returned.
idstringyesA collection's id or name.
namestring––

No output schema declared.

No examples provided.

set_variant ~97

Switch an instance of a variant to another variant of its set, by the values that change: { "State": "Substitute" }. The other properties keep their values. Its overrides stay; Figma matches them to the new variant's layers.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
idstringyesAn instance of a variant.
valuesobjectyesProperty name → the value to switch to.

No output schema declared.

No examples provided.

summarize ~70

Overview of an open file: every page with its id, node count and number of top-level frames, plus totals for nodes, components, component sets, instances, text nodes, variables, styles and images, and the prototype's flows and live interactions.

NameTypeReqDescription
handlestringyesThe handle open_file returned.

No output schema declared.

No examples provided.

ungroup ~63

Ungroup a group: its layers go to the group's parent, in its place and order, each where it was on the canvas, and the group is removed.

NameTypeReqDescription
handlestringyesThe handle open_file returned.
idstringyesA group's id.

No output schema declared.

No examples provided.

Install

How do I install the grafta MCP server?

grafta runs locally as an npm package, launched with npx -y grafta mcp. Ready-made configuration for Claude, Cursor, VS Code, Codex and 5 more is on this page, copied from each client's own documentation.

npm · grafta

# add to Claude Code
claude mcp add n0ss4-grafta -- npx -y grafta mcp
Common questions

What is the grafta MCP server?

grafta is an MCP server listed in the public MCP registry as io.github.n0ss4/grafta. Talk to any Figma file with your AI: ask what's in it, change it, or turn it into code. This page covers its npm package (grafta).

Is the grafta MCP server safe to use?

grafta scores 72 out of 100 on VerifyMCP. We found no known CVEs affecting it as of 21 November 2026. It declares no install or post-install scripts. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

What tools does the grafta MCP server expose?

grafta exposes 45 tools: open_file, new_file, close_file, list_open, summarize, and 40 more. Their descriptions and schemas cost roughly 8,529 tokens of context every time the server is loaded.

Is the grafta MCP server still maintained?

grafta is still listed as active in the MCP registry. We last reached this channel on 21 November 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

What licence is the grafta MCP server under?

grafta declares the MIT licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

What did VerifyMCP test on the grafta MCP server?

VerifyMCP ran 16 checks on grafta, covering Malware scan, Known CVEs, Install scripts, Dependency health and 12 more. Endpoint Security and Transport & Reachability do not apply to an npm package, so they were not tested. The score does not measure everything, and the scoring documentation lists what it leaves out.