Skip to main content

Company AI 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.

Estimated annual AI spend (USD) for companies, broken down by AI category and country, from HG Insights v2. Each row carries an estimated annual dollar amount (spend), the AI category (category_name / category_id — e.g. "Total AI Spend", "AI Software", "AI Services", "AI Hardware", with a category_description), and the country (country_name / country_code). Use this when a user asks how much a company spends on AI or GenAI overall, or within a specific AI-spend category. 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. Returns one entry per matched company under companies[] (unmatched companies are omitted). Filter to specific AI categories with category_ids or category_names. WARNING: category_names is a case-insensitive substring match (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 the spend-categories catalog (GET /data-api/v2/catalog/spend_categories). Paginate rows with max_results (1–25) and offset. Credits: 2 per requested company, charged regardless of match or row count. Do NOT use this for total/overall IT spend across all categories — use company_spend. Do NOT use this for cloud-vendor spend breakdowns (AWS/Azure/GCP) — use company_cloud_spend. Do NOT use this for AI adoption/maturity scores (this returns dollar spend, not scores) — use company_ai_maturity.

Parameters​

NameTypeRequiredDefaultDescription
hg_idsarray❌ No-HG Insights company IDs for batch AI-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 AI-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 AI-spend rows to these HG AI-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.ai_spend.categories.ids to the upstream.
category_namesarray❌ No-Filter AI-spend rows by AI-category name (string array, max 10 — the upstream cap), e.g. ["AI Software","AI Services"]. 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 the spend-categories catalog (GET /data-api/v2/catalog/spend_categories). Forwarded as filters.ai_spend.categories.names to the upstream.
max_resultsinteger❌ No-Maximum number of AI-spend rows to return (1–25 — the HG spend pagination cap). Forwarded as pagination.ai_spend.limit to the upstream.
offsetinteger❌ No-Zero-based row offset for pagination. Forwarded as pagination.ai_spend.offset to the upstream.

Required Integrations​

  • hginsights_v2__data_api

Use Cases​

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

Example Usage​

Cisco's AI spend rows by category and country

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

Compare Cisco and Salesforce AI spend in one batch

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

Top 3 AI-spend rows filtered to AI Software and AI Services

{
  "tool": "company_ai_spend",
  "arguments": {
    "domains": [
      "cisco.com"
    ],
    "category_names": [
      "AI Software",
      "AI Services"
    ],
    "max_results": 3
  }
}

company_spend, company_cloud_spend, company_ai_maturity, company_technographic, search_companies, get_product_category