set_stroke_color
Modify the stroke color of a Figma design element by specifying the RGB values and optional alpha transparency, enabling precise adjustments to visual elements.
Instructions
Set the stroke color of a node in Figma
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| a | No | Alpha component (0-1) | |
| b | Yes | Blue component (0-1) | |
| g | Yes | Green component (0-1) | |
| nodeId | Yes | The ID of the node to modify | |
| r | Yes | Red component (0-1) | |
| weight | No | Stroke weight |
Implementation Reference
- src/cursor_mcp_plugin/code.js:436-488 (handler)The core Figma plugin handler function that executes the stroke color setting logic on a selected node using the Figma API.async function setStrokeColor(params) { const { nodeId, color: { r, g, b, a }, weight = 1, } = params || {}; if (!nodeId) { throw new Error("Missing nodeId parameter"); } const node = await figma.getNodeByIdAsync(nodeId); if (!node) { throw new Error(`Node not found with ID: ${nodeId}`); } if (!("strokes" in node)) { throw new Error(`Node does not support strokes: ${nodeId}`); } // Create RGBA color const rgbColor = { r: r !== undefined ? r : 0, g: g !== undefined ? g : 0, b: b !== undefined ? b : 0, a: a !== undefined ? a : 1, }; // Set stroke const paintStyle = { type: "SOLID", color: { r: rgbColor.r, g: rgbColor.g, b: rgbColor.b, }, opacity: rgbColor.a, }; node.strokes = [paintStyle]; // Set stroke weight if available if ("strokeWeight" in node) { node.strokeWeight = weight; } return { id: node.id, name: node.name, strokes: node.strokes, strokeWeight: "strokeWeight" in node ? node.strokeWeight : undefined, }; }
- src/talk_to_figma_mcp/server.ts:304-342 (registration)MCP server tool registration for 'set_stroke_color', including input schema validation with Zod and proxy handler that forwards the command to the Figma plugin via WebSocket.server.tool( "set_stroke_color", "Set the stroke color of a node in Figma", { nodeId: z.string().describe("The ID of the node to modify"), r: z.number().min(0).max(1).describe("Red component (0-1)"), g: z.number().min(0).max(1).describe("Green component (0-1)"), b: z.number().min(0).max(1).describe("Blue component (0-1)"), a: z.number().min(0).max(1).optional().describe("Alpha component (0-1)"), weight: z.number().positive().optional().describe("Stroke weight") }, async ({ nodeId, r, g, b, a, weight }) => { try { const result = await sendCommandToFigma('set_stroke_color', { nodeId, color: { r, g, b, a: a || 1 }, weight: weight || 1 }); const typedResult = result as { name: string }; return { content: [ { type: "text", text: `Set stroke color of node "${typedResult.name}" to RGBA(${r}, ${g}, ${b}, ${a || 1}) with weight ${weight || 1}` } ] }; } catch (error) { return { content: [ { type: "text", text: `Error setting stroke color: ${error instanceof Error ? error.message : String(error)}` } ] }; } } );
- src/cursor_mcp_plugin/code.js:81-82 (handler)Switch case in Figma plugin's handleCommand function that routes 'set_stroke_color' calls to the setStrokeColor handler.case "set_stroke_color": return await setStrokeColor(params);
- Zod schema defining input parameters for the set_stroke_color MCP tool.{ nodeId: z.string().describe("The ID of the node to modify"), r: z.number().min(0).max(1).describe("Red component (0-1)"), g: z.number().min(0).max(1).describe("Green component (0-1)"), b: z.number().min(0).max(1).describe("Blue component (0-1)"), a: z.number().min(0).max(1).optional().describe("Alpha component (0-1)"), weight: z.number().positive().optional().describe("Stroke weight") },