set_stroke_color
Change the stroke color of Figma design elements using RGB values and optional transparency settings.
Instructions
Set the stroke color of a node in Figma
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| nodeId | Yes | The ID of the node to modify | |
| r | Yes | Red component (0-1) | |
| g | Yes | Green component (0-1) | |
| b | Yes | Blue component (0-1) | |
| a | No | Alpha component (0-1) | |
| weight | No | Stroke weight |
Implementation Reference
- src/cursor_mcp_plugin/code.js:714-766 (handler)Core Figma plugin implementation that sets the stroke color and optional weight on the specified node by updating node.strokes and node.strokeWeight.
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:616-656 (registration)MCP server tool registration for set_stroke_color, including schema validation with Zod and handler that proxies 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:131-132 (handler)Dispatch handler in Figma plugin's main command switch that routes set_stroke_color calls to the setStrokeColor implementation.
case "set_stroke_color": return await setStrokeColor(params); - Zod schema for input validation of set_stroke_color tool parameters.
{ 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"),