Skip to main content

Intent Topic Catalog (Resolver)

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.

RESOLVER: list valid intent topic names + hex IDs from the official HG Insights catalog (20,000+ topics). Returns each topic's hex ID, name, and category. Intent topics are buying signals / research areas that indicate what technologies companies are actively investigating or planning to purchase. This tool ONLY lists/searches the topic vocabulary — it returns no company or intent data.

Use this to resolve a topic name to its hex ID before filtering intent by topic: pass the returned id to company_intent's topic_ids parameter, or to search_companies' intent.topics.ids parameter. ALWAYS look up topic IDs with this tool rather than guessing or fabricating them — a bad ID silently matches nothing.

Do NOT use this to find which companies show intent on a topic — resolve the id here, then pass it to search_companies' intent.topics.ids filter (company_intent instead reports the topics of ONE already-known company).

Do NOT pass natural-language phrases to name: it is a case-insensitive substring match over catalog topic names, not a semantic/ranked search, so 'cloud security infrastructure management' returns nothing — pass a short keyword like 'security' or 'cloud' instead. Catalog names are lowercased. Omitting name lists the entire 20,000+ topic catalog reverse-alphabetically (not by relevance); page through it with limit/offset only when deliberately browsing.

Parameters​

NameTypeRequiredDefaultDescription
namestring❌ No-Filter intent topics by name (case-insensitive substring match), e.g. 'security' or 'cloud'. This is a literal substring filter over catalog topic names, not a ranked or semantic search: pass a single short keyword, NOT a natural-language phrase — a multi-word phrase that is not a literal substring of a topic name (e.g. 'cloud security infrastructure management') returns zero results. Catalog names are lowercased (e.g. 'vendor security assessment (vsa)'), so match on the keyword, not on casing. Omit only to browse the full 20,000+ topic catalog (reverse-alphabetical, page with limit/offset).
limitinteger❌ No-Maximum number of topics to return (>= 1). Omit for the upstream default page size. Use a small value (e.g. 5-25) when resolving a keyword to a topic ID; raise it only to browse the catalog.
offsetinteger❌ No-Number of topics to skip for pagination (>= 0). Omit to start from the first record. Advance by your limit to page through the reverse-alphabetical catalog when name is omitted.

Required Integrations​

  • hginsights_v2__data_api

Use Cases​

  • Resolve a keyword to a topic hex ID before an intent query — name='security', then pass a returned id to company_intent.topic_ids
  • Discover exact catalog spellings for a theme before filtering companies — name='cloud', then feed the id to search_companies' intent.topics.ids
  • Look up a vendor/product topic ID to recommend real intent topics instead of guessing — name='salesforce'
  • Widen a broad theme by running several single-keyword passes — name='storage', then name='infrastructure'
  • Browse the full catalog reverse-alphabetically when no keyword applies — omit name and page with limit/offset

Example Usage​

Resolve topics matching a keyword

{
  "tool": "list_intent_topics",
  "arguments": {
    "name": "security",
    "limit": 10
  }
}

Look up a vendor topic spelling and ID

{
  "tool": "list_intent_topics",
  "arguments": {
    "name": "salesforce"
  }
}

Browse the second page of the full catalog

{
  "tool": "list_intent_topics",
  "arguments": {
    "limit": 25,
    "offset": 25
  }
}

company_intent, search_companies, get_product_category