MCPTools
Insight Conversations
Drill into the conversations behind a specific insight
get_insight_conversations
Returns conversations linked to a specific brand insight. Use after get_brand_insights to see the actual conversations that contributed to an insight.
Parameters
| Name | Type | Required | Description | Default |
|---|---|---|---|---|
brandInsightId | string | Yes | The insight ID from get_brand_insights | — |
limit | number | No | Maximum results (1–30) | 10 |
offset | number | No | Pagination offset | 0 |
Example Prompt
Show me the conversations behind the shipping time concerns insight (ins-001)Example Response
{
"brandInsightId": "ins-001",
"conversations": [
{
"conversationId": "conv-111",
"createdAt": "2025-01-25T10:00:00Z",
"customer": {
"name": "Sarah Johnson",
"phone": "+15551112222"
},
"checkoutState": "abandoned",
"messagePreview": "How long does shipping usually take? I need this by Friday."
},
{
"conversationId": "conv-222",
"createdAt": "2025-01-24T16:30:00Z",
"customer": {
"name": "Mike Chen",
"phone": "+15553334444"
},
"checkoutState": "recovered",
"messagePreview": "Do you offer express shipping?"
}
],
"totalCount": 2,
"limit": 10,
"offset": 0
}Notes
- Requires a
brandInsightIdfromget_brand_insights— call that first to get insight IDs - Use
get_conversation_detailsto read the full message thread for any returned conversation - This is useful for providing evidence-based recommendations — you can see the actual customer conversations behind every insight