Skip to main content

Company Spend

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.

Estimate a company's IT spend in USD, broken down by spend category and country, from HG Insights modeled spend data (v2). Values are HG modeled dollar estimates (not billed/actual invoices) — e.g. Cisco returns per-category rows like "Total IT" (~$6.2B US), "Total External IT", "Services", and "Software", each split by country. Use when a user asks how much a company spends on IT overall or within a specific category (Security, Software, Cloud, Services, Hardware), or the geographic distribution of that spend. Accepts a batch: pass hg_ids OR domains (up to 25 companies — the HG spend batch cap); the two selectors are mutually exclusive, and when both are supplied hg_ids wins. One entry per matched company under companies[]; unmatched companies are omitted. Each company returns spend.all (a thin snake_case passthrough of HG v2 rows: spend, category_name, category_id, country_name, country_code) plus spend.all_count. Filter by category_ids or category_names. WARNING: category_names does case-insensitive substring matching (max 10 names); a name that is not a substring of any catalog category returns 0 rows — prefer category_ids or resolve exact names via get_product_category. Paginate with max_results and offset. Credits: 3 per requested company (charged regardless of match or row count). Do NOT use for cloud-vendor-level spend or which cloud/CDN/hosting vendors a company uses — use company_cloud_spend. Do NOT use for AI/ML platform spend — use company_ai_spend. Do NOT use to list installed on-prem software/products a company runs — use company_technographic.

Parameters​

NameTypeRequiredDefaultDescription
hg_idsarray❌ No-HG Insights company IDs for batch spend 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); the two are mutually exclusive — if both are supplied, hg_ids takes precedence.
domainsarray❌ No-Company domains for batch spend 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; the two are mutually exclusive — if both are supplied, hg_ids takes precedence.
category_idsarray❌ No-Filter USD spend rows to these HG category IDs (string array of hex ids, e.g. from get_product_category). Exact-match and the reliable filter — prefer over category_names. Forwarded as filters.spend.categories.ids to the upstream.
category_namesarray❌ No-Filter USD spend rows by category name (string array, max 10 — the upstream cap), e.g. ["Security","Software"]. Case-insensitive substring match: a name that is not a substring of any catalog category returns 0 rows — prefer category_ids or resolve exact names via get_product_category. Forwarded as filters.spend.categories.names to the upstream.
max_resultsinteger❌ No-Maximum number of spend rows (category × country combinations) to return per company (1–25 — the HG spend pagination cap). Forwarded as pagination.spend.limit to the upstream.
offsetinteger❌ No-Zero-based row offset for pagination. Forwarded as pagination.spend.offset to the upstream.

Required Integrations​

  • hginsights_v2__data_api

Use Cases​

  • How much does a company spend on IT overall (annual USD estimate)? — call by domain, read the "Total IT" row in spend.all
  • What does a company spend within a category (Security, Software, Cloud, Services)? — filter with category_ids/category_names
  • Which spend categories are largest for a company? — read spend.all rows and compare their spend values
  • How is a company's IT spend distributed across countries? — read country_name/country_code on each row
  • Size a deal or compare two companies' IT budgets — pass both domains in one batch call, compare their Total IT rows

Example Usage​

Cisco's IT spend rows by category and country

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

Compare Cisco and Salesforce IT spend in one batch

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

Top 5 spend rows filtered to Security and Software

{
  "tool": "company_spend",
  "arguments": {
    "domains": [
      "cisco.com"
    ],
    "category_names": [
      "Security",
      "Software"
    ],
    "max_results": 5
  }
}

company_cloud_spend, company_ai_spend, company_technographic, company_firmographic, search_companies, get_product_category