set_stroke_color
Modify stroke color and weight for design elements in Figma by specifying RGB values and optional opacity settings.
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
- The handler function that implements the core logic for the 'set_stroke_color' tool. It validates required RGB components, applies defaults for alpha and stroke weight using utility functions, sends the formatted command to Figma over websocket, and returns a structured text response with the node's name 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 schema defining the input parameters for the 'set_stroke_color' tool, including required nodeId and RGB values (0-1 range), optional alpha and strokeWeight with validation.{ 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)The complete registration of the 'set_stroke_color' MCP tool using server.tool(), including tool name, description, input schema, and inline handler function. This is called within registerModificationTools which is invoked from the tools index.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)}`, }, ], }; } } );