Get Vendor Information

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.

Resolve a vendor/company name into its HG Insights vendor_id (and metadata) so you can filter other tools by that vendor. Free — no credits consumed. Match by vendor_name substring (case-insensitive, relevance-ranked) and/or description substring, or look up an exact vendor_id. Returns ranked vendor rows: vendor_id (UInt64), vendor_name, vendor_url, vendor_parent_id (0 or null if top-level), vendor_company_description, and product_count. Set include_products: true to attach up to products_limit products per vendor. Matching is substring, not fuzzy: a single query can return several rows — a parent and its subsidiaries (e.g. 'Oracle' → 'Oracle Corporation' and 'Oracle NetSuite') — so confirm vendor_name/vendor_url before reusing an id. Use this when you must resolve a vendor by name before filtering technographic/spend data — e.g. pass the returned vendor_id into company_technographic's vendor filter, or into company_spend. Do NOT use this when you already hold a vendor_id — pass it straight to the downstream tool. Do NOT use this for the product category taxonomy (use get_product_category), for product attributes (use get_product_attribute), or for a product's reviews/pricing/details (use get_product_information). Do NOT call it with no filter — always supply vendor_name, description, or vendor_id.

Parameters

Name	Type	Required	Default	Description
vendor_name	string	❌ No	-	Case-insensitive substring match on vendor_name (LIKE), which activates relevance ranking. Pass the plain company name, e.g. 'Salesforce', 'Oracle'. Because it is substring (not fuzzy), a single name can return multiple rows — a parent plus its subsidiaries (e.g. 'Oracle' → 'Oracle Corporation' and 'Oracle NetSuite') — so inspect vendor_name/vendor_url and pick the intended row before reusing its vendor_id.
description	string	❌ No	-	Case-insensitive substring match on vendor_company_description (the vendor's company blurb) — useful to find vendors by what they do, e.g. 'endpoint security'. ANDed with vendor_name when both are provided: the stored description must contain the exact substring AND the name must match. If results are empty when using both filters, retry with only vendor_name; the stored description text may not contain your exact phrase.
vendor_id	integer	❌ No	-	Exact vendor_id (UInt64) match — returns ≤ 1 row. Use when you already hold the ID (e.g. from an earlier search) and want to resolve the vendor's full metadata; do not use vendor_id to re-search by name.
has_products_with_installs	boolean	❌ No	-	true = only vendors with ≥1 product carrying an install signal; false = catalog-only vendors. Omit to return all. Note: product ownership joins may occasionally surface unrelated vendors — verify vendor_name and vendor_url before using the returned vendor_id.
include_products	boolean	❌ No	false	When true, each vendor row carries a products[] of {product_id, product_name} ordered by presence frequency, capped at products_limit.
products_limit	integer	❌ No	10	Cap on the products[] list per vendor when include_products is true (1–100).
sort_by	string	❌ No	relevance	Sort order for the returned rows: 'relevance' (best name match first — only meaningful alongside vendor_name), 'vendor_name' (A→Z), or 'product_count' (most products first). On this channel an unrecognised value is rejected with an upstream 422 (it is no longer silently discarded).
limit	integer	❌ No	10	Maximum number of vendor rows to return (1–100).
offset	integer	❌ No	0	Pagination offset.

Required Integrations

• hginsights_v2__data_api

Use Cases

• Resolve a vendor's vendor_id by name before filtering company_technographic or company_spend
• Disambiguate a company that resolves to multiple rows (parent vs. subsidiary, e.g. Oracle Corporation vs. Oracle NetSuite)
• Find vendors by what they do via a description substring (e.g. 'endpoint security')
• Resolve full vendor metadata from a known vendor_id
• List a vendor's products with include_products: true

Example Usage

Resolve Salesforce's vendor_id

{
  "tool": "get_vendor_information",
  "arguments": {
    "vendor_name": "Salesforce"
  }
}

Vendor plus its top 5 products

{
  "tool": "get_vendor_information",
  "arguments": {
    "vendor_name": "Oracle",
    "include_products": true,
    "products_limit": 5
  }
}

Exact lookup by known id

{
  "tool": "get_vendor_information",
  "arguments": {
    "vendor_id": 376
  }
}

Related Tools

company_technographic, company_spend, get_product_category, get_product_information, get_product_attribute