Cursor Talk to Figma MCP

Instructions

Implementation Reference

• src/talk_to_figma_mcp/server.ts:1280-1326 (registration)

  Registration of the 'set_instance_overrides' MCP tool, including schema, description, and handler function.
  server.tool( "set_instance_overrides", "Apply previously copied overrides to selected component instances. Target instances will be swapped to the source component and all copied override properties will be applied.", { sourceInstanceId: z.string().describe("ID of the source component instance"), targetNodeIds: z.array(z.string()).describe("Array of target instance IDs. Currently selected instances will be used.") }, async ({ sourceInstanceId, targetNodeIds }) => { try { const result = await sendCommandToFigma("set_instance_overrides", { sourceInstanceId: sourceInstanceId, targetNodeIds: targetNodeIds || [] }); const typedResult = result as setInstanceOverridesResult; if (typedResult.success) { const successCount = typedResult.results?.filter(r => r.success).length || 0; return { content: [ { type: "text", text: `Successfully applied ${typedResult.totalCount || 0} overrides to ${successCount} instances.` } ] }; } else { return { content: [ { type: "text", text: `Failed to set instance overrides: ${typedResult.message}` } ] }; } } catch (error) { return { content: [ { type: "text", text: `Error setting instance overrides: ${error instanceof Error ? error.message : String(error)}` } ] }; } } );
• src/talk_to_figma_mcp/server.ts:1287-1325 (handler)

  The handler function that executes the set_instance_overrides tool logic by forwarding the command to the Figma plugin via sendCommandToFigma and processing the result.
  async ({ sourceInstanceId, targetNodeIds }) => { try { const result = await sendCommandToFigma("set_instance_overrides", { sourceInstanceId: sourceInstanceId, targetNodeIds: targetNodeIds || [] }); const typedResult = result as setInstanceOverridesResult; if (typedResult.success) { const successCount = typedResult.results?.filter(r => r.success).length || 0; return { content: [ { type: "text", text: `Successfully applied ${typedResult.totalCount || 0} overrides to ${successCount} instances.` } ] }; } else { return { content: [ { type: "text", text: `Failed to set instance overrides: ${typedResult.message}` } ] }; } } catch (error) { return { content: [ { type: "text", text: `Error setting instance overrides: ${error instanceof Error ? error.message : String(error)}` } ] }; } }
• src/talk_to_figma_mcp/server.ts:1283-1286 (schema)

  Zod input schema for the set_instance_overrides tool defining parameters sourceInstanceId and targetNodeIds.
  { sourceInstanceId: z.string().describe("ID of the source component instance"), targetNodeIds: z.array(z.string()).describe("Array of target instance IDs. Currently selected instances will be used.") },
• src/talk_to_figma_mcp/server.ts:48-59 (schema)

  TypeScript interface defining the expected result structure from the Figma plugin for set_instance_overrides.
  interface setInstanceOverridesResult { success: boolean; message: string; totalCount?: number; results?: Array<{ success: boolean; instanceId: string; instanceName: string; appliedCount?: number; message?: string; }>; }