Product Search and Enrich

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.

Discover and hydrate products/technologies from the HG Insights product catalog (the technographic taxonomy of vendors, products, and categories). One tool, two actions. action='search' (free) returns a slim, paginated hit list of product_ids matching name/vendor/category/attribute filters — use it to disambiguate a fuzzy product name into a concrete product_id or to browse the products under a vendor/category. action='enrich' (1 credit per successful match) hydrates 1-50 known product_ids into full catalog records: product_details, category_info, vendor_info. Use when you need to look up a product in the catalog, resolve a product name to an id, browse a vendor's or category's products, or fetch full catalog metadata for specific product_ids. Typical flow: search to find the id, then enrich the chosen id(s). Unmatched enrich ids are silently omitted from the response and do not consume credits (there is no per-row error). When filtering by category, prefer resolving the exact category first via get_product_category and passing category_id — category_name does a substring match that can silently pick the wrong category (e.g. 'CRM' can match a BPO/outsourcing category, not the CRM software one). Same guidance applies to attributes via get_product_attribute (use attribute_ids over attribute_name) and vendors via get_vendor_information (use vendor_id over vendor_name). Do NOT use for pricing, competitor narrative, or user reviews — use get_product_information / get_product_reviews (TrustRadius). This tool returns HG catalog taxonomy (category/vendor/attributes/install signals) only.

Parameters

Name	Type	Required	Default	Description
action	string	✅ Yes	-	Required discriminator selecting the operation. 'search' = free, returns a paginated list of matching product_ids (use with filters/sort/limit/offset). 'enrich' = 1 credit per successful match, hydrates known product_ids into full catalog records (use with products[]).
filters	object	❌ No	-	search-only, all fields optional and AND-combined. Flat HG catalog filters: product_name, description, category_name, attribute_name, vendor_name (substring matches — imprecise), category_id (32-char uppercase hex, resolve via get_product_category), attribute_ids (resolve via get_product_attribute), vendor_id (resolve via get_vendor_information), has_install (true = only products with observed installs). Resolve category_id via get_product_category first and pass it here — category_name does a substring match that can silently pick the wrong category. Prefer id filters over the *_name substring filters. Unknown keys and legacy nested shapes are rejected.
filters.product_name	string	❌ No	-
filters.description	string	❌ No	-
filters.category_name	string	❌ No	-
filters.attribute_name	string	❌ No	-
filters.vendor_name	string	❌ No	-
filters.category_id	string	❌ No	-
filters.attribute_ids	array	❌ No	-
filters.vendor_id	integer	❌ No	-
filters.has_install	boolean	❌ No	-
sort	array	❌ No	-	search-only. Ordered list of up to 3 sort specs (first is primary). Each: field ∈ {relevance, product_name, vendor_name, category_name, last_verified_at}, order ∈ {asc, desc}. Omit for the server's default relevance ranking.
sort[].field	string	✅ Yes	-
sort[].order	string	✅ Yes	-
limit	integer	❌ No	-	search-only. Max results per page, 1-100. Server default: 50.
offset	integer	❌ No	-	search-only. Zero-based pagination offset (>=0) into the result set; page N = offset N*limit. Server default: 0.
products	array	❌ No	-	enrich-only, required for enrich. 1-50 product_ids to hydrate, each as {product_id}. Get ids from a prior action='search' call. Duplicates are deduped by upstream. Unmatched ids are silently omitted from the response and consume no credits (no per-row error is returned).
products[].product_id	integer	✅ Yes	-

Required Integrations

• hginsights_v2__data_api

Use Cases

• Resolve a fuzzy product name into a concrete product_id — action='search' with filters.product_name
• List every product a vendor ships in the catalog — action='search' with filters.vendor_id (resolved via get_vendor_information)
• Browse products within a category — action='search' with filters.category_id (resolved via get_product_category)
• Fetch full catalog metadata (product/category/vendor details) for known ids — action='enrich' with products[]
• Narrow a category to products that actually have installs — action='search' with filters.has_install:true

Example Usage

Search products by name (free, returns product_ids)

{
  "tool": "product_search_and_enrich",
  "arguments": {
    "action": "search",
    "filters": {
      "product_name": "Salesforce"
    },
    "limit": 10
  }
}

Search a resolved category, installs only, sorted by name

{
  "tool": "product_search_and_enrich",
  "arguments": {
    "action": "search",
    "filters": {
      "category_id": "1418B319B0BF64082F35286B055DDCC1",
      "has_install": true
    },
    "sort": [
      {
        "field": "product_name",
        "order": "asc"
      }
    ]
  }
}

Enrich two known product_ids with full catalog details

{
  "tool": "product_search_and_enrich",
  "arguments": {
    "action": "enrich",
    "products": [
      {
        "product_id": 43310
      },
      {
        "product_id": 43311
      }
    ]
  }
}

Related Tools

get_product_category, get_product_attribute, get_vendor_information, get_product_information, company_technographic