Company Technographic

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.

Call this when a user asks what technology a company uses, what its tech stack is, or whether a specific product is installed. Returns installs with product_name, vendor_name, intensity (usage signal — higher = broader use), country_code, 5-level category hierarchy, verification dates, and numeric product_id/vendor_id for chaining. Filter by category_ids (32-char hex from get_product_category), vendor_ids, product_ids, product_attribute_ids, or last_verified_date. To filter by vendor or product without resolving IDs, pass vendor_names/product_names — case-insensitive substring matches (OR within the list), so an exact canonical name is not required; prefer vendor_ids/product_ids only when you already have resolved IDs. Global/unattributed installs (country_code: null) are included by default; use granularity or country_codes to change scope. total_installs_count and has_more are returned — if has_more is true (even at the default max_results:50) the installs are a partial view of the stack; narrow with specific category_ids, vendor_ids, or product_ids (or page via offset) rather than assuming it is complete. Fortune 500 companies can have 1,000+ installs — filter, keep max_results ≤50, and use include_description:false or install_fields to stay compact. company_id signal: on UNFILTERED calls company_id:"" means not in catalog; with a filter it may instead mean zero matching installs. Non-empty company_id + empty installs = found, no match. Use this only when you already know the company (by domains/hg_ids); to find WHICH companies use a given product/vendor/category, use search_companies (its installs filter) — this tool never discovers companies. Do NOT use for usage trend over time (company_install_time_series), department/role usage (company_fai), or spend (company_spend). Provide domains or hg_ids (up to 25).

Credits

2 — Per call. See the full credit table for how AI Credits work.

Parameters

Name	Type	Default	Description
hg_ids	array	-	HG Insights company IDs for batch technographic lookup (up to 25). Each is 31-32 alphanumeric/hex chars, from a previous search_companies result. Provide hg_ids or domains (at least one is required); both may be combined.
domains	array	-	Company domains for batch technographic lookup (e.g. ['cisco.com', 'salesforce.com'], up to 25). Protocol prefixes, leading www., and trailing paths are stripped automatically; case is normalized. Provide hg_ids or domains; both may be combined.
category_ids	array	-	Filter by exact HG Insights category IDs (OR-within-the-list). Get category_id values (32-char hex) from get_product_category, then pass them here. Preferred over product/vendor IDs when filtering by technology category.
product_ids	array	-	Filter by exact HG Insights numeric product IDs (OR-within-the-list). Get IDs from get_vendor_information, or from a previous result's product_id field.
product_names	array	-	Filter by product name substrings (case-insensitive, OR-within-the-list). Combine with product_ids for exact+fuzzy matching. Prefer product_ids when you have resolved IDs.
vendor_ids	array	-	Filter by exact HG Insights numeric vendor IDs (OR-within-the-list). Call get_vendor_information first to resolve a vendor name to its integer vendor_id, then pass that ID here. You can also reuse vendor_id values from a previous company_technographic result.
vendor_names	array	-	Filter by vendor name substrings (case-insensitive, OR-within-the-list). Combine with vendor_ids for exact+fuzzy matching. Prefer vendor_ids when you have resolved IDs.
country_codes	array	-	ISO alpha-2 country codes to include installs from (e.g. ["US","GB"]). When set, only installs from these countries are returned, and results are automatically returned country-scoped (one row per product per country with country_code populated) unless you override granularity explicitly. When multiple codes are passed, the same product may appear as multiple rows — one per country with its own intensity score. Deduplicate on product_id if you need a unique product list.
granularity	string	-	Shape of the returned installs. 'global' returns deduplicated rows per product (country_code: null); 'country' returns one row per product per country with country_code populated. Leave unset to include global / unattributed installs by default — this is what surfaces vendors that only appear as global installs, which typically score higher intensity than country-scoped installs. Pass granularity:"country" when you want country-specific rows and ranking. NOTE: passing country_codes already defaults granularity to 'country'; set this explicitly only to override that (e.g. granularity:"global" to still get deduplicated product rows while filtering by country).
product_attribute_ids	array	-	Filter by HG Insights numeric product attribute IDs (OR-within-the-list). Get attribute IDs from get_product_attribute. Useful for filtering installs by cross-cutting attributes (e.g. open-source, cloud-native).
last_verified_date	object	-	Filter installs by their last-verified date, as a range object { from, to } (both optional, YYYY-MM-DD, inclusive). Use "to" to exclude stale installs (e.g. { "to": "2022-01-01" } finds installs not seen recently); use "from" for recently-verified installs; supply both to bound a window.
last_verified_date.from	string	-	Include installs last verified on or after this date (YYYY-MM-DD, inclusive).
last_verified_date.to	string	-	Include installs last verified on or before this date (YYYY-MM-DD, inclusive).
max_results	number	50	Maximum number of installs to return (1-100, default 50). For companies with large tech footprints (typically Fortune 500), unfiltered requests with max_results >50 may fail with HTTP 422 — respond by adding category_ids, product_ids, or vendor_ids filters, or reducing max_results to ≤50. Prefer filters over large max_results.
offset	integer	0	Pagination offset (default 0, max 10 000). Use with max_results to page through installs.
sort	string	-	Sort order for returned installs. 'intensity' = highest usage signal first (default upstream behavior). 'last_seen' = most recently verified first.
install_fields	array	-	Limit which fields are returned per install. Omit to return all fields. Useful when you only need a subset (e.g. ["product_name","vendor_name","intensity"]) to keep the response compact. Unknown field names are rejected.
include_description	boolean	false	When false (default), strips product_description from every install (~60% smaller payload). Set to true only when product descriptions are explicitly needed. Overrides install_fields even if product_description is listed there.

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 technology / tech stack does a company use? — batch call by domains or hg_ids, no filters
• Does a company use a specific vendor's products? — vendor_names substring filter (or vendor_ids once resolved via get_vendor_information)
• What tools in a given category does a company have installed? — category_ids filter (32-char hex from get_product_category)
• Is a specific product installed at these companies? — product_ids/product_names filter across a batch
• Which country markets is a technology deployed in? — country_codes with country-scoped rows and per-country intensity

Example Usage

Full tech stack for Cisco and Salesforce, top 50 by intensity

{
  "tool": "company_technographic",
  "arguments": {
    "domains": [
      "cisco.com",
      "salesforce.com"
    ]
  }
}

Salesforce products at Cisco (vendor_ids resolved via get_vendor_information)

{
  "tool": "company_technographic",
  "arguments": {
    "domains": [
      "cisco.com"
    ],
    "vendor_ids": [
      376
    ]
  }
}

CRM-category tools at Microsoft by category (compact fields, no descriptions)

{
  "tool": "company_technographic",
  "arguments": {
    "domains": [
      "microsoft.com"
    ],
    "category_ids": [
      "0123456789abcdef0123456789abcdef"
    ],
    "install_fields": [
      "product_name",
      "vendor_name",
      "intensity"
    ],
    "max_results": 20
  }
}

Response Format

Field	Type	Description
companies	array
companies[].company_id	string	HG Insights company identifier (hex).
companies[].company_domain	string	The company domain that was queried.
companies[].installs	array	List of technology installs (tech stack), passed through from the HG v2 API.
companies[].installs[].product_id	integer	Numeric product identifier (use with company_fai product_ids).
companies[].installs[].product_name	string	Name of the technology product.
companies[].installs[].product_description	string	Description of the product.
companies[].installs[].vendor_id	integer	Numeric vendor identifier.
companies[].installs[].vendor_name	string	Name of the technology vendor.
companies[].installs[].vendor_domain	string	Vendor domain.
companies[].installs[].product_category_id	string	HG technology-taxonomy code (e.g. SW012).
companies[].installs[].product_category_level1_name	string	Top-level product category.
companies[].installs[].product_category_level2_name	string	Level-2 product category.
companies[].installs[].product_category_level3_name	string	Level-3 product category.
companies[].installs[].product_category_level4_name	string | null	Level-4 product category (may be null).
companies[].installs[].product_category_level5_name	string | null	Level-5 product category (may be null).
companies[].installs[].country_code	string | null	Install country (null for global / unattributed installs).
companies[].installs[].product_last_verified_date	string	Date the install was last verified (YYYY-MM-DD).
companies[].installs[].product_first_verified_date	string	Date the install was first verified (YYYY-MM-DD).
companies[].installs[].intensity	number	Install intensity score.
companies[].installs[].location_count	number	Number of locations with the install.
companies[].installs_count	number	Number of installs in this response (≤ max_results).
companies[].total_installs_count	number	Total matching installs available upstream. Compare with installs_count to know if more pages exist.
companies[].has_more	boolean	True when the upstream has more matching installs than were returned in this page. Add filters (category_ids, product_ids, vendor_ids) to narrow the result set.

Related Tools

get_vendor_information, get_product_category, get_product_attribute, search_companies, company_install_time_series, company_fai, company_spend