Skip to main content

List FAI Departments

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 name, or to correlate against the departmentId/roleId fields returned by company_fai. 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.

Parameters​

NameTypeRequiredDefaultDescription
namestring❌ No-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.
limitinteger❌ No-Maximum number of departments to return (>= 0). Omit for the upstream default (returns the full catalog, which is small). Combine with offset to page.
offsetinteger❌ No-Number of departments to skip before returning results (>= 0), for paging alongside limit. Omit to start from the first record.

Required Integrations​

  • hginsights_v2

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

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

company_fai, company_technographic