veryfront__list_run_eventspage_info.next as cursor for the next page.
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 |
|---|---|---|---|
run_id | string | Yes | Public run id, as returned by REST GET /runs/{run_id}. Minimum length: 1. |
cursor | string or integer | No | The previous page’s page_info.next event id, excluded from the next page. |
limit | integer | No | Page size, 1-500 (default 100). |
sort_order | string | No | asc (default, oldest first) or desc. |
event_class | string | No | Only events of this class (fact or delta), as on REST GET /runs/{run_id}/events. |
event_type | string or string[] | No | Only events of these canonical types, as on REST GET /runs/{run_id}/events. |
is_error | boolean | No | true: only error events; false: only other events. |
start | string | No | Only events created at or after this ISO 8601 instant, as on REST GET /runs/{run_id}/events. |
end | string | No | Only events created before this ISO 8601 instant, as on REST GET /runs/{run_id}/events. |
span_id | string | No | Only events with this envelope span_id, as on REST GET /runs/{run_id}/events. |
turn_id | string | No | Only events with this envelope turn_id, as on REST GET /runs/{run_id}/events. |
search | string | No | Case-insensitive payload substring, as on REST GET /runs/{run_id}/events. |
include_descendants | boolean | No | Also include events of readable descendant runs, as on REST GET /runs/{run_id}/events. |
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_run_events",
"arguments": {
"run_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": {
"run_id": {
"type": "string",
"minLength": 1,
"description": "Public run id, as returned by REST GET /runs/{run_id}."
},
"cursor": {
"anyOf": [
{
"type": "string",
"description": "Provide the option 1."
},
{
"type": "integer",
"description": "Provide the option 2."
}
],
"description": "The previous page's page_info.next event id, excluded from the next page."
},
"limit": {
"type": "integer",
"description": "Page size, 1-500 (default 100)."
},
"sort_order": {
"type": "string",
"description": "asc (default, oldest first) or desc."
},
"event_class": {
"type": "string",
"description": "Only events of this class (fact or delta), as on REST GET /runs/{run_id}/events."
},
"event_type": {
"anyOf": [
{
"type": "string",
"description": "Provide the option 1."
},
{
"type": "array",
"items": {
"type": "string",
"description": "One option 2 item supplied to the tool."
},
"description": "Provide one or more option 2 values."
}
],
"description": "Only events of these canonical types, as on REST GET /runs/{run_id}/events."
},
"is_error": {
"type": "boolean",
"description": "true: only error events; false: only other events."
},
"start": {
"type": "string",
"description": "Only events created at or after this ISO 8601 instant, as on REST GET /runs/{run_id}/events."
},
"end": {
"type": "string",
"description": "Only events created before this ISO 8601 instant, as on REST GET /runs/{run_id}/events."
},
"span_id": {
"type": "string",
"description": "Only events with this envelope span_id, as on REST GET /runs/{run_id}/events."
},
"turn_id": {
"type": "string",
"description": "Only events with this envelope turn_id, as on REST GET /runs/{run_id}/events."
},
"search": {
"type": "string",
"description": "Case-insensitive payload substring, as on REST GET /runs/{run_id}/events."
},
"include_descendants": {
"type": "boolean",
"description": "Also include events of readable descendant runs, as on REST GET /runs/{run_id}/events."
}
},
"required": [
"run_id"
],
"additionalProperties": false,
"description": "Arguments for the list_run_events tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"event_id": {
"type": "integer",
"minimum": 0
},
"event_type": {
"type": "string",
"minLength": 1
},
"payload": {},
"is_error": {
"type": "boolean"
},
"created_at": {
"type": "string",
"description": "Creation timestamp in ISO 8601 format."
},
"run_id": {
"type": "string",
"minLength": 1,
"description": "Run identifier associated with the record."
},
"event_class": {
"type": "string",
"enum": [
"fact",
"delta"
],
"description": "The event class associated with this record."
},
"span_id": {
"type": "string",
"minLength": 1,
"description": "The span id associated with this record."
},
"parent_span_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "The parent span id associated with this record."
},
{
"type": "null",
"description": "The parent span id returned by the tool."
}
],
"description": "The parent span id associated with this record."
},
"turn_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "The turn id associated with this record."
},
{
"type": "null",
"description": "The turn id returned by the tool."
}
],
"description": "The turn id associated with this record."
},
"origin_event_type": {
"type": "string",
"minLength": 1,
"description": "The origin event type associated with this record."
},
"origin_custom_name": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "The origin custom name associated with this record."
},
{
"type": "null",
"description": "The origin custom name returned by the tool."
}
],
"description": "The origin custom name associated with this record."
},
"unrecoverable_fields": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"description": "One unrecoverable field item associated with this record."
},
"description": "List of unrecoverable fields associated with this record."
},
"specversion": {
"type": "string",
"const": "1.0"
},
"id": {
"type": "string",
"minLength": 1,
"description": "Unique identifier for the returned record."
},
"source": {
"type": "string",
"minLength": 1
},
"type": {
"type": "string",
"minLength": 1
},
"subject": {
"type": "string",
"minLength": 1
},
"time": {
"type": "string",
"format": "date-time"
},
"datacontenttype": {
"type": "string",
"const": "application/json"
},
"dataschema": {
"type": "string",
"format": "uri"
},
"data": {
"$ref": "#/properties/data/items/properties/payload",
"description": "Primary result records returned by the tool."
},
"runkind": {
"type": "string",
"enum": [
"agent",
"workflow",
"task"
]
}
},
"required": [
"event_id",
"event_type",
"payload",
"is_error",
"created_at",
"run_id",
"event_class",
"span_id",
"parent_span_id",
"turn_id",
"origin_event_type",
"origin_custom_name",
"unrecoverable_fields",
"specversion",
"id",
"source",
"type",
"subject",
"datacontenttype",
"data",
"runkind"
],
"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_run_events tool.",
"$schema": "http://json-schema.org/draft-07/schema#"
}