Skip to main content

Company Operating Signals

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.

Retrieve a single company's operating profile as categorical STAGE LABELS, rolling up HG mentions and AI-maturity data into two groups. The mentions group derives work_model, cloud_posture, esg_commitment, iot_posture, network_modernization, and automation_stage; the genai_maturity group derives ai_trajectory, cloud_depth, genai_readiness, and intent_adoption_gap. Each attribute carries a stage label (e.g. cloud_posture="private-first", ai_trajectory="ai-leader-growing"), a per-signal breakdown, and an intensity number — note the two intensity scales differ: mentions intensity is an UNBOUNDED sum of detection volume (routinely in the thousands, comparable within a company only), while genai_maturity intensity is a BOUNDED 0-100 score. Call this when a user asks about one company's work model, cloud/IoT/network modernization posture, automation stage, or GenAI readiness/trajectory as summary labels (e.g. "remote-heavy", "cloud-native", "ai-leader-accelerating"). Do NOT use this to search or rank many companies — use search_companies. Do NOT use this for raw AI-maturity scores/ranks or per-provider cloud intensity numbers — use company_ai_maturity instead. Do NOT use this for a company's installed technology stack/products — use company_technographic instead; for raw buying-intent topic scores, use company_intent. Provide a company_domain (e.g., "cisco.com") or an HG Insights company ID (hg_id). Missing coverage is signaled per-section via data_available:false + no_data_reason, and per-attribute via stage:"no-signal" — these are normal, not errors.

Parameters​

NameTypeRequiredDefaultDescription
company_domainstring❌ No-Company website domain to profile (e.g., "cisco.com"). Either company_domain or hg_id is required; hg_id wins if both are supplied. Protocol prefixes (http://, https://), a leading "www.", and any trailing path/query/fragment are stripped automatically and case is normalized, so a full URL like "https://www.cisco.com/products" also works.
hg_idstring❌ No-HG Insights company identifier (31-32 alphanumeric characters), as returned in the organization_id field of this and other HG tools. Use for an exact, domain-independent lookup once the company is already resolved. Overrides company_domain when both are supplied.

Required Integrations​

  • hginsights_v2__data_api

Use Cases​

  • Get a one-shot operating profile of a single company across cloud, AI, IoT, ESG, network, and work model as ten categorical STAGE LABELS
  • Read a company's AI trajectory and GenAI readiness before a sales call — is it accelerating, plateauing, or dormant?
  • Check a company's cloud posture (public-first, private-first, multi-cloud, hybrid, edge-only) alongside its combined-provider cloud depth
  • Spot an intent-adoption gap — high GenAI intent but no product use ('intent-no-action') to flag warm-but-unconverted accounts
  • Gauge automation and network modernization maturity (e.g. automation_stage='autonomous', network_modernization='next-gen') for technical qualification

Example Usage​

Operating signals by domain

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

Full URL is normalized to a domain

{
  "tool": "company_operating_signals",
  "arguments": {
    "company_domain": "https://www.salesforce.com/products"
  }
}

Exact lookup by HG company ID

{
  "tool": "company_operating_signals",
  "arguments": {
    "hg_id": "25582D0E650950949A473EA7345C193E"
  }
}

search_companies, company_ai_maturity, company_technographic, company_intent