`company_enrich` next channel

Status: Renamed from company_research on next This tool is on the private next MCP channel for allow-listed orgs. When promoted, this file moves to mcp-tools/company-enrich.md.

Enrich a batch of up to 25 companies with multiple data sections in a single call, returned as { companies: [...] }. Select companies with hg_ids and/or domains (at least one required; both may be combined and are unioned). The former company_research tool key is gone on next — migrate to company_enrich.

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 enrichment (up to 25). Provide `hg_ids` or `domains` (at least one is required); both may be combined and are unioned.
`domains`	`string[]`	Optional	—	Company domains for batch enrichment (e.g. `['cisco.com', 'salesforce.com']`, up to 25). Protocol prefixes, leading `www.`, and trailing paths are stripped automatically.
`fields`	`string[]`	Optional	—	Which data sections to return. One or more of: `firmographics`, `spend`, `technographics`, `contracts`, `ai_maturity`, `cloud_maturity`, `statistics`, `market_benchmarks`. Defaults to `['firmographics', 'technographics', 'spend']` when omitted. `contracts` / `statistics` / `market_benchmarks` are entitlement-gated and are omitted (listed in `unavailableSections`) if your org lacks access.
`filters`	`object`	Optional	—	Optional upstream filters forwarded verbatim. `spend.categories.{ids,names}` and `technographics.{country,installs,product_attributes,product_categories,product_last_verified_date,products,vendors}` — see the `/v2/companies/enrich` contract. Filters only apply to the matching section.
`pagination`	`object`	Optional	—	Optional independent pagination for the nested `spend` and `technographics` arrays: `{ spend?: {limit, offset}, technographics?: {limit, offset} }`. `limit` is 0–100.
`contracts`	`object`	Optional	—	Optional contracts request block `{ filters?: {active_only, vendor_names (max 10)}, limit?, offset? }`. Requires `'contracts'` in `fields` AND the contracts entitlement — providing this block alone does not return contracts.
`full`	`boolean`	Optional	`false`	When `true`, bypass the per-section row caps. Default: `false`.

Credits

Dynamic — the sum of the per-section costs for the sections requested:

firmographics: 0.1 credits
technographics: 2 credits
spend: 3 credits
contracts: 1 credit
ai_maturity / cloud_maturity / statistics / market_benchmarks: 2 credits each

Credit cost scales with the number of companies returned.

Response Format

{
  "companies": [
    {
      "company_id": "3AB6196C…",
      "company_domain": "cisco.com",
      "found": true,
      "header": {
        "company_name": "Cisco Systems",
        "domain": "cisco.com",
        "industry": "Technology",
        "employee_count": 80000,
        "revenue": 52000000000,
        "location": { "city": "San Jose", "country": "United States" },
        "founded_year": 1984,
        "company_type": "Public"
      },
      "key_metrics": {
        "it_spend": 5000000000,
        "fortune_500_rank": 60,
        "forbes_2000_rank": 125,
        "top_tech_categories": ["Networking", "Security", "Cloud"]
      },
      "fields": ["firmographics", "technographics", "spend"],
      "unavailableSections": [],
      "firmographics": { "…": "…" },
      "spend": { "all": [], "all_count": 0 },
      "technographics": { "installs": [], "installs_count": 0 }
    }
  ]
}

Response notes

Companies with no match are omitted from the array — do not assume positional alignment with your input. When nothing matches, companies is [].
The interactive dashboard renders the first returned company; batches of more than one show a "Batch mode: N companies enriched — showing the first" banner (full data is in the structured response).
unavailableSections lists requested sections dropped because the org is not entitled to them.

Example Usage

{
  "tool": "company_enrich",
  "parameters": {
    "domains": ["cisco.com"],
    "fields": ["firmographics", "technographics", "ai_maturity"]
  }
}

company_firmographic — firmographics only; faster and smaller payload.
company_technographic — technographics only with richer filters.
company_spend — IT spend only with category and name filters.
company_ai_maturity — AI maturity only with batch selectors.

Changelog

2026-08-04 — Unified API PR #326 alignment (batch)

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

Why this changed: aligns company_enrich with the additive batch capability shipped in unified API PR #326.

Breaking change — company selection is now batch-only

The singular hg_id / company_domain selectors are removed. Select companies with batch arrays: hg_ids (array, ≤25) and/or domains (array, ≤25). At least one is required.
The output is now a { companies: [...] } array. When nothing matches, companies is [].
Migration: hg_id: "abc" → hg_ids: ["abc"], company_domain: "cisco.com" → domains: ["cisco.com"], then read response.companies[].

The Redis cache schema version was bumped by super.getCacheSchemaVersion() + 3 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.

	Before (on `next`)	After
Domain param	`companyDomain`	`company_domain`
ID param	`hgId`	`hg_id`
Sections `fields` enum values	`"aiMaturity"`, `"cloudMaturity"`, `"marketBenchmarks"`	`"ai_maturity"`, `"cloud_maturity"`, `"market_benchmarks"`

Output envelope: companyId → company_id, companyDomain → company_domain, header.companyName → header.company_name, keyMetrics → key_metrics, aiMaturity → ai_maturity, cloudMaturity → cloud_maturity, marketBenchmarks → market_benchmarks.

2026-07-30 — Breaking: `company_research` renamed to `company_enrich`

Why this changed: company_enrich is a single-call company-enrichment tool backed by the unified POST /data-api/v2/companies/enrich endpoint. It replaces the former company_research composite 7-sub-tool fan-out.

Breaking change: `company_research` is renamed to `company_enrich`

The former company_research tool key is gone on next. Migrate to company_enrich.

Before (`company_research`)	After (`company_enrich`)
`include*` booleans (`includeFirmographic`, `includeTechnographic`, etc.)	`fields: string[]` — choose from `firmographics`, `spend`, `technographics`, `contracts`, `ai_maturity`, `cloud_maturity`, `statistics`, `market_benchmarks`
`intent`, `cloudSpend`, `operatingSignals` sections	Removed — use `company_intent`, `company_cloud_spend`, `company_operating_signals` directly
`aiMaturity`, `cloudMaturity`, `statistics`, `marketBenchmarks`	Added

Migration: replace company_research(companyDomain=…) with company_enrich(domains: […]). Replace the include*: false toggles with an explicit fields list. Omitting fields returns firmographics + technographics + spend.

Parameters​

Credits​

Response Format​

Response notes​

Example Usage​

Related Tools​

Changelog​

2026-08-04 — Unified API PR #326 alignment (batch)​

Breaking change — company selection is now batch-only​

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

2026-07-30 — Breaking: company_research renamed to company_enrich​

Breaking change: company_research is renamed to company_enrich​