set_stroke_color
Change the stroke color of Figma design elements using RGB values with optional opacity and weight adjustments for precise visual styling.
Instructions
Set the stroke color of a node in Figma (defaults: opacity 1, weight 1)
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) | |
| strokeWeight | No | Stroke weight >= 0) |
Implementation Reference
- Handler function for 'set_stroke_color' tool. Validates RGB inputs, applies defaults to color (alpha=1) and strokeWeight (=1), sends the command to Figma via sendCommandToFigma, parses result, and returns a text response with success or error message.async ({ nodeId, r, g, b, a, strokeWeight }) => { try { if (r === undefined || g === undefined || b === undefined) { throw new Error("RGB components (r, g, b) are required and cannot be undefined"); } const colorInput: Color = { r, g, b, a }; const colorWithDefaults = applyColorDefaults(colorInput); const strokeWeightWithDefault = applyDefault(strokeWeight, FIGMA_DEFAULTS.stroke.weight); const result = await sendCommandToFigma("set_stroke_color", { nodeId, color: colorWithDefaults, strokeWeight: strokeWeightWithDefault, }); const typedResult = result as { name: string }; return { content: [ { type: "text", text: `Set stroke color of node "${typedResult.name}" to RGBA(${r}, ${g}, ${b}, ${colorWithDefaults.a}) with weight ${strokeWeightWithDefault}`, }, ], }; } catch (error) { return { content: [ { type: "text", text: `Error setting stroke color: ${error instanceof Error ? error.message : String(error)}`, }, ], }; }
- Zod input schema defining parameters for the set_stroke_color tool: nodeId (string), r/g/b (0-1 numbers), optional a (alpha), optional strokeWeight (>=0).{ 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)"), strokeWeight: z.number().min(0).optional().describe("Stroke weight >= 0)"), },
- src/talk_to_figma_mcp/tools/modification-tools.ts:62-110 (registration)server.tool() registration call for 'set_stroke_color' including name, description, input schema, and handler function. This is called from registerModificationTools(server).server.tool( "set_stroke_color", "Set the stroke color of a node in Figma (defaults: opacity 1, weight 1)", { 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)"), strokeWeight: z.number().min(0).optional().describe("Stroke weight >= 0)"), }, async ({ nodeId, r, g, b, a, strokeWeight }) => { try { if (r === undefined || g === undefined || b === undefined) { throw new Error("RGB components (r, g, b) are required and cannot be undefined"); } const colorInput: Color = { r, g, b, a }; const colorWithDefaults = applyColorDefaults(colorInput); const strokeWeightWithDefault = applyDefault(strokeWeight, FIGMA_DEFAULTS.stroke.weight); const result = await sendCommandToFigma("set_stroke_color", { nodeId, color: colorWithDefaults, strokeWeight: strokeWeightWithDefault, }); const typedResult = result as { name: string }; return { content: [ { type: "text", text: `Set stroke color of node "${typedResult.name}" to RGBA(${r}, ${g}, ${b}, ${colorWithDefaults.a}) with weight ${strokeWeightWithDefault}`, }, ], }; } catch (error) { return { content: [ { type: "text", text: `Error setting stroke color: ${error instanceof Error ? error.message : String(error)}`, }, ], }; } } );
- Included in FigmaCommand type union for TypeScript typing of commands sent to Figma websocket.| "set_stroke_color"
- src/talk_to_figma_mcp/tools/index.ts:16-16 (registration)Higher-level registration call to registerModificationTools which includes set_stroke_color, invoked from registerTools(server).registerModificationTools(server);