Find conversations
search_conversationsFind the user's conversations by name and return summaries — id, name, message count,
participants and date range. Omit query (or pass it empty) to list the most recent
conversations. Pass an id from the results to get_conversation to read the transcript, or to
search_messages to search the message text inside it. This matches conversation names only,
not message content: to find which conversation mentions something, call search_messages
without a conversation_id. Only conversations the user owns or has been shared are accessible.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_conversations"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | No | Optional text to match against conversation names. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| next_step | No | Present only when something stands between the user and more conversations: an empty archive (nothing to read yet) or a capture paused for billing. Relay it to the user instead of reporting that they have no conversations, or that nothing arrived. | |
| conversations | No |