search_project
Searches plain-text patterns across Godot project files and returns matching lines with file paths and line numbers. Use it to locate where a string, scene reference, or shader code appears in your project.
Instructions
Plain-text (substring, not regex) search across project files; the text goes in pattern. Default fileTypes ["gd","tscn","cs","gdshader"]; caseSensitive false; maxResults integer >= 1, default 100. Skips hidden entries and .mcp. Returns: matches[] (project-relative file, 1-indexed lineNumber, line), truncated, filesSearched, fileTypes. warnings leads when no file had a searched extension or a path was unreadable. Errors if pattern holds a line break or a parameter is undeclared.
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": {
"projectPath": "<projectPath>",
"pattern": "<pattern>"
},
"name": "search_project"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pattern | Yes | Plain-text string to search for (required; there is no query or regex parameter) | |
| fileTypes | No | File extensions to search (default: ["gd", "tscn", "cs", "gdshader"]) | |
| maxResults | No | Maximum matches to return, an integer of 1 or more (default: 100) | |
| projectPath | Yes | Path to the Godot project directory | |
| caseSensitive | No | Case-sensitive search (default: false) |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| matches | Yes | ||
| warnings | No | ||
| fileTypes | Yes | The extensions that were searched. | |
| truncated | Yes | ||
| filesSearched | Yes | Files read and searched. |