mcp-figma

Instructions

Implementation Reference

• src/handlers/files.ts:66-70 (handler)

  The core handler function for the 'post_comment' tool. It destructures the fileKey and comment data from args and makes a POST request to the Figma API endpoint for comments.

  async postComment(args: PostCommentArgs) {
    const { fileKey, ...commentData } = args;
    
    return this.api.makeRequest(`/files/${fileKey}/comments`, 'POST', commentData);
  }

• src/types/files.ts:31-44 (schema)

  TypeScript interface defining the input arguments for the post_comment tool, used for type checking.

  export interface PostCommentArgs {
    fileKey: string;
    message: string;
    client_meta?: {
      x: number;
      y: number;
      node_id?: string;
      node_offset?: {
        x: number;
        y: number;
      };
    };
    comment_id?: string;
  }

• src/index.ts:235-272 (registration)

  MCP tool registration in ListTools handler, defining the name, description, and input schema for 'post_comment'.

  {
    name: 'post_comment',
    description: 'Post a comment on a Figma file',
    inputSchema: {
      type: 'object',
      properties: {
        fileKey: {
          type: 'string',
          description: 'The key of the file to comment on'
        },
        message: {
          type: 'string',
          description: 'Comment message text'
        },
        client_meta: {
          type: 'object',
          properties: {
            x: { type: 'number' },
            y: { type: 'number' },
            node_id: { type: 'string' },
            node_offset: {
              type: 'object',
              properties: {
                x: { type: 'number' },
                y: { type: 'number' }
              }
            }
          },
          description: 'Optional. Position of the comment'
        },
        comment_id: {
          type: 'string',
          description: 'Optional. ID of comment to reply to'
        }
      },
      required: ['fileKey', 'message']
    },
  },

• src/index.ts:530-536 (registration)

  MCP CallTool request handler case for 'post_comment', which validates args and delegates to FilesHandler.postComment.

  case 'post_comment': {
    const args = this.validateArgs<PostCommentArgs>(request.params.arguments, ['fileKey', 'message']);
    const result = await this.filesHandler.postComment(args);
    return {
      content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
    };
  }