company_ai_maturity next channel

Status: Modified (batch selectors; snake_case params) This tool is on the private next MCP channel for allow-listed orgs. When promoted, this file moves to mcp-tools/company-ai-maturity.md.

Get a company's raw AI and data maturity signals — or a batch of up to 25 companies at once. Returns the raw HG Insights AI-maturity signals: ai_maturity_score (0–100 composite), ai_maturity_rank (1 = highest), ai_maturity_6m_delta (6-month change), ai_product_use (has an AI product installed), genai_intent_score (GenAI buying intent), data_maturity_level (LOW/MEDIUM/HIGH), data_maturity_score, cloud_centricity (dominant provider), and cloud_intensity (per-provider aws/azure/gcp scores).

Integration required: hginsights_v2__data_api Cache schema version: 4 (differs from base — stale cached payloads from the public channel will not be served)

Parameters

Parameter	Type	Required	Default	Description
hg_ids	string[]	Optional	—	HG Insights company IDs for batch AI-maturity 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); both may be combined.
domains	string[]	Optional	—	Company domains for batch AI-maturity 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; both may be combined.

Supplying neither parameter is an error. At least one of hg_ids or domains is required.

Response Format

{
  "companies": [
    {
      "company_id": "3AB6196C456CE3313A04A57BA6FA7BE3",
      "company_domain": "salesforce.com",
      "ai_maturity": {
        "ai_maturity_score": 68.67,
        "ai_maturity_rank": 26,
        "ai_maturity_6m_delta": 8.05,
        "ai_product_use": true,
        "genai_intent_score": 52534,
        "data_maturity_level": "MEDIUM",
        "data_maturity_score": 62.72,
        "cloud_centricity": "aws",
        "cloud_intensity": { "aws": 4711, "azure": 3108, "gcp": 2705 }
      }
    }
  ]
}

Response fields

Field	Meaning
companies	Array — one entry per matched company. Companies with no match or no coverage are omitted; do not assume positional alignment with your input.
company_id	HG Insights company identifier (hex). Empty string when the company is not found.
company_domain	The company domain that was queried.
ai_maturity	The AI-maturity signals for the company, or null when unavailable.
ai_maturity_score	Composite AI maturity score (0–100).
ai_maturity_rank	Rank by score (1 = highest — lower is stronger).
ai_maturity_6m_delta	6-month score change. Positive means rising; can exceed single-digit range.
ai_product_use	Whether the company has at least one AI product installed.
genai_intent_score	GenAI buying-intent signal. Unbounded — real values run into the tens of thousands; treat it as a relative measure, not a percentage.
data_maturity_level	LOW, MEDIUM, or HIGH (null when unknown).
data_maturity_score	Data maturity on a 0–100 scale.
cloud_centricity	The provider this company leans on most (null when unknown).
cloud_intensity	Per-provider detection volume — not a percentage. Unbounded rolled-up detection count. Use for within-company comparison only.

Example Usage

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

Single-company lookup (wrap in array):

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

Related Tools

• company_operating_signals — the same underlying signals rolled into derived stage labels.
• company_install_time_series — monthly usage trends; use it to check whether a high cloud_intensity is current or historical.
• company_technographic — point-in-time snapshot of the company's technology stack.

Changelog

2026-08-04 — Unified API PR #326 alignment

Availability: live on the private next MCP channel for allow-listed orgs. The public /api/mcp contract is unchanged.

Why this changed: aligns company_ai_maturity with the additive batch capability shipped in unified API PR #326, so a single call can score up to 25 companies at once.

Breaking change — company selection is now batch-only

• The singular hg_id / company_domain selectors are removed. Select companies with batch arrays instead: hg_ids (array, ≤25) and/or domains (array, ≤25). At least one is required.
• The output is now a { companies: [...] } array with one entry per matched company. Companies with no match or no AI-maturity coverage are omitted from the array — do not assume positional alignment with your input.
• Migration: wrap your old single identifier in the array form (hg_id: "abc" → hg_ids: ["abc"], company_domain: "cisco.com" → domains: ["cisco.com"]) and read response.companies[].

The Redis cache schema version was bumped 3 → 4 so pre-#326 cached payloads are not served.

2026-07-31 — Breaking: params and envelope fields renamed to snake_case

Availability: live on the private next MCP channel for allow-listed orgs. The public /api/mcp contract is unchanged.

All 12 next-channel tools now use a consistent snake_case vocabulary for MCP-layer parameters and envelope fields.

Breaking change — parameter and envelope field names

	Before (on next)	After
Domain param	companyDomain	company_domain
ID param	hgId	hg_id

Output before: { "companyId": "abc123", "companyDomain": "cisco.com", "aiMaturity": { … } }

Output after: { "company_id": "abc123", "company_domain": "cisco.com", "ai_maturity": { … } }

The ai_maturity block is still passed through verbatim from the upstream (fields: ai_maturity_score, ai_maturity_rank, ai_maturity_6m_delta, ai_product_use, genai_intent_score, data_maturity_level, data_maturity_score, cloud_centricity, cloud_intensity). Credit cost, integration key, and tool semantics are unchanged.

2026-07-30 — Breaking: hg_id renamed to hgId

The company identifier was renamed to hgId, matching the camelCase cross-tool standard. This was subsequently renamed again to hg_id (snake_case) in the 2026-07-31 pass.