CC Fig MCP

Instructions

Implementation Reference

• src/talk_to_figma_mcp/tools/creation-tools.ts:584-619 (registration)

  Registration of the MCP tool 'flatten_node'. Includes the tool name, description, Zod input schema (nodeId: string), and the handler function which sends the 'flatten_node' command to Figma via sendCommandToFigma and returns a text response with the result or error.

  server.tool(
    "flatten_node",
    "Flatten a node in Figma (e.g., for boolean operations or converting to path)",
    {
      nodeId: z.string().describe("ID of the node to flatten"),
    },
    async ({ nodeId }) => {
      try {
        const result = await sendCommandToFigma("flatten_node", { nodeId });
        
        const typedResult = result as { 
          id: string, 
          name: string, 
          type: string 
        };
        
        return {
          content: [
            {
              type: "text",
              text: `Node "${typedResult.name}" flattened successfully. The new node has ID: ${typedResult.id} and is of type ${typedResult.type}.`
            }
          ]
        };
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `Error flattening node: ${error instanceof Error ? error.message : String(error)}`
            }
          ]
        };
      }
    }
  );

• src/talk_to_figma_mcp/tools/creation-tools.ts:590-617 (handler)

  The handler function for the flatten_node tool. It calls sendCommandToFigma with the nodeId, type-asserts the result, and returns a standardized MCP text response indicating success with new node details or an error message.

  async ({ nodeId }) => {
    try {
      const result = await sendCommandToFigma("flatten_node", { nodeId });
      
      const typedResult = result as { 
        id: string, 
        name: string, 
        type: string 
      };
      
      return {
        content: [
          {
            type: "text",
            text: `Node "${typedResult.name}" flattened successfully. The new node has ID: ${typedResult.id} and is of type ${typedResult.type}.`
          }
        ]
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error flattening node: ${error instanceof Error ? error.message : String(error)}`
          }
        ]
      };
    }

• src/talk_to_figma_mcp/tools/creation-tools.ts:587-589 (schema)

  Zod input schema for the flatten_node tool: requires a single 'nodeId' parameter as string, with description.

  {
    nodeId: z.string().describe("ID of the node to flatten"),
  },

• src/talk_to_figma_mcp/types/index.ts:86-86 (helper)

  'flatten_node' is included in the FigmaCommand union type, indicating it's a recognized command for sending to Figma.

  | "flatten_node"