List FAI Departments

Coming soon

The v2 MCP API is in preview and not yet generally available. These pages document its tools and request/response shapes; live data access is limited to enrolled organizations until v2 is released.

Resolver for the Functional Area Intelligence (FAI) taxonomy: lists the valid FAI department and role names (with their hex-encoded IDs) from the official HG Insights catalog. Returns each department's hex ID and name plus its roles (role hex ID and name). The catalog is company-independent — this tool does NOT return any company's technology usage. Use this when you need to discover or confirm the canonical name/ID of a department or role before querying departmental data — for example to resolve a valid department_ids value for company_fai, or to map the departmentId/roleId fields returned by company_fai back to human-readable names. Always look up department and role IDs here rather than guessing or fabricating them. Do NOT use this when you want how a company actually uses products across its departments — call company_fai (actual departmental tech usage) with a company_domain or hg_id instead. Optionally filter by department name (case-insensitive partial match) and page with limit/offset.

Credits

Free — No credits consumed. See the full credit table for how AI Credits work.

Parameters

Name	Type	Default	Description
name	string	-	Case-insensitive partial-match filter on the department name, e.g. 'eng' matches 'Engineering'. Use it to resolve a canonical department name (and its roles) before calling company_fai. Matching is delegated to the upstream catalog. Omit to list the full department catalog.
limit	integer	-	Maximum number of departments to return (>= 1). Omit to use the upstream default of 10 rows per page; pass a higher limit (e.g. 100) or paginate with offset to retrieve the full catalog. The response's count is the total matching-record count, which may exceed the number of rows in data — check data.length or paginate until you have seen count rows.
offset	integer	-	Number of departments to skip before returning results (>= 0), for paging alongside limit. Omit to start from the first record.

Required Integrations

This tool is only available when your organization has the following integration configured in the Phoenix Integrations settings:

• HG Insights (Data API) (hginsights_v2__data_api)

Use Cases

• What are the valid FAI department names? — omit all params to list the full catalog
• Resolve a canonical department name before company_fai — name (partial match → exact name + roles)
• Look up the roles within a department — name (department → its role names and IDs)
• Map a departmentId/roleId returned by company_fai back to its human-readable name
• Confirm a department exists before building a query — name (validate spelling/casing)

Example Usage

List every FAI department

{
  "tool": "list_fai_departments",
  "arguments": {}
}

Resolve the Engineering department and its roles

{
  "tool": "list_fai_departments",
  "arguments": {
    "name": "engineering"
  }
}

Look up the Sales department (first 5)

{
  "tool": "list_fai_departments",
  "arguments": {
    "name": "sales",
    "limit": 5
  }
}

Response Format

Field	Type	Description
count	number	Total number of matching FAI departments (upstream total, may exceed returned rows)
data	array	List of FAI departments
data[].id	string	FAI department ID (hex-encoded)
data[].name	string	FAI department name
data[].roles	array	Roles within the department
data[].roles[].id	string	FAI role ID (hex-encoded)
data[].roles[].name	string	FAI role name

Related Tools

company_fai, company_technographic