Search WhatsApp messages
searchFind WhatsApp messages by meaning or exact words, with nearby source context and citations, and flag ambiguous matches for verification.
Instructions
Find by meaning and words, with nearby source contexts. Use the question and known context, never guessed filters. Auto: exact codes/quoted literals; words: substrings. Check corrections; assessment flags ambiguity. Cite the supporting message.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"query": "<query>"
},
"name": "search"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Only chats with people filed under this tag | |
| from | No | "me", a number, an id, or a name only one person has | |
| limit | No | ||
| match | No | auto: questions by meaning, codes/quotes by words | auto |
| query | Yes | ||
| since | No | ISO date or time | |
| until | No | ISO date or time | |
| before | No | Older lexical matches; auto uses words with a cursor | |
| chat_id | No | Chat id, number or name (one chat only) | |
| full_text | No | Each message's text whole; a list cuts long ones otherwise | |
| account_id | No | ||
| include_context | No | Nearby sources for the best five hits |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | Yes | keyword_fallback: meaning search could not run, see recall_unavailable | |
| sync | Yes | ||
| count | Yes | ||
| index | No | ||
| notes | No | Caveats to act on or tell the user | |
| query | Yes | ||
| contexts | No | ||
| coverage | No | null: it could not be counted | |
| messages | Yes | ||
| resolved | No | chat_id was a name: the chat it resolved to | |
| freshness | Yes | ||
| account_id | Yes | ||
| assessment | Yes | ||
| next_before | No | ||
| scan_capped | No | Older matches may be missing: narrow the search | |
| from_resolved | No | ||
| private_omitted | No | Matches from people tagged #private, left out: chat_id or from shows them | |
| searched_back_to | No | Older messages were not searched: narrow the search | |
| recall_unavailable | No | ||
| changed_during_read | No |