List archived chats
Archived chats, newest first, filtered by tag, agent, group, date or search text.
MCP tool livechat_read → list_archived_chats
read
Searches Archives and returns chats newest first with customer, agent, tags and the first and last message. The filters are the ones Archives offers. With several tags, match_tags decides whether a chat needs all of them or any of them. Pass next_cursor back as cursor for the next page.
Parameters
| Name | Type | Description |
|---|---|---|
| tags string[] | string[] | Tag names to filter by. |
| match_tags enum | enum | all or any. Default: any. |
| agent string | string | Only chats handled by this agent. |
| group string | string | Only chats in this group. |
| from date | date | Only chats ended on or after this date. |
| to date | date | Only chats ended on or before this date. |
| query string | string | Search text, like the Archives search bar. |
| 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_archived_chats",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"chats": [
{
"chat_id": "Q4D7XK2M91",
"customer": {
"name": "Sam Okafor"
},
"agent": "Maria Silva",
"group": "Support",
"tags": [
"shipping"
],
"ended_at": "2026-10-16T14:20:00Z",
"last_message": "Thanks, that helps."
}
],
"next_cursor": "eyJvZmZzZXQiOjIwfQ"
},
"isError": false
}