find_mentions
List every indexed document that mentions a word or phrase, with counts and matched word forms, so you can see exactly which documents mention a term and how often.
Instructions
List every indexed document that mentions a word or phrase, with counts.
For "which documents mention X", "list all", "how many", and "is X mentioned anywhere": this scans the whole index, where query_documents ranks a few passages and stops.
A term matches where a word begins and its end is open: акт finds
акта and актов, not контакт — but also актуально. forms lists the
word forms each term matched, with how many documents have each;
check it before trusting a count. A term wrapped in double quotes
matches that exact word only, so to narrow, pass the forms you
want, each quoted, with match="any". Case, ё/е and Unicode
composition are ignored. The match is literal, so a synonym or
another spelling is another term. terms is one string or a list
of up to 10; match="all" keeps documents containing every term
somewhere, match="any" those with at least one, and each row then
lists its terms. Titles are searched too.
Returns searchedDocuments (indexed documents in scope that pass the
filters), matchedDocuments, matchedChunks, forms, and documents:
title matches (inTitle) first, then by hits, the chunks that
mention a term. Each row has displayPath and firstMatch
{chunkIndex, parentId, snippet, and pages in a PDF as in
query_documents}, or null when only the title matched. limit
(default 50, capped at 200) pages the list and
nextOffset is present while more remain; the counts always cover
every match. With no match, notice states the absence and what it
covered. A row carries lookAlikes as in query_documents, from the
whole index: check them before quoting a figure.
Only indexed text is searched: files not yet synced (list_files
shows them) and images without OCR are not, and a phrase that a
chunk boundary splits is not found. scope, labels, dateFrom
and dateTo filter as in query_documents, and citations follow its
rule: each document's displayPath, verbatim.
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": {
"terms": "<terms>"
},
"name": "find_mentions"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | ||
| match | No | all | |
| scope | No | ||
| terms | Yes | ||
| dateTo | No | ||
| labels | No | ||
| offset | No | ||
| dateFrom | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||