Skip to main content

Overview

Retrieves comprehensive information about a specific node by its ID. Returns the same detailed data as read_my_design, but for any node in the document, not just the current selection.

Parameters

nodeId
string
required
The ID of the node to get information about.

Return Value

Returns a detailed JSON object containing full node information:
{
  "id": "123:456",
  "name": "Card Component",
  "type": "FRAME",
  "absoluteBoundingBox": {
    "x": 0,
    "y": 0,
    "width": 320,
    "height": 480
  },
  "fills": [
    {
      "type": "SOLID",
      "color": "#FFFFFF"
    }
  ],
  "cornerRadius": 12,
  "children": [
    // ... child nodes
  ]
}
Colors are automatically converted to hex format. VECTOR nodes are filtered out to reduce verbosity.

Usage Example

const nodeInfo = await use_mcp_tool({
  server_name: "TalkToFigma",
  tool_name: "get_node_info",
  arguments: {
    nodeId: "123:456"
  }
});

console.log(`Node: ${nodeInfo.name}`);
console.log(`Type: ${nodeInfo.type}`);
console.log(`Size: ${nodeInfo.absoluteBoundingBox.width}x${nodeInfo.absoluteBoundingBox.height}`);

Best Practices

Ensure the node ID is valid and exists in the current document. Invalid node IDs will result in an error.
Use get_selection first to obtain node IDs, or use scan_text_nodes or scan_nodes_by_types to discover node IDs.

Common Use Cases

  • Inspecting specific nodes after scanning operations
  • Getting details about parent or child nodes
  • Verifying node properties before modifications
  • Analyzing nodes referenced by ID from other operations

Code Location

Source: server.ts:179-208

Build docs developers (and LLMs) love