The Home Counselor tool has one simple goal, to automate the population of providers on the Home Counseling Provider List in Encompass. Once activated, this tool will automatically fill in the providers within 500 miles of the primary borrower’s current residence after it has been filled in. This can expedite the loan process by automating what previously required manual entry or at the very least, manually accessing Encompass’s tool to download the list.


1.    Installation of the Home Counselor tool is done through the Toolshed Plugin under the Expert tier, ensure that the Home Counselor tool is licensed through Toolshed before continuing.
2.    Once the tool is activated through Toolshed’s settings, the tool will automatically run and requires no configuration at this time.  

Instructions for Use

1.    The Home Counselor Tool automatically fills in the Home Counseling Provider list based off of the Primary Borrower’s Present Address.
2.    If the list does not automatically fill immediately after filling in the address, it will be populated a short period afterwards as users work in the loan.
3.    The settings are currently preconfigured for the standard provider types, within 500 miles. This matches with Encompass’s default search criteria, and at the time of this writing is not configurable within the plugin.
4.    This tool leverages the same HUD-provided APIs that both the CFPB and Encompass use, so the data returned will be the same and up to date.

Where/What/How does this plugin query agencies?

This plugin queries the following services:

FHW - Fair Housing Pre-Purchase Education Workshops
FBC - Financial Management/Budget Counseling
FBW - Financial, Budgeting, and Credit Repair Workshops
HIC - Home Improvement and Rehabilitation Counseling
DFC - Mortgage Delinquency and Default Resolution Counseling
NDW - Non-Delinquency Post Purchase Workshops
PPC - Pre-purchase Counseling
PPW - Pre-purchase Homebuyer Education Workshops
DFW - Resolving/Preventing Mortgage Delinquency Workshops

This language queries the following languages:
English and Spanish.

The plugin is receiving data from the same source as Encompass and consumerfinance.gov, which is directly from the HUD API located at:

This plugin uses the "Search by Location" HUD API, using the geocoordinates of the borrower's present address in Encompass (fields FR0104, FR0106, FR0107, FR0108).

This plugin pulls data dynamically by distance. It starts at a distance of 50 miles from the borrower's present address and pulls all agencies in that area. If there are less than 10 agencies found, it will increase the distance to 100 and try again. It will keep repeating this in increments of 50 miles up to 2000 miles until the API returns at least 10 agencies. At that point, it will stop and process that as the agency list.

At the time of this writing, the services and languages are hard coded into the plugin. We are not able to edit this list from lender to lender. We are planning a future update where we will allow the lender to edit these options in the PowerTools settings.

Encompass Dependencies:
This product installs the following to encompass:


Custom Fields
CX.HC.IMPORT.STATUS Housing Counselor Import Status
CX.HC.IMPORT.DATE Housing Counselor Import Date