List conversations
Conversations in an inbox folder, with channel, labels, assignee and the last message.
MCP tool trengo_read → list_conversations
read
Returns the conversations of one folder of the inbox, newest first. Each row has the subject, the contact, the channel, the labels, the assignee and a preview of the last message with who wrote it and when. last_message_from filters each page you read; pass next_cursor back as cursor until it is null. Use get_conversation for the full thread.
Parameters
| Name | Type | Description |
|---|---|---|
| folder enum | enum | new, assigned_to_me, following or reminders. Default: new. |
| label string | string | Only conversations with this label, by name from list_labels. |
| last_message_from enum | enum | customer or team. Default: both. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "trengo_read",
"arguments": {
"operation": "list_conversations",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"conversations": [
{
"conversation_id": 5120344,
"subject": "Invoice shows the wrong VAT number",
"contact": "Lena Vos",
"channel": "Email",
"labels": [],
"assigned_to": null,
"last_message": {
"from": "customer",
"preview": "Hi, the invoice for order 4471 has the old VAT number on it. Can you send a corrected one?",
"at": "2026-10-20T06:52:00Z"
}
}
],
"next_cursor": null
},
"isError": false
}