Company Intent

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.

Get buying-intent signals for ONE SPECIFIC, ALREADY-KNOWN company, identified by company_domain or hg_id. Returns merged HG proprietary + TrustRadius buyer intent in three optional field groups: summary (active/high-signal topic counts, per-source counts, top context types), topics (per-topic detail — score, signal level, buyer-journey stage, context types/dispositions for competitive intel, vendors, products), and activities (TrustRadius buyer activities with evidence URLs). Each present group carries its own total count alongside a page of data.

Use this when you already have a target company and want to know what it is researching, which buyer-journey stage it is in, or whether it shows competitive/displacement signals (context_type_names + vendor_ids).

Do NOT use this to find WHICH companies show intent on a topic — this tool needs a single known company. Use search_companies with its intent filter block for topic-to-company discovery. Do NOT guess topic_ids — resolve a topic name to its hex ID with list_intent_topics first, then pass it here.

Scores are bounded 0–100 (100 = strongest signal); signal_level buckets those into HIGH/MEDIUM/LOW. DEFAULT: omitting fields returns the summary overview only (up to 50 rows) — topics and activities require an explicit opt-in because large enterprises can have 500k+ topic rows. Pass fields:["topics"] (optionally with "activities") plus a small limit when you need detail. Topics are geo-expanded by default (one row per state); pass granularity:"global" to collapse to one row per topic. Filters: signal_level (HIGH/MEDIUM/LOW), buyers_journey_names (Researching/Evaluating), context_type_names (e.g. "Displacement"), topic_ids, product_category_ids, vendor_ids/product_ids, a signal_date window, and limit/offset per section.

Parameters

Name	Type	Required	Default	Description
company_domain	string	❌ No	-	Company domain to look up intent signals for (e.g., "cisco.com", "salesforce.com"). Either company_domain or hg_id is required. Protocol prefixes (http://, https://), leading www., and trailing paths/queries/fragments are accepted and stripped automatically; case is normalized.
hg_id	string	❌ No	-	HG Insights company ID (32-character hex). When provided, this overrides company_domain (hg_id wins outright — no fallback to the domain). Obtain from a previous search_companies / company_enrich result; do not fabricate it.
fields	array	❌ No	-	Which field groups to include: any subset of "summary", "topics", "activities". DEFAULT when omitted: "summary" only (an overview) — pass ["topics"] and/or ["activities"] explicitly to include those groups. Unrequested groups are omitted from the response (never null).
signal_date	object	❌ No	-	Inclusive signal-date range filter { from, to } (YYYY-MM-DD). Omit for the upstream default window.
signal_date.from	string	❌ No	-	Inclusive lower bound for signal date (YYYY-MM-DD).
signal_date.to	string	❌ No	-	Inclusive upper bound for signal date (YYYY-MM-DD).
signal_level	array	❌ No	-	Filter topics by signal level (HG topics only). Any subset of HIGH, MEDIUM, LOW.
buyers_journey_names	array	❌ No	-	Filter topics by buyer-journey stage (HG topics only). Allowed values: "Researching", "Evaluating" (the only stages the upstream accepts).
context_type_names	array	❌ No	-	Filter topics by context type for competitive intelligence (HG topics only), e.g. ["Displacement", "Whitespace", "Expansion", "Complementary"]. Pair with vendor_ids for displacement analysis against a specific competitor.
topic_ids	array	❌ No	-	Filter to specific hex-encoded topic IDs (32-char Int128; hex chars 0-9/a-f only). Obtain from list_intent_topics — do not fabricate IDs. Malformed IDs are rejected client-side before the upstream call.
granularity	string	❌ No	-	Geographic granularity for topic results. DEFAULT when omitted is "state" (geo-expanded: one topic row per state) — pass "global" to collapse to one row per topic. "country"/"region" break results down to those levels, populating country_name/region_name/state_name on each returned topic.
product_category_ids	array	❌ No	-	Filter TrustRadius activities (the "activities" field group) to specific product category IDs (hex-encoded). Obtain them from get_product_category.
vendor_ids	array	❌ No	-	Filter results to specific vendor IDs (integers). Applies across both topics and activities; pair with context_type_names:["Displacement"] to scope competitive/displacement signals to a named competitor.
product_ids	array	❌ No	-	Filter results to specific product IDs (integers). Applies across both topics and activities.
limit	integer	❌ No	-	Max records per section (1-200). Defaults to the upstream page size (50).
offset	integer	❌ No	-	Records to skip per section for pagination (default 0).

Required Integrations

• hginsights_v2__data_api

Use Cases

• Get a quick intent overview for a known company — omit fields for the summary (active/high-signal topic counts, sources, top context types).
• See the top topics a company is researching, ranked by score — fields:["topics"] with a small limit.
• Surface competitive/displacement signals for a company — fields:["topics"] + context_type_names:["Displacement"] (optionally vendor_ids).
• Filter a company's topics to a buyer-journey stage or signal strength — buyers_journey_names / signal_level.
• Pull a company's recent TrustRadius buyer activities with evidence URLs — fields:["activities"] + a signal_date window.

Example Usage

Intent summary overview for a company

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

Top HIGH-signal topics, one row per topic

{
  "tool": "company_intent",
  "arguments": {
    "company_domain": "salesforce.com",
    "fields": [
      "topics"
    ],
    "signal_level": [
      "HIGH"
    ],
    "granularity": "global",
    "limit": 20
  }
}

TrustRadius buyer activities in a date window

{
  "tool": "company_intent",
  "arguments": {
    "company_domain": "cisco.com",
    "fields": [
      "activities"
    ],
    "signal_date": {
      "from": "2026-01-01",
      "to": "2026-06-30"
    }
  }
}

Related Tools

list_intent_topics, search_companies, company_technographic, company_fai