Overview & Discovery
get_overview
Get a high-level summary of your product intelligence landscape. Use this as a starting point.
Returns: total insights, deal blockers, churn risks, top categories.
get_facets
Get aggregated counts by dimension. Use to understand distributions before drilling in.
Returns: top 20 values with counts per dimension.
source_type separates calls, support, and email.
get_trends
Get time-bucketed counts for trend analysis.
Returns: time-bucketed counts with unique customers and average frustration per period.
Customer Intelligence
search_customers
Find customers by name, industry, country, or engagement metrics. Every result includes revenue context.
Returns: company profiles with CRM data, deal values, and intelligence stats. Customers with equal sort values come in customer ID order, so pages never repeat or skip a customer. Customers with nothing to sort by come last, in customer ID order, after negative values too: no product insights for
insight_count and recency, no current ARR and no product insights for arr, no won deal value for deal_value, no frustration score for frustration, and no churn state, stated churn or product insights for churn.
get_customer
Get full profile for a specific customer.
Returns: CRM data, deals, contacts, intelligence summary, strategic context, and the account family the customer is counted under, with each of its accounts’ CRM record id.
Product Intelligence
search_insights
Find product intelligence by keyword or meaning. Returns 300-character content previews and a customers_mentioned summary.
Returns: matching insights with content previews, plus a
customers_mentioned summary of the customers behind the insights on that page. With a query, the matches form one ranked list of at most 300 insights: offset and sort page through it and total_matches is its size. semantic_matching_available: false means only keyword matches came back, so a topic with no match may still have been raised in other words; pages only follow on from each other while that value stays the same.
get_insight
Get full detail for a specific insight.
Returns: full verbatim content, pain point, workaround, use case, business outcomes, kano category, and reporter details. The response includes a
conversation pointer (id and source) to the call, ticket, or other source the insight came from, or null when no openable source is stored; pass both to get_conversation to read the full source. For an email insight, the response also includes every exact supporting span in evidence, ordered as used by the insight. Each span identifies its message and source part so it can be checked against the full thread.
Conversation Evidence
list_conversations
List calls, support tickets, and email threads for a customer. Prefercustomer_id; name lookup is a fallback.
Returns: conversation metadata without transcript content. Each email thread appears once, with the matched account, participants, ordered delivery IDs, message count, and source-completeness warnings.
get_conversation
Get the source content for one conversation returned bylist_conversations or by the conversation pointer of get_insight or get_signal.
Google Meet, Noota, Typeform, Slack, Canny, UserVoice and submitted-feedback conversations can be opened only when they are the source of at least one insight or context record.
For email, returns the complete parsed thread in chronological order as structured messages with sender, recipients, subject, body, and extracted attachments. It also returns a compatible
transcript, the matched account, participants, ordered delivery IDs, and source_complete.
This is the complete parsed source, not raw MIME or attachment bytes. Check source_complete and warning_codes: false means parsing, extraction, or response limits omitted some source content, and the warnings explain why.
Sales Intelligence
search_signals
Search strategic intelligence: satisfaction, churn, competitor mentions, buying behavior.
Returns: strategic context records with content previews, churn urgency, satisfaction level, competitor names. With a
query, the matches form one ranked list of at most 300 records that offset and sort page through, total_matches is its size, and semantic_matching_available: false means only keyword matches came back.
get_competitors
List your configured competitors with mention counts from customer conversations. Use this to see which competitors come up most, then drill in withsearch_signals(competitor_name="...").
No parameters required.
Returns: competitor list with names, products, mention counts, and whether they’re a direct competitor.
get_signal
Get full detail for a specific context record.
Returns: full content, context, source URL, and competitor details. The response includes a
conversation pointer (id and source) to the call, ticket, or other source the record came from, or null when no openable source is stored; pass both to get_conversation to read the full source. For email, it also returns every exact supporting span in ordered evidence.
search_opportunities
Find the biggest Themes ranked by business impact. In tool names,opportunity means Theme.
Returns: Themes with RIC scores (reach/impact/confidence), customer counts, severity breakdown, and velocity status.
get_opportunity
Get full detail for a specific Theme, including evidence and revenue impact. In tool names,opportunity means Theme.
Returns: full evidence (top 50 quotes), customer list with IDs and deal values,
total_won_deal_value, and Features associated with parent Themes.