Figma MCP Server

Instructions

Implementation Reference

• index.ts:229-245 (handler)

  Primary handler function for the post_comment tool. It calls the Figma API helper and formats the response as MCP CallToolResult.

  async function doPostComment(
    fileKey: string,
    message: string,
    x: number,
    y: number,
    nodeId?: string
  ): Promise<CallToolResult> {
    const data = await postComment(fileKey, message, x, y, nodeId);
    return {
      content: [
        {
          type: "text",
          text: JSON.stringify(data, null, 2),
        },
      ],
    };
  }

• index.ts:83-113 (schema)

  Tool definition for post_comment, including name, description, and detailed input schema.

  const POST_COMMENT: Tool = {
    name: "post_comment",
    description: "Post a comment on a node in a Figma file",
    inputSchema: {
      type: "object",
      properties: {
        file_key: {
          type: "string",
          description: "The key of the Figma file",
        },
        node_id: {
          type: "string",
          description:
            "The ID of the node to comment on. Node ids have the format `<number>:<number>`",
        },
        message: {
          type: "string",
          description: "The comment message",
        },
        x: {
          type: "number",
          description: "The x coordinate of the comment pin",
        },
        y: {
          type: "number",
          description: "The y coordinate of the comment pin",
        },
      },
      required: ["file_key", "message", "x", "y"],
    },
  };

• index.ts:138-140 (registration)

  Registration of the POST_COMMENT tool in the listTools request handler.

  server.setRequestHandler(ListToolsRequestSchema, async () => ({
    tools: [ADD_FIGMA_FILE, VIEW_NODE, READ_COMMENTS, POST_COMMENT, REPLY_TO_COMMENT],
  }));

• index.ts:280-289 (handler)

  Dispatch handler in CallToolRequestSchema that routes post_comment requests to the doPostComment function.

  if (request.params.name === "post_comment") {
    const input = request.params.arguments as {
      file_key: string;
      node_id?: string;
      message: string;
      x: number;
      y: number;
    };
    return doPostComment(input.file_key, input.message, input.x, input.y, input.node_id);
  }

• figma_api.ts:110-131 (helper)

  Core helper function that performs the actual HTTP POST request to the Figma Comments API.

  export async function postComment(
    fileKey: string,
    message: string,
    x: number,
    y: number,
    nodeId?: string
  ) {
    const response = await axios.post(
      `https://api.figma.com/v1/files/${fileKey}/comments`,
      {
        message,
        client_meta: { node_offset: { x, y }, node_id: nodeId },
      },
      {
        headers: {
          "X-FIGMA-TOKEN": getFigmaApiKey(),
          "Content-Type": "application/json",
        },
      }
    );
    return response.data;
  }