FluentBoards MCP Server

Instructions

Implementation Reference

• src/tools/comments.ts:30-58 (handler)

  Handler function that constructs the comment data from input arguments, conditionally adds parent_id and notify_users, makes a POST request to the API to add the comment to the specified task, and returns the formatted response.

  async (args) => {
    const {
      board_id,
      task_id,
      comment,
      comment_type,
      parent_id,
      notify_users,
    } = args;
  
    const commentData: any = {
      comment: comment,
      comment_type: comment_type,
    };
  
    if (parent_id) {
      commentData.parent_id = parent_id;
    }
  
    if (notify_users && notify_users.length > 0) {
      commentData.notify_users = notify_users;
    }
  
    const response = await api.post(
      `/projects/${board_id}/tasks/${task_id}/comments`,
      commentData
    );
    return formatResponse(response.data);
  }

• src/tools/comments.ts:7-60 (registration)

  Registers the 'add_comment' tool on the MCP server, including description, input schema using Zod, and the handler function.

  export function registerCommentTools(server: McpServer) {
    // Add a comment to a task
    server.tool(
      "add_comment",
      "Add a comment to a task",
      {
        board_id: z.number().int().positive().describe("Board ID"),
        task_id: z.number().int().positive().describe("Task ID"),
        comment: z.string().min(1).describe("Comment text"),
        comment_type: CommentTypeSchema.default("comment").describe(
          "Comment type - 'comment' for new comments, 'reply' for replies"
        ),
        parent_id: z
          .number()
          .int()
          .positive()
          .optional()
          .describe("Parent comment ID (required for replies)"),
        notify_users: z
          .array(z.number().int().positive())
          .optional()
          .describe("User IDs to notify"),
      },
      async (args) => {
        const {
          board_id,
          task_id,
          comment,
          comment_type,
          parent_id,
          notify_users,
        } = args;
  
        const commentData: any = {
          comment: comment,
          comment_type: comment_type,
        };
  
        if (parent_id) {
          commentData.parent_id = parent_id;
        }
  
        if (notify_users && notify_users.length > 0) {
          commentData.notify_users = notify_users;
        }
  
        const response = await api.post(
          `/projects/${board_id}/tasks/${task_id}/comments`,
          commentData
        );
        return formatResponse(response.data);
      }
    );
  }

• src/types/index.ts:37-44 (schema)

  Zod schema defining the input structure for adding a comment, matching the tool's parameters exactly.

  export const AddCommentSchema = z.object({
    board_id: z.number().int().positive(),
    task_id: z.number().int().positive(),
    comment: z.string().min(1),
    comment_type: CommentTypeSchema.default("comment"),
    parent_id: z.number().int().positive().optional(),
    notify_users: z.array(z.number().int().positive()).optional(),
  });

• src/index.ts:24-24 (registration)

  Top-level registration call that invokes registerCommentTools to add the add_comment tool to the MCP server.

  registerCommentTools(server);

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

  Helper schema for comment_type used within the add_comment tool's input schema.

  export const CommentTypeSchema = z.enum(["comment", "reply"]);