Tool Usage Principles

In customer-facing conversations, use business language such as “view brand list”, “refresh data”, or “find negative posts”. Tool IDs are mainly for implementation, QA, and troubleshooting.

Collection tools return a jobId. After that, use get_refresh_progress until the job reaches completed before reading data. Do not repeatedly create or refresh while collection is running.

25-Tool Quick Reference

GroupTool IDBusiness MeaningBilling Type
Context and rulessocial_capabilitiesCapability introspectionFree
Context and rulesget_contextAccount, billingMode, brands, supported platformsFree
Context and rulesget_billing_rulesPoint billing rulesFree
Context and rulessuggest_next_actionsRecommended next actionsFree
Context and rulesexplain_errorError explanation and next actionFree
Knowledge spaceprepare_spaceCollection plan and cost estimateFree
Knowledge spacecreate_spaceCreate knowledge space and first collectionCollection pricing
Brand managementlist_brandsExisting brands/spacesFree
Brand managementget_brandBrand configuration and data statusFree
Brand managementprepare_brand_onboardingFull brand onboarding suggestionsFree
Brand managementsetup_brandFull brand onboardingCollection pricing
Brand managementupdate_brandUpdate brand configurationFree
Collectiondiagnose_brandData readiness checkFree
Collectionrefresh_brandRefresh existing brand dataCollection pricing
Collectionget_refresh_progressCollection progressFree
Collectionwait_for_refreshShort wait for collection completionFree
Data readingget_brand_metricsCore metrics and platform distributionFree
Data readingsearch_brand_postsSearch posts by filtersFree
Data readingfind_posts_aboutSemantic post searchFree
Data readingget_brand_sentimentSentiment distribution and driversFree
Data readingget_voice_shareVoice shareFree
Data readingcompare_competitorsMulti-dimensional competitor comparisonFree
Data readingget_risk_alertsRisk alertsFree
Analysisanalyze_brandAI deep analysisAI analysis pricing
Analysisget_brand_summaryQuick brand summaryFree

Billed Tools

ToolBilling Rule
create_spaceCreates a knowledge space and starts first collection; billed by estimated points after collection is accepted
setup_brandFull brand onboarding and collection; billed by estimated points after collection is accepted
refresh_brandRefreshes an existing brand; billed by estimated points after collection is accepted
analyze_brandAI deep-analysis report; billed at 600 points after successful report generation

See VOC Insight MCP Pricing for the collection point formula.