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.

Credits

3 — 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 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.
domains	array	-	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_ids	array	-	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_names	array	-	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_results	integer	-	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.
offset	integer	-	Zero-based row offset for pagination. Forwarded as pagination.spend.offset to the upstream.

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

• 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
  }
}

Response Format

Field	Type	Description
companies	array
companies[].company_id	string	HG Insights company id (hex). Empty string when not found.
companies[].company_domain	string	The resolved company domain.
companies[].spend	object	Spend section from the HG v2 API — thin upstream passthrough. Rows are snake_case (e.g. category_name, country_name, spend).
companies[].spend.all	array	Array of spend rows (snake_case v2 passthrough).
companies[].spend.all_count	number	Total number of spend rows in this response.
companies[].credits_consumed	number	Credits consumed for this company: a fixed 3 charged per requested company, regardless of whether the company matched or returned any spend rows.

Related Tools

company_cloud_spend, company_ai_spend, company_technographic, company_firmographic, search_companies, get_product_category