Skip to main content

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.

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 (>= 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.
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__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
  }
}

company_fai, company_technographic