veryfront__list_project_trace_spansget_project_trace reports more spans than it returns, or with status=error to retrieve all error spans.
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 |
trace_id | string | Yes | Trace ID to page through. |
cursor | string | No | Opaque continuation from page_info.next or page_info.prev. Minimum length: 1. Maximum length: 4096. |
limit | integer | No | Max spans to return (default: 200, max: 1000). Default: 200. Minimum: 1. Maximum: 1000. |
status | string | No | Optional span status filter. Values: "ok", "error", "unset", "unknown". |
sort_order | string | No | Order by span start time. Defaults to asc. Default: "asc". Values: "asc", "desc". |
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__list_project_trace_spans",
"arguments": {
"trace_id": "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 |
|---|---|---|---|
data | object[] | Yes | Primary result records returned by the tool. |
page_info | object | Yes | Pagination cursor values for traversing the result set. |
Full schemas
{
"type": "object",
"properties": {
"project_reference": {
"type": "string",
"description": "Project ID or slug"
},
"trace_id": {
"type": "string",
"description": "Trace ID to page through."
},
"cursor": {
"type": "string",
"minLength": 1,
"maxLength": 4096,
"description": "Opaque continuation from page_info.next or page_info.prev."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 1000,
"description": "Max spans to return (default: 200, max: 1000).",
"default": 200
},
"status": {
"type": "string",
"enum": [
"ok",
"error",
"unset",
"unknown"
],
"description": "Optional span status filter."
},
"sort_order": {
"type": "string",
"enum": [
"asc",
"desc"
],
"description": "Order by span start time. Defaults to asc.",
"default": "asc"
}
},
"required": [
"trace_id"
],
"additionalProperties": false,
"description": "Arguments for the list_project_trace_spans tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"span_id": {
"type": "string"
},
"parent_span_id": {
"type": [
"string",
"null"
]
},
"name": {
"type": "string",
"description": "Human-readable name for the returned record."
},
"service": {
"type": "string"
},
"started_at": {
"type": "string"
},
"ended_at": {
"type": [
"string",
"null"
]
},
"duration_ms": {
"type": "number"
},
"status": {
"type": "string",
"enum": [
"ok",
"error",
"unset",
"unknown"
],
"description": "Lifecycle status for the returned record."
},
"status_message": {
"type": [
"string",
"null"
]
},
"attributes": {
"type": "object",
"additionalProperties": {
"type": "string",
"description": "Additional structured values associated with this result."
},
"description": "Structured attributes details associated with this tool result."
},
"events": {
"type": "array",
"items": {
"type": "object",
"properties": {
"name": {
"type": "string",
"description": "Human-readable name for the returned record."
},
"timestamp": {
"type": "string"
},
"attributes": {
"type": "object",
"additionalProperties": {
"type": "string",
"description": "Additional structured values associated with this result."
},
"description": "Structured attributes details associated with this tool result."
}
},
"required": [
"name",
"timestamp",
"attributes"
],
"additionalProperties": false
},
"description": "List of events associated with this tool result."
}
},
"required": [
"span_id",
"parent_span_id",
"name",
"service",
"started_at",
"ended_at",
"duration_ms",
"status",
"status_message",
"attributes",
"events"
],
"additionalProperties": false
},
"description": "Primary result records returned by the tool."
},
"page_info": {
"type": "object",
"properties": {
"self": {
"type": [
"string",
"null"
],
"description": "Cursor that refers to the current page."
},
"first": {
"type": "null"
},
"next": {
"type": [
"string",
"null"
],
"description": "Cursor for the next page when pagination is available."
},
"prev": {
"type": [
"string",
"null"
],
"description": "Cursor for the previous page when pagination is available."
}
},
"required": [
"self",
"first",
"next",
"prev"
],
"additionalProperties": false,
"description": "Pagination cursor values for traversing the result set."
}
},
"required": [
"data",
"page_info"
],
"additionalProperties": false,
"description": "Structured result returned by the list_project_trace_spans tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}