create_star
Add a customizable star shape to Figma designs by specifying position, size, points, colors, and other properties for precise graphic creation.
Instructions
Create a new star in Figma
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| x | Yes | X position | |
| y | Yes | Y position | |
| width | Yes | Width of the star | |
| height | Yes | Height of the star | |
| points | No | Number of points (default: 5) | |
| innerRadius | No | Inner radius ratio (0.01-0.99, default: 0.5) | |
| name | No | Optional name for the star | |
| parentId | No | Optional parent node ID to append the star to | |
| fillColor | No | Fill color in RGBA format | |
| strokeColor | No | Stroke color in RGBA format | |
| strokeWeight | No | Stroke weight |
Implementation Reference
- The handler function that implements the core logic for the 'create_star' tool. It sends a 'create_star' command to Figma using sendCommandToFigma with parameters like position, size, points, inner radius, colors, etc., and returns a formatted response with the created star's ID or an error message.
try { const result = await sendCommandToFigma("create_star", { x, y, width, height, points: points || 5, innerRadius: innerRadius || 0.5, name: name || "Star", parentId, fillColor, strokeColor, strokeWeight, }); const typedResult = result as { id: string, name: string }; return { content: [ { type: "text", text: `Created star with ID: ${typedResult.id}, ${points || 5} points, and inner radius ratio of ${innerRadius || 0.5}` } ] }; } catch (error) { return { content: [ { type: "text", text: `Error creating star: ${error instanceof Error ? error.message : String(error)}` } ] }; } } ); - Zod input schema for the 'create_star' tool, validating parameters such as position (x,y), dimensions (width, height), star properties (points, innerRadius), name, parentId, and styling (fillColor, strokeColor, strokeWeight).
x: z.number().describe("X position"), y: z.number().describe("Y position"), width: z.number().describe("Width of the star"), height: z.number().describe("Height of the star"), points: z.number().min(3).optional().describe("Number of points (default: 5)"), innerRadius: z.number().min(0.01).max(0.99).optional().describe("Inner radius ratio (0.01-0.99, default: 0.5)"), name: z.string().optional().describe("Optional name for the star"), parentId: z.string().optional().describe("Optional parent node ID to append the star to"), fillColor: z .object({ 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)"), }) .optional() .describe("Fill color in RGBA format"), strokeColor: z .object({ 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)"), }) .optional() .describe("Stroke color in RGBA format"), strokeWeight: z.number().positive().optional().describe("Stroke weight"), }, async ({ x, y, width, height, points, innerRadius, name, parentId, fillColor, strokeColor, strokeWeight }) => { - src/talk_to_figma_mcp/tools/creation-tools.ts:353-422 (registration)The MCP server.tool() call that registers the 'create_star' tool, specifying its name, description, input schema, and handler function.
server.tool( "create_star", "Create a new star in Figma", { x: z.number().describe("X position"), y: z.number().describe("Y position"), width: z.number().describe("Width of the star"), height: z.number().describe("Height of the star"), points: z.number().min(3).optional().describe("Number of points (default: 5)"), innerRadius: z.number().min(0.01).max(0.99).optional().describe("Inner radius ratio (0.01-0.99, default: 0.5)"), name: z.string().optional().describe("Optional name for the star"), parentId: z.string().optional().describe("Optional parent node ID to append the star to"), fillColor: z .object({ 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)"), }) .optional() .describe("Fill color in RGBA format"), strokeColor: z .object({ 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)"), }) .optional() .describe("Stroke color in RGBA format"), strokeWeight: z.number().positive().optional().describe("Stroke weight"), }, async ({ x, y, width, height, points, innerRadius, name, parentId, fillColor, strokeColor, strokeWeight }) => { try { const result = await sendCommandToFigma("create_star", { x, y, width, height, points: points || 5, innerRadius: innerRadius || 0.5, name: name || "Star", parentId, fillColor, strokeColor, strokeWeight, }); const typedResult = result as { id: string, name: string }; return { content: [ { type: "text", text: `Created star with ID: ${typedResult.id}, ${points || 5} points, and inner radius ratio of ${innerRadius || 0.5}` } ] }; } catch (error) { return { content: [ { type: "text", text: `Error creating star: ${error instanceof Error ? error.message : String(error)}` } ] }; } } ); - src/talk_to_figma_mcp/tools/index.ts:14-14 (registration)Call to registerCreationTools(server) within registerTools, which includes registration of the create_star tool.
registerCreationTools(server); - TypeScript union type FigmaCommand that includes 'create_star' as one of the supported Figma commands used by the tool handler.
export type FigmaCommand = | "get_document_info" | "get_selection" | "get_node_info" | "create_rectangle" | "create_frame" | "create_text" | "create_ellipse" | "create_polygon" | "create_star" | "create_vector" | "create_line" | "set_fill_color" | "set_stroke_color" | "move_node" | "resize_node" | "delete_node" | "get_styles" | "get_local_components" | "get_team_components" | "create_component_instance" | "export_node_as_image" | "join" | "set_corner_radius" | "clone_node" | "set_text_content" | "scan_text_nodes" | "set_multiple_text_contents" | "set_auto_layout" | "set_font_name" | "set_font_size" | "set_font_weight" | "set_letter_spacing" | "set_line_height" | "set_paragraph_spacing" | "set_text_case" | "set_text_decoration" | "get_styled_text_segments" | "load_font_async" | "get_remote_components" | "set_effects" | "set_effect_style_id" | "group_nodes" | "ungroup_nodes" | "flatten_node" | "insert_child";