veryfront__search_project_logstrace_id, request_id, run_id and free-text search.
Use next_cursor from the response to paginate.
Access
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 |
start | string | No | Start time in ISO 8601 format. Defaults to 1 hour ago. Format: date-time. |
end | string | No | End time in ISO 8601 format. Defaults to now. Format: date-time. |
cursor | string | No | Pagination cursor from a previous response (next_cursor). |
limit | number | No | Max log entries to return (default: 100, max: 1000). Default: 100. Minimum: 1. Maximum: 1000. |
direction | string | No | Sort order (default: backward, with newest first). Default: "backward". Values: "forward", "backward". |
level | string | No | Filter by log level. Values: "error", "warn", "info", "debug". |
search | string | No | Free-text search over the fields each entry shows. Maximum length: 200. |
service | string | No | Filter by service: veryfront-server, veryfront-api or veryfront-proxy. Values: "veryfront-server", "veryfront-api", "veryfront-proxy". |
trace_id | string | No | Filter by exact trace ID to correlate logs with a distributed trace. Minimum length: 1. Maximum length: 64. |
request_id | string | No | Filter by exact request ID. Minimum length: 1. Maximum length: 128. |
run_id | string | No | Filter by exact run ID to see every service line that belongs to one run. Minimum length: 1. Maximum length: 128. |
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_logs",
"arguments": {}
}
}
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 |
|---|---|---|---|
entries | object[] | Yes | List of entries associated with this tool result. |
next_cursor | string or null | Yes | |
stats | object | Yes | Structured stats details associated with this tool result. |
Full schemas
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"description": "Project ID or slug"
},
"start": {
"type": "string",
"format": "date-time",
"description": "Start time in ISO 8601 format. Defaults to 1 hour ago."
},
"end": {
"type": "string",
"format": "date-time",
"description": "End time in ISO 8601 format. Defaults to now."
},
"cursor": {
"type": "string",
"description": "Pagination cursor from a previous response (next_cursor)."
},
"limit": {
"type": "number",
"minimum": 1,
"maximum": 1000,
"description": "Max log entries to return (default: 100, max: 1000).",
"default": 100
},
"direction": {
"type": "string",
"enum": [
"forward",
"backward"
],
"description": "Sort order (default: backward, with newest first).",
"default": "backward"
},
"level": {
"type": "string",
"enum": [
"error",
"warn",
"info",
"debug"
],
"description": "Filter by log level."
},
"search": {
"type": "string",
"maxLength": 200,
"description": "Free-text search over the fields each entry shows."
},
"service": {
"type": "string",
"enum": [
"veryfront-server",
"veryfront-api",
"veryfront-proxy"
],
"description": "Filter by service: veryfront-server, veryfront-api or veryfront-proxy."
},
"trace_id": {
"type": "string",
"minLength": 1,
"maxLength": 64,
"pattern": "^[A-Za-z0-9._-]+$",
"description": "Filter by exact trace ID to correlate logs with a distributed trace."
},
"request_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$",
"description": "Filter by exact request ID."
},
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[A-Za-z0-9._-]+$",
"description": "Filter by exact run ID to see every service line that belongs to one run."
}
},
"additionalProperties": false,
"description": "Arguments for the search_project_logs tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"type": "object",
"properties": {
"entries": {
"type": "array",
"items": {
"type": "object",
"properties": {
"timestamp": {
"type": "string"
},
"level": {
"type": "string"
},
"message": {
"type": "string"
},
"service": {
"type": "string"
},
"trace_id": {
"type": "string"
},
"request_id": {
"type": "string"
},
"run_id": {
"type": "string",
"description": "Run identifier associated with this result."
},
"metadata": {
"type": "object",
"additionalProperties": {
"type": "string",
"description": "Additional structured values associated with this result."
},
"description": "Additional structured metadata returned by the tool."
}
},
"required": [
"timestamp",
"level",
"message",
"service"
],
"additionalProperties": false
},
"description": "List of entries associated with this tool result."
},
"next_cursor": {
"type": [
"string",
"null"
]
},
"stats": {
"type": "object",
"properties": {
"bytes_processed": {
"type": "number"
},
"lines_processed": {
"type": "number"
},
"query_time_ms": {
"type": "number"
}
},
"required": [
"bytes_processed",
"lines_processed",
"query_time_ms"
],
"additionalProperties": false,
"description": "Structured stats details associated with this tool result."
}
},
"required": [
"entries",
"next_cursor",
"stats"
],
"additionalProperties": false,
"description": "Structured result returned by the search_project_logs tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}