FluentBoards MCP Server

Instructions

Implementation Reference

• src/tools/labels.ts:119-130 (handler)

  Handler function that destructures arguments, performs safety validation for deletion, and executes the API DELETE request to remove the label from the board.

  async (args) => {
    const { board_id, label_id, confirm_delete } = args;
    
    // Validate delete operation safety
    const safetyCheck = validateDeleteOperation("label", confirm_delete);
    if (!safetyCheck.allowed) {
      return formatResponse(createDeleteSafetyError(safetyCheck));
    }
    
    const response = await api.delete(`/projects/${board_id}/labels/${label_id}`);
    return formatResponse(response.data);
  }

• src/tools/labels.ts:114-118 (schema)

  Zod schema defining input parameters for the delete_label tool: board_id, label_id, and optional confirm_delete.

  {
    board_id: z.number().int().positive().describe("Board ID"),
    label_id: z.number().int().positive().describe("Label ID"),
    confirm_delete: z.union([z.boolean(), z.string()]).optional().describe("Confirmation required: set to true, 'yes', or 'confirm' to proceed"),
  },

• src/tools/labels.ts:112-131 (registration)

  MCP server tool registration for 'delete_label', including name, description, input schema, and handler function.

    "delete_label",
    "Delete a label from a board permanently",
    {
      board_id: z.number().int().positive().describe("Board ID"),
      label_id: z.number().int().positive().describe("Label ID"),
      confirm_delete: z.union([z.boolean(), z.string()]).optional().describe("Confirmation required: set to true, 'yes', or 'confirm' to proceed"),
    },
    async (args) => {
      const { board_id, label_id, confirm_delete } = args;
      
      // Validate delete operation safety
      const safetyCheck = validateDeleteOperation("label", confirm_delete);
      if (!safetyCheck.allowed) {
        return formatResponse(createDeleteSafetyError(safetyCheck));
      }
      
      const response = await api.delete(`/projects/${board_id}/labels/${label_id}`);
      return formatResponse(response.data);
    }
  );