List chats
Chats in My chats, Queued chats, Unassigned chats or Supervised chats, with customer, channel and last message.
MCP tool livechat_read → list_chats
read
Lists the chats in one of the lists you see in the Chats section: my, queued, unassigned or supervised. Each item has the customer, the channel, the last message and whether the chat is active or inactive. Pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| list enum | enum | my, queued, unassigned or supervised. Default: my. |
| limit integer | integer | Number of chats per page. Default: 20. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "livechat_read",
"arguments": {
"operation": "list_chats",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"chats": [
{
"chat_id": "PJ0MRSHTDG",
"list": "unassigned",
"customer": {
"name": "Lena Ortiz",
"email": "lena@example.com"
},
"channel": "WhatsApp",
"active": true,
"last_message": {
"from": "customer",
"text": "Hi, I was charged twice in October.",
"sent_at": "2026-10-17T05:42:00Z"
}
}
],
"next_cursor": null
},
"isError": false
}