search_files
Recursively search filenames and UTF-8 contents within an approved root using case-insensitive substring matching, returning relative paths and brief snippets.
Instructions
Recursively search filenames and UTF-8 contents inside an approved root with case-insensitive substring matching. Returns relative paths and brief snippets, bounded by max_results and a file scan limit; skips symlinks and build folders. Use read_file for complete text.
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": {
"root": "<root>",
"query": "<query>"
},
"name": "search_files"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| path | No | Relative directory or subtree within the root; defaults to its top level. | . |
| root | Yes | Name of a configured approved root returned by list_roots. | |
| query | Yes | Case-insensitive filename or UTF-8 content substring to find. | |
| max_results | No | Maximum matching files, from 1 to 200; defaults to 50. |