Skip to main content

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

Map a company's cloud and internet-infrastructure vendor footprint (HG Insights v2). Use when a user asks WHICH cloud/CDN/hosting/DNS/SaaS vendors a company uses, grouped by service category, when each vendor was first detected, and the company's geographic web-traffic split (North America / EMEA / Asia Pacific / Latin America percentages). Identify the company by company_domain (required) — e.g., 'cisco.com'; hg_id is NOT supported by this v2 endpoint. Returns three parts: company (name/website/logo), traffic_distribution (regional web-traffic %, may be null), and technology_services (each a service_name with a vendors[] list of vendor_name, vendor_logo, and first_seen adoption date). IMPORTANT: despite the 'spend' name, the response contains NO dollar figures — it lists vendors and adoption dates, not billed amounts. Do NOT use for dollar-amount spend: for category-level $ spend use company_spend; for on-premise/general software installs (CRM, databases, security) use company_technographic. Use product_list to filter to specific vendor/product names (server-side fuzzy matching). Default response is capped at 10 vendors per service (vendors_per_service_limit, max 50) and 100 vendors total to keep responses under ~30 KB; raise limit (service categories, default 50, max 200) or set full=true to bypass all caps (may exceed 90 KB on large accounts). The fields param projects each vendor row to a subset of: vendor_name (always included), vendor_logo, first_seen. Requires the hginsights_v2 integration.

Parameters​

NameTypeRequiredDefaultDescription
company_domainstring✅ Yes-Registered/primary web domain of the company to look up cloud vendors for (e.g., 'cisco.com'). Required — this v2 endpoint is domain-only and does NOT accept hg_id. Protocol prefixes (http://, https://), a leading www., and any trailing path/query/fragment are accepted and stripped automatically; case is normalized to lowercase. Max 253 chars. Must resolve to a company in HG's cloud-vendor database or the call returns a 'Company not found' error.
product_listarray❌ No[]Optional vendor/product names to narrow the results to (e.g., ['Amazon EC2', 'OpenDNS']). Matched fuzzily server-side against detected vendor names, so approximate names still match; service categories with no matching vendor are dropped. Omit or pass [] to return every detected vendor.
limitinteger❌ No50Maximum number of technology_services (service-category) entries to return (default: 50, max: 200). Ignored when full=true.
vendors_per_service_limitinteger❌ No10Maximum number of vendors to include per technology_services (service-category) entry (default: 10, max: 50). Ignored when full=true. The total vendor count across all services is also capped at 100 to keep responses small.
fieldsarray❌ No-Project each vendor row to this subset of fields. vendor_name is always included regardless of this list. Ignored when full=true.
fullboolean❌ NofalseWhen true, return the full payload with no limit, no per-service vendor cap, no total-vendor budget, and no field projection. Default: false (all caps apply). Use full=true only when you genuinely need the unbounded payload — large accounts may exceed 90 KB.

Required Integrations​

  • hginsights_v2__data_api

Use Cases​

  • Which cloud, CDN, hosting, DNS, and SaaS vendors does a company use? — call by company_domain
  • Does a company use a specific cloud vendor (e.g., Amazon EC2 or OpenDNS)? — product_list fuzzy filter
  • When did a company first adopt a given cloud vendor? — read first_seen per vendor
  • How is a company's web traffic distributed across regions? — read traffic_distribution percentages
  • Compare the cloud/CDN vendor footprint of two companies — one call per domain

Example Usage​

Cisco's full cloud/internet-infrastructure vendor footprint by domain

{
  "tool": "company_cloud_spend",
  "arguments": {
    "company_domain": "cisco.com"
  }
}

Check whether Cisco uses Amazon EC2 or OpenDNS

{
  "tool": "company_cloud_spend",
  "arguments": {
    "company_domain": "cisco.com",
    "product_list": [
      "Amazon EC2",
      "OpenDNS"
    ]
  }
}

Compact call for a large account — vendor names only, tighter caps

{
  "tool": "company_cloud_spend",
  "arguments": {
    "company_domain": "microsoft.com",
    "fields": [
      "vendor_name"
    ],
    "vendors_per_service_limit": 5
  }
}

company_spend, company_technographic, company_install_time_series, get_vendor_information, search_companies