veryfront__search_project_tracesveryfront__list_project_traces) instead.
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 |
|---|---|---|---|
environment | string | No | Exact runtime environment tag, for example preview or production. Untagged telemetry is excluded. Minimum length: 1. Maximum length: 200. |
host | string | No | Exact request host (without scheme or path), for example demo.preview.veryfront.com. Untagged telemetry is excluded. Minimum length: 1. Maximum length: 253. |
start | string | No | Start time. ISO 8601 timestamp accepted by the Veryfront API. The backend converts it to the unix-second format required by Grafana Cloud Tempo. Traces are kept for 30 days and one search spans at most 30 days; an older start or a wider range returns 400. Format: date-time. |
end | string | No | End time. ISO 8601 timestamp accepted by the Veryfront API. The backend converts it to the unix-second format required by Grafana Cloud Tempo. Traces are kept for 30 days and one search spans at most 30 days; an older start or a wider range returns 400. Format: date-time. |
limit | number | No | Max traces to return (default: 20, max: 100). Default: 20. Minimum: 1. Maximum: 100. |
service | string | No | Optional OpenTelemetry service.name filter, for example veryfront-api, veryfront-studio, or veryfront-server. Maximum length: 200. |
status | string | No | Optional Tempo status filter. Use ok, error, or unset. error matches traces with an error span of the project or without project context anywhere in the trace, as trace detail reports. Values: "ok", "error", "unset". |
min_duration_ms | number | No | Optional minimum trace duration in milliseconds. Minimum: 0. |
run_id | string | No | Optional run ID. Returns traces with a span whose run.id, parent.run.id, or agent.run.id is this run, or that contain its runtime control-plane request. Minimum length: 1. Maximum length: 200. |
sort_by | string | No | Field to order the returned traces by. Defaults to timestamp; ties break by trace ID in the same direction. MCP and GraphQL preserve the search’s newest-first nanosecond order when both sort controls are omitted. Default: "timestamp". Values: "timestamp", "duration", "status", "service". |
sort_order | string | No | Sort direction. Defaults to desc. Default: "desc". Values: "asc", "desc". |
project_reference | string | No | Project ID or slug |
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_traces",
"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 |
|---|---|---|---|
traces | object[] | Yes | List of traces associated with this tool result. |
stats | object | Yes | Structured stats details associated with this tool result. |
Full schemas
{
"type": "object",
"properties": {
"environment": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"pattern": "^[A-Za-z0-9._-]+$",
"description": "Exact runtime environment tag, for example preview or production. Untagged telemetry is excluded."
},
"host": {
"type": "string",
"minLength": 1,
"maxLength": 253,
"pattern": "^[A-Za-z0-9.-]+(?::[0-9]+)?$",
"description": "Exact request host (without scheme or path), for example demo.preview.veryfront.com. Untagged telemetry is excluded."
},
"start": {
"type": "string",
"format": "date-time",
"description": "Start time. ISO 8601 timestamp accepted by the Veryfront API. The backend converts it to the unix-second format required by Grafana Cloud Tempo. Traces are kept for 30 days and one search spans at most 30 days; an older start or a wider range returns 400."
},
"end": {
"type": "string",
"format": "date-time",
"description": "End time. ISO 8601 timestamp accepted by the Veryfront API. The backend converts it to the unix-second format required by Grafana Cloud Tempo. Traces are kept for 30 days and one search spans at most 30 days; an older start or a wider range returns 400."
},
"limit": {
"type": "number",
"minimum": 1,
"maximum": 100,
"description": "Max traces to return (default: 20, max: 100).",
"default": 20
},
"service": {
"type": "string",
"maxLength": 200,
"description": "Optional OpenTelemetry service.name filter, for example veryfront-api, veryfront-studio, or veryfront-server."
},
"status": {
"type": "string",
"enum": [
"ok",
"error",
"unset"
],
"description": "Optional Tempo status filter. Use ok, error, or unset. error matches traces with an error span of the project or without project context anywhere in the trace, as trace detail reports."
},
"min_duration_ms": {
"type": "number",
"minimum": 0,
"description": "Optional minimum trace duration in milliseconds."
},
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Optional run ID. Returns traces with a span whose run.id, parent.run.id, or agent.run.id is this run, or that contain its runtime control-plane request."
},
"sort_by": {
"type": "string",
"enum": [
"timestamp",
"duration",
"status",
"service"
],
"description": "Field to order the returned traces by. Defaults to timestamp; ties break by trace ID in the same direction. MCP and GraphQL preserve the search's newest-first nanosecond order when both sort controls are omitted.",
"default": "timestamp"
},
"sort_order": {
"type": "string",
"enum": [
"asc",
"desc"
],
"description": "Sort direction. Defaults to desc.",
"default": "desc"
},
"project_reference": {
"type": "string",
"description": "Project ID or slug"
}
},
"additionalProperties": false,
"description": "Use after inspecting project logs or when investigating slow or failing requests, then get_project_trace with a trace_id. Environment and host filters exclude untagged traces; the returned environment and host verify the matched request.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"type": "object",
"properties": {
"traces": {
"type": "array",
"items": {
"type": "object",
"properties": {
"trace_id": {
"type": "string"
},
"root_span_name": {
"type": "string"
},
"root_service": {
"type": "string"
},
"started_at": {
"type": "string"
},
"duration_ms": {
"type": "number"
},
"status": {
"type": "string",
"enum": [
"ok",
"error",
"unset",
"unknown"
],
"description": "Lifecycle status for the returned record."
},
"span_count": {
"type": "number"
},
"services": {
"type": "array",
"items": {
"type": "string"
},
"description": "List of services associated with this tool result."
},
"project_id": {
"type": "string",
"description": "Project identifier associated with this result."
},
"project_slug": {
"type": "string"
},
"environment": {
"type": "string"
},
"host": {
"type": "string"
}
},
"required": [
"trace_id",
"root_span_name",
"root_service",
"started_at",
"duration_ms",
"status",
"span_count",
"services",
"project_id"
],
"additionalProperties": false
},
"description": "List of traces associated with this tool result."
},
"stats": {
"type": "object",
"properties": {
"query_time_ms": {
"type": "number"
}
},
"required": [
"query_time_ms"
],
"additionalProperties": false,
"description": "Structured stats details associated with this tool result."
}
},
"required": [
"traces",
"stats"
],
"additionalProperties": false,
"description": "Structured result returned by the search_project_traces tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}