Skip to main content

Company AI Maturity

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.

Scores how advanced a batch of companies is at AI and data, their GenAI buying intent, and which cloud provider each centers on — call it when a user asks any of those about one or more named companies. Returns the raw HG Insights AI-maturity signals per company: ai_maturity_score (0-100 composite), ai_maturity_rank (1 = highest, lower is stronger), ai_maturity_6m_delta (6-month score change, may exceed single digits), ai_product_use (has an AI product installed), genai_intent_score (GenAI buying intent — UNBOUNDED, real values reach the tens of thousands, not a percentage), data_maturity_level (LOW/MEDIUM/HIGH) and data_maturity_score (0-100), plus cloud_centricity (dominant provider) and cloud_intensity (per-provider aws/azure/gcp rolled-up detection volume — UNBOUNDED, values in the thousands are normal, NOT 0-100 scores or dollar amounts; compare providers within a company, never across companies). These are the raw scores as HG returns them — no derived stage labels. Accepts a batch: pass hg_ids and/or domains (up to 25 companies) and receive one entry per matched company under companies[]. IMPORTANT — a company that is not found or has no AI-maturity coverage is omitted from companies[] and echoed in not_found[]. Do NOT use this for AI spend in dollars (use company_ai_spend), for derived AI-adoption stage labels or a broader operating-signals rollup (use company_operating_signals), for full AI/ML tech-stack detail (use company_technographic), or for topic-level buying-intent evidence (use company_intent).

Parameters​

NameTypeRequiredDefaultDescription
hg_idsarray❌ No-HG Insights company identifiers for a batch AI-maturity lookup (up to 25). Each is 31-32 letters/digits only (hex-like) — not a domain, DUNS, or ticker — obtained from the id field of a prior search_companies result or another HG tool. Provide hg_ids and/or domains (at least one is required); both may be combined and are unioned upstream.
domainsarray❌ No-Company registered web domains for a batch AI-maturity lookup (e.g. ['cisco.com', 'salesforce.com'], up to 25) — domains, not company names or tickers. Protocol prefixes (http://, https://), a leading www., and trailing paths/queries are stripped automatically and case is lowercased, so 'https://www.Cisco.com/products' resolves to 'cisco.com'. If you only have a company name, resolve it to a domain with search_companies first. Provide hg_ids and/or domains (at least one is required); both may be combined and are unioned upstream.

Required Integrations​

  • hginsights_v2__data_api

Use Cases​

  • Gauge how AI-advanced a batch of prospects is before outreach by reading each ai_maturity_score and ai_maturity_rank.
  • Compare GenAI buying intent (genai_intent_score) across a set of accounts to prioritize which to contact first.
  • Identify which cloud provider each company centers on (cloud_centricity) and compare aws/azure/gcp footprint within that company.
  • Assess data maturity (data_maturity_level and data_maturity_score) as an AI-readiness proxy across a target list.
  • Track whether companies already have an AI product installed (ai_product_use) and how their maturity shifted over the last 6 months (ai_maturity_6m_delta).

Example Usage​

Look up AI maturity by domain

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

Batch lookup across several domains

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

Look up AI maturity by HG company ID

{
  "tool": "company_ai_maturity",
  "arguments": {
    "hg_ids": [
      "25582D0E650950949A473EA7345C193E"
    ]
  }
}

company_ai_spend, company_operating_signals, company_technographic, company_intent, search_companies