Skip to main content

Overview & Discovery

get_overview

Get a high-level summary of your product intelligence landscape. Use this as a starting point.
ParameterTypeDefaultDescription
time_range7d 30d 90d all30dTime window
Returns: total insights, deal blockers, churn risks, top categories.

get_facets

Get aggregated counts by dimension. Use to understand distributions before drilling in.
ParameterTypeRequiredDescription
dimensionsarrayyesWhich dimensions: category, severity, feature_area, emotion, country, industry
date_fromstringnoStart date YYYY-MM-DD
date_tostringnoEnd date YYYY-MM-DD
Returns: top 20 values with counts per dimension. Get time-bucketed counts for trend analysis.
ParameterTypeDefaultDescription
querystringTopic to trend. Leave empty for overall volume
categorystringFilter by category
feature_areastringFilter by feature area
granularitydaily weekly monthlyweeklyTime bucket size
date_fromstring90 days agoStart date
date_tostringtodayEnd date
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.
ParameterTypeDefaultDescription
querystringCompany name, domain, or keyword
industrystringFilter by industry
countrystringFilter by country
has_active_dealsbooleanOnly companies with open deals
has_deal_blockersbooleanOnly companies with deal blockers
has_churn_risksbooleanOnly companies with churn risk signals
min_insightsintegerOnly companies with N+ insights
sortinsight_count deal_value frustration recency nameinsight_countSort order
limitinteger10Max results (1-50)
offsetinteger0Skip first N results
Returns: company profiles with CRM data, deal values, and intelligence stats.

get_customer

Get full profile for a specific customer.
ParameterTypeRequiredDescription
idstringyesCustomer ID from search_customers
Returns: CRM data, deals, contacts, intelligence summary, strategic signals.

Product Intelligence

search_insights

Find product intelligence using hybrid search (keyword + semantic). Returns 300-character content previews and a customers_mentioned summary.
ParameterTypeDefaultDescription
querystringWhat to search for. Works with natural language
customer_idstringFilter to one customer
categorybug feature request improvement integration issue missing functionality ux/ui issue documentation performance issue security issue reportingFilter by category
severityCritical High Medium LowFilter by severity
is_deal_blockerbooleanOnly deal-blocking insights
is_churn_riskbooleanOnly churn-risk insights
feature_areastringFilter by product area
emotionstringFilter by emotion (frustrated, urgent, confused, hopeful, etc.)
countrystringFilter by customer country
industrystringFilter by customer industry
date_fromstringStart date YYYY-MM-DD
date_tostringEnd date YYYY-MM-DD
sortrelevance severity frustration recencyrelevanceSort order
limitinteger20Max results (1-100)
offsetinteger0Skip first N results
Returns: matching insights with content previews, plus a customers_mentioned summary showing which customers raised this topic.

get_insight

Get full detail for a specific insight.
ParameterTypeRequiredDescription
idstringyesInsight ID from search_insights
Returns: full verbatim content, pain point, workaround, use case, business outcomes, kano category, reporter details.

Sales Intelligence

search_signals

Search strategic intelligence — satisfaction, churn, competitor mentions, buying behavior.
ParameterTypeDefaultDescription
querystringWhat to search for
typestringSignal type: satisfaction, churn_reason, competitor_mention, decision_criteria, purchase_hesitation, win_reason, onboarding_friction, and more
customer_idstringFilter to one customer
date_fromstringStart date YYYY-MM-DD
competitor_namestringFilter by competitor name. Use get_competitors to see valid names
date_tostringEnd date YYYY-MM-DD
sortrelevance recencyrelevanceSort order
limitinteger20Max results (1-100)
offsetinteger0Skip first N results
Returns: strategic signals with content previews, churn urgency, satisfaction level, competitor names.

get_competitors

List your configured competitors with mention counts from customer conversations. Use this to see which competitors come up most, then drill in with search_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 signal.
ParameterTypeRequiredDescription
idstringyesSignal ID from search_signals
Returns: full content, context, source URL (links to original conversation), competitor details.

search_opportunities

Find the biggest clustered product problems ranked by business impact.
ParameterTypeDefaultDescription
querystringSearch by topic
statusactive new declined allactiveFilter by status
velocity_statusaccelerating active cooling dormantFilter by growth trend
sortric_score signal_count customer_count deal_blocker_count recencyric_scoreSort order
min_signalsinteger10Minimum insight count
has_deal_blockersbooleanOnly opportunities with deal blockers
limitinteger10Max results (1-50)
offsetinteger0Skip first N results
Returns: opportunities with RIC scores (reach/impact/confidence), customer counts, severity breakdown, velocity status.

get_opportunity

Get full detail for a specific opportunity, including evidence and revenue impact.
ParameterTypeRequiredDescription
idstringyesOpportunity ID from search_opportunities
Returns: full evidence (top 50 quotes), customer list with IDs and deal values, total_won_deal_value, features for parent opportunities.