Skip to main content

​
Overview

Retrieves comprehensive information about multiple nodes at once by their IDs. This is a batch version of get_node_info that efficiently fetches information for multiple nodes in a single operation.

​
Parameters

​
nodeIds
array
required
Array of node IDs to get information about. Each ID should be a string.
nodeIds: ["123:456", "123:457", "123:458"]

​
Return Value

Returns an array of node information objects: 
[
  {
    "id": "123:456",
    "name": "Header",
    "type": "FRAME",
    "fills": [...],
    "children": [...]
  },
  {
    "id": "123:457",
    "name": "Body Text",
    "type": "TEXT",
    "characters": "Welcome to our product",
    "style": {...}
  },
  {
    "id": "123:458",
    "name": "Button",
    "type": "FRAME",
    "fills": [...]
  }
]

​
Usage Example

const nodesInfo = await use_mcp_tool({
  server_name: "TalkToFigma",
  tool_name: "get_nodes_info",
  arguments: {
    nodeIds: ["123:456", "123:457", "123:458"]
  }
});

nodesInfo.forEach(node => {
  console.log(`${node.name}: ${node.type}`);
  if (node.type === "TEXT") {
    console.log(`  Text: ${node.characters}`);
  }
});

​
Best Practices

Use this tool instead of calling get_node_info multiple times. Batch operations are more efficient.
All node IDs must be valid. If any ID is invalid, the entire operation may fail.

​
Performance Considerations

  • Batch fetching is significantly faster than individual requests
  • The tool processes all requests in parallel using Promise.all
  • Each node is filtered through the same filterFigmaNode function as get_node_info

​
Common Use Cases

  • Inspecting multiple nodes discovered through scanning operations
  • Batch analyzing children of a parent node
  • Verifying properties of multiple nodes before batch modifications
  • Collecting data from specific nodes in a design system

​
Code Location

Source: server.ts:313-348

​
Related Tools

Build docs developers (and LLMs) love

Get started for freeTalk to us