Search conversations
Conversations that match a status, tag, customer or update date, with the newest update first.
MCP tool kustomer_read → search_conversations
read
Searches your Kustomer conversations and returns the matches without messages, sorted by most recent update. Filter by status (open, snoozed or done), tag, customer and the date of the last update. Pass next_cursor back as cursor for the next page. Use get_conversation for the full record and get_conversation_messages for the thread.
Parameters
| Name | Type | Description |
|---|---|---|
| status enum | enum | open, snoozed or done. |
| tag string | string | Only conversations with this tag. |
| customer_id string | string | Only conversations of this customer. |
| updated_before string | string | ISO date. Only conversations whose last update is earlier. |
| updated_after string | string | ISO date. Only conversations whose last update is later. |
| limit integer | integer | Results per page. Default: 25. |
| cursor string | string | Next page cursor from the previous call. |
tools/call
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "kustomer_read",
"arguments": {
"operation": "search_conversations",
"arguments": {}
}
}
}Example response
{
"content": [
{
"type": "text",
"text": "{ ... same JSON as structuredContent ... }"
}
],
"structuredContent": {
"conversations": [
{
"conversation_id": "6718d2e4a1b2c3d4e5f60733",
"name": "Export fails with an error",
"status": "snoozed",
"customer": {
"customer_id": "6712a0b4a1b2c3d4e5f60101",
"name": "Dana Whitfield"
},
"tags": [
"export",
"bug"
],
"channel": "email",
"updated_at": "2026-10-11T09:30:00Z"
}
],
"next_cursor": null
},
"isError": false
}