Claude Talk to Figma MCP

Instructions

Implementation Reference

• src/talk_to_figma_mcp/tools/document-tools.ts:224-297 (handler)

  Full registration and handler implementation for the 'scan_text_nodes' MCP tool. The handler proxies the request to the Figma plugin's scan_text_nodes command with chunking enabled, processes the response, and returns formatted content including progress status and results.
  server.tool( "scan_text_nodes", "Scan all text nodes in the selected Figma node", { nodeId: z.string().describe("ID of the node to scan"), }, async ({ nodeId }) => { try { // Initial response to indicate we're starting the process const initialStatus = { type: "text" as const, text: "Starting text node scanning. This may take a moment for large designs...", }; // Use the plugin's scan_text_nodes function with chunking flag const result = await sendCommandToFigma("scan_text_nodes", { nodeId, useChunking: true, // Enable chunking on the plugin side chunkSize: 10 // Process 10 nodes at a time }); // If the result indicates chunking was used, format the response accordingly if (result && typeof result === 'object' && 'chunks' in result) { const typedResult = result as { success: boolean, totalNodes: number, processedNodes: number, chunks: number, textNodes: Array<any> }; const summaryText = ` Scan completed: - Found ${typedResult.totalNodes} text nodes - Processed in ${typedResult.chunks} chunks `; return { content: [ initialStatus, { type: "text" as const, text: summaryText }, { type: "text" as const, text: JSON.stringify(typedResult.textNodes, null, 2) } ], }; } // If chunking wasn't used or wasn't reported in the result format, return the result as is return { content: [ initialStatus, { type: "text", text: JSON.stringify(result, null, 2), }, ], }; } catch (error) { return { content: [ { type: "text", text: `Error scanning text nodes: ${error instanceof Error ? error.message : String(error)}`, }, ], }; } } );
• src/talk_to_figma_mcp/tools/document-tools.ts:227-229 (schema)

  Input schema for the scan_text_nodes tool using Zod validation for nodeId parameter.
  { nodeId: z.string().describe("ID of the node to scan"), },
• src/talk_to_figma_mcp/tools/index.ts:12-19 (registration)

  Higher-level tool registration that calls registerDocumentTools(server), which includes scan_text_nodes.
  export function registerTools(server: McpServer): void { // Register all tool categories registerDocumentTools(server); registerCreationTools(server); registerModificationTools(server); registerTextTools(server); registerComponentTools(server); }
• src/talk_to_figma_mcp/server.ts:34-34 (registration)

  Main server setup calls registerTools, indirectly registering scan_text_nodes tool.
  registerTools(server);
• src/talk_to_figma_mcp/types/index.ts:68-68 (schema)

  Type definition including 'scan_text_nodes' as a valid FigmaCommand used by the websocket communication.
  | "scan_text_nodes"