veryfront__search_project_file_textAccess
No external-service connection is required. Use a Veryfront credential with access to the requested resources. Call type: Read-only.Arguments
| Field | Type | Required | Description and constraints |
|---|---|---|---|
project_reference | string | No | Project ID or slug whose selected files should be searched. |
ref | string | No | Content selector: main, branch:<name-or-id>, release:<version>, or env:<name>. Omit for main. |
branch | string | No | Branch name or ID; alias for ref=branch:<value>. |
branch_id | string | No | Legacy branch name or ID alias. Conflicting selectors are rejected. |
query | string | Yes | Literal text to find, or a regular expression when is_regex is true. |
pattern | string | No | Optional file path pattern, for example .tsx or pages/. |
is_regex | boolean | No | Interpret query as a regular expression (default: false). |
case_sensitive | boolean | No | Match letter case exactly (default: false). |
max_results | integer | No | Maximum matching files from 1 to 100 (default: 50). Limits files, not matching lines. Minimum: 1. Maximum: 100. |
Example request
Send this JSON-RPC request through an initialized MCP client. Replace sample identifiers and values before calling the tool. See MCP client setup.request.json
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "veryfront__search_project_file_text",
"arguments": {
"query": "example"
}
}
}
Result
The published output shape is summarized below. Inspect both the MCP response content andisError when handling a call.
| Field | Type | Required | Description and constraints |
|---|---|---|---|
results | object[] | Yes | Matching files visible to the caller. |
total_files | number | Yes | Number of matching files returned, after access filtering and the matching-file limit. |
Full schemas
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"description": "Project ID or slug whose selected files should be searched."
},
"ref": {
"type": "string",
"description": "Content selector: main, branch:<name-or-id>, release:<version>, or env:<name>. Omit for main."
},
"branch": {
"type": "string",
"description": "Branch name or ID; alias for ref=branch:<value>."
},
"branch_id": {
"type": "string",
"description": "Legacy branch name or ID alias. Conflicting selectors are rejected."
},
"query": {
"type": "string",
"description": "Literal text to find, or a regular expression when is_regex is true."
},
"pattern": {
"type": "string",
"description": "Optional file path pattern, for example *.tsx or pages/*."
},
"is_regex": {
"type": "boolean",
"description": "Interpret query as a regular expression (default: false)."
},
"case_sensitive": {
"type": "boolean",
"description": "Match letter case exactly (default: false)."
},
"max_results": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"description": "Maximum matching files from 1 to 100 (default: 50). Limits files, not matching lines."
}
},
"required": [
"query"
],
"additionalProperties": false,
"description": "Arguments for the search_project_file_text tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"type": "object",
"properties": {
"results": {
"type": "array",
"items": {
"type": "object",
"properties": {
"id": {
"type": "string",
"description": "File ID when supplied by the content source."
},
"path": {
"type": "string",
"description": "Path of the matching project source file."
},
"content": {
"type": "string",
"description": "Full file content when available from the content source."
},
"matches": {
"type": "array",
"items": {
"type": "object",
"properties": {
"line": {
"type": "number",
"description": "1-based line number of the matching line."
},
"content": {
"type": "string",
"description": "Matching line text, without surrounding lines."
}
},
"required": [
"line",
"content"
],
"additionalProperties": false,
"description": "One matching source line."
},
"description": "Matching lines within this file."
}
},
"required": [
"path",
"matches"
],
"additionalProperties": false,
"description": "One matching project source file."
},
"description": "Matching files visible to the caller."
},
"total_files": {
"type": "number",
"description": "Number of matching files returned, after access filtering and the matching-file limit."
}
},
"required": [
"results",
"total_files"
],
"additionalProperties": false,
"description": "Structured result returned by the search_project_file_text tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}