CC Fig MCP

Instructions

Implementation Reference

• src/talk_to_figma_mcp/tools/text-tools.ts:156-191 (registration)

  Registers the 'set_font_name' MCP tool on the server, defining its description, input schema (nodeId, family, style), and handler function that forwards the command to Figma via websocket and formats the response.

  server.tool(
    "set_font_name",
    "Set the font name and style of a text node in Figma",
    {
      nodeId: z.string().describe("The ID of the text node to modify"),
      family: z.string().describe("Font family name"),
      style: z.string().optional().describe("Font style (e.g., 'Regular', 'Bold', 'Italic')"),
    },
    async ({ nodeId, family, style }) => {
      try {
        const result = await sendCommandToFigma("set_font_name", {
          nodeId,
          family,
          style
        });
        const typedResult = result as { name: string, fontName: { family: string, style: string } };
        return {
          content: [
            {
              type: "text",
              text: `Updated font of node "${typedResult.name}" to ${typedResult.fontName.family} ${typedResult.fontName.style}`
            }
          ]
        };
      } catch (error) {
        return {
          content: [
            {
              type: "text",
              text: `Error setting font name: ${error instanceof Error ? error.message : String(error)}`
            }
          ]
        };
      }
    }
  );

• src/talk_to_figma_mcp/tools/text-tools.ts:164-190 (handler)

  The core handler logic for the 'set_font_name' tool: sends the command to Figma, type-casts the result, and returns a formatted text response or error.

  async ({ nodeId, family, style }) => {
    try {
      const result = await sendCommandToFigma("set_font_name", {
        nodeId,
        family,
        style
      });
      const typedResult = result as { name: string, fontName: { family: string, style: string } };
      return {
        content: [
          {
            type: "text",
            text: `Updated font of node "${typedResult.name}" to ${typedResult.fontName.family} ${typedResult.fontName.style}`
          }
        ]
      };
    } catch (error) {
      return {
        content: [
          {
            type: "text",
            text: `Error setting font name: ${error instanceof Error ? error.message : String(error)}`
          }
        ]
      };
    }
  }

• src/talk_to_figma_mcp/tools/text-tools.ts:159-163 (schema)

  Zod schema for input parameters: nodeId (string), family (string), style (optional string).

  {
    nodeId: z.string().describe("The ID of the text node to modify"),
    family: z.string().describe("Font family name"),
    style: z.string().optional().describe("Font style (e.g., 'Regular', 'Bold', 'Italic')"),
  },

• src/talk_to_figma_mcp/types/index.ts:71-71 (schema)

  Type definition including 'set_font_name' in the FigmaCommand union type for internal command validation.

  | "set_font_name"

• src/talk_to_figma_mcp/tools/index.ts:16-16 (registration)

  Calls registerTextTools which includes registration of 'set_font_name' tool.

  registerTextTools(server);