create_component_instance

Create an instance of a Figma component at specified coordinates to integrate design elements into your workspace.

Instructions

Create an instance of a component in Figma

Input Schema

TableJSON Schema

Name	Required	Description
`componentKey`	Yes	Key of the component to instantiate
`x`	Yes	X position
`y`	Yes	Y position

Implementation Reference

src/talk_to_figma_mcp/tools/component-tools.ts:20-47 (handler)

The handler function for the MCP tool 'create_component_instance'. It sends the command to Figma using sendCommandToFigma and returns the result as text content or an error message.

  async ({ componentKey, x, y }) => {
    try {
      const result = await sendCommandToFigma("create_component_instance", {
        componentKey,
        x,
        y,
      });
      const typedResult = result as any;
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(typedResult),
          }
        ]
      }
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error creating component instance: ${error instanceof Error ? error.message : String(error)}`,
          },
        ],
      };
    }
  }
);

src/talk_to_figma_mcp/tools/component-tools.ts:15-19 (schema)
Input schema for the tool using Zod validators with descriptions for componentKey, x, and y parameters.
```
{
  componentKey: z.string().describe("Key of the component to instantiate"),
  x: z.number().describe("X position"),
  y: z.number().describe("Y position"),
},
```

src/talk_to_figma_mcp/tools/component-tools.ts:12-47 (registration)

Direct registration of the 'create_component_instance' tool on the MCP server using server.tool(), including name, description, schema, and handler.

server.tool(
  "create_component_instance",
  "Create an instance of a component in Figma",
  {
    componentKey: z.string().describe("Key of the component to instantiate"),
    x: z.number().describe("X position"),
    y: z.number().describe("Y position"),
  },
  async ({ componentKey, x, y }) => {
    try {
      const result = await sendCommandToFigma("create_component_instance", {
        componentKey,
        x,
        y,
      });
      const typedResult = result as any;
      return {
        content: [
          {
            type: "text",
            text: JSON.stringify(typedResult),
          }
        ]
      }
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error creating component instance: ${error instanceof Error ? error.message : String(error)}`,
          },
        ],
      };
    }
  }
);

src/talk_to_figma_mcp/tools/index.ts:17-17 (registration)
Invocation of registerComponentTools within the central registerTools function, which registers all tools including create_component_instance.
```
registerComponentTools(server);
```
src/talk_to_figma_mcp/types/index.ts:62-62 (helper)
The 'create_component_instance' command is included in the FigmaCommand union type used for typing internal WebSocket commands to Figma.
```
| "create_component_instance"
```

CC Fig MCP