MCPTools
Conversation Details
Get the full message thread and checkout details for a conversation
get_conversation_details
Returns the full details of a specific conversation including all messages, customer info, checkout/cart data, and goal state changes.
Parameters
| Name | Type | Required | Description | Default |
|---|---|---|---|---|
conversationId | string | Yes | The conversation ID to fetch details for | — |
Example Prompt
Show me the full conversation thread for conv-789Example Response
{
"id": "conv-789",
"createdAt": "2025-01-28T14:30:00Z",
"customer": {
"name": "John Smith",
"phone": "+15559876543"
},
"messages": [
{
"body": "Hi John! We noticed you left some items in your cart. Here's 10% off to complete your order: SAVE10",
"direction": "outbound",
"createdAt": "2025-01-28T14:30:00Z"
},
{
"body": "Oh nice, thanks! Let me check it out",
"direction": "inbound",
"createdAt": "2025-01-28T14:45:00Z"
}
],
"goalStateChanges": [
{ "state": "messaged", "createdAt": "2025-01-28T14:30:00Z" },
{ "state": "recovered", "createdAt": "2025-01-28T15:10:00Z" }
],
"checkout": {
"state": "recovered",
"totalPrice": "89.99",
"lineItems": [
{ "title": "Classic T-Shirt", "quantity": 2, "price": "29.99" },
{ "title": "Baseball Cap", "quantity": 1, "price": "24.99" }
],
"discountCodes": ["SAVE10"]
}
}Notes
- Use
conversation-searchorlist_conversationsfirst to find conversation IDs - The
messagesarray contains the full SMS thread in chronological order —outboundis from the brand,inboundis from the customer goalStateChangesshows the lifecycle of the conversation (e.g., messaged → recovered)- Checkout data includes the cart value, line items (products), and any discount codes used