Skip to main content

Company Firmographic

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.

Batch firmographic lookup for one or more known companies. Call this when the user asks about a company's firmographics — name, location, industry, employee/revenue size, corporate hierarchy, or global HQ — or wants the same facts for a short list of companies. Use this (not company_enrich) for firmographic-only questions: it is faster and returns a smaller payload than a full profile. Each entry returns the HG record with name, industry_name, employees_total/band, revenue_total/band, city/state/country, NAICS/SIC codes, Fortune 500 / Forbes 2000 rank, it_spend, company_level, and the corporate-parent / global_hq_* hierarchy. company_id is that entry's HG company id (hex); for a subsidiary or intermediate parent, chain on global_hq_id to reach the ultimate parent (equal to company_id for a Group HQ, where the duplicate global_hq_* fields are dropped). Selection is batch-only: pass hg_ids OR domains (mutually exclusive — not both; up to 25 each). The response is always { companies: [...] }, one entry per matched company, with no found/message flag. No-match sentinel: unmatched companies are omitted, so a fully unmatched request returns an empty array ({ companies: [] }) — check that each requested id/domain has a corresponding entry. When the org has a Snowflake integration configured, its own account record for each company is attached as customer_data. Do NOT use this when: the firmographic data is already in context (e.g. from a prior company_enrich call); you need the full multi-level ownership tree (subsidiaries, siblings, depth traversal) — use company_hierarchy; you need a full multi-signal profile (technographic + intent + spend) — use company_enrich; or you are discovering companies you lack ids or domains for — use search_companies.

Parameters​

NameTypeRequiredDefaultDescription
hg_idsarray❌ No-HG Insights company IDs to look up, as a batch array (up to 25). Each id is 31-32 alphanumeric/hex chars, obtained from a prior search_companies or company_enrich result. Each returns one entry under companies[], in request order; ids that upstream cannot match are omitted. Provide EITHER hg_ids OR domains — exactly one selector is required, they are mutually exclusive, and passing both is rejected.
domainsarray❌ No-Company domains to look up, as a batch array (e.g. ['cisco.com', 'salesforce.com'], up to 25). Protocol prefixes (http://, https://), a leading www., and trailing paths/queries are stripped automatically, and case is normalized. Each domain resolves to the matching HG entity (e.g. linkedin.com → LinkedIn Corporation, company_level "Corporate Parent", with Microsoft surfaced under global_hq_*) and returns one entry under companies[]; domains that upstream cannot match are omitted. Provide EITHER hg_ids OR domains — exactly one selector is required, they are mutually exclusive, and passing both is rejected.

Required Integrations​

  • hginsights_v2__data_api

Use Cases​

  • What industry and employee count does a company report? — single-domain lookup
  • What is a company's estimated IT spend and revenue? — it_spend + revenue_total fields
  • Get firmographics for a short list of companies in one call — pass domains: [...] (up to 25)
  • Is company X a subsidiary or intermediate parent? — company_level + global_hq_* answer hierarchy without company_hierarchy
  • I have hg_ids from search_companies — get the firmographic record for each

Example Usage​

Lookup by domain

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

Batch lookup by domain (URLs are normalized)

{
  "tool": "company_firmographic",
  "arguments": {
    "domains": [
      "cisco.com",
      "https://www.linkedin.com/about"
    ]
  }
}

Lookup by hg_id

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

company_enrich, company_hierarchy, company_technographic, company_intent, search_companies