veryfront__list_run_eventsAccess
No external-service connection is required. Use a Veryfront credential with access to the requested resources. Call type: Read-only.Arguments
See the full schema below for the accepted shape and constraints.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": "00000000-0000-4000-8000-000000000000"
}
}
}
Result
The published output shape is summarized below. Inspect both the MCP response content andisError when handling a call.
See the full schema below for the accepted shape and constraints.
Full schemas
{
"type": "object",
"anyOf": [
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"format": "uuid",
"description": "Run identifier that scopes the request."
},
"event_representation": {
"type": "string",
"const": "run-events-v1",
"description": "Provide the event representation."
},
"cursor": {
"anyOf": [
{
"type": "string",
"pattern": "^\\d+$",
"description": "Opaque pagination cursor returned by a previous response."
},
{
"type": "string",
"minLength": 1,
"description": "Opaque pagination cursor returned by a previous response."
}
],
"description": "Opaque pagination cursor returned by a previous response."
},
"limit": {
"type": "integer",
"minimum": 1,
"maximum": 100,
"default": 20,
"description": "Maximum number of records in a page, from 1 to 100. Defaults to 20."
},
"sort_order": {
"type": "string",
"enum": [
"asc",
"desc"
],
"default": "asc",
"description": "Provide the sort order."
},
"after_event_id": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"maximum": 9007199254740991,
"description": "Provide the after event id."
},
{
"type": "null",
"description": "Provide the after event id."
}
],
"description": "Provide the after event id."
},
"event_class": {
"type": "string",
"enum": [
"fact",
"delta"
],
"description": "Provide the event class."
},
"event_type": {
"type": "array",
"items": {
"type": "string",
"description": "One event type item supplied to the tool."
},
"maxItems": 32,
"description": "Provide one or more event type values."
},
"is_error": {
"type": "string",
"enum": [
"true",
"false"
],
"description": "Provide the is error."
},
"start": {
"type": "string",
"format": "date-time",
"description": "Provide the start."
},
"end": {
"type": "string",
"format": "date-time",
"description": "Provide the end."
},
"span_id": {
"type": "string",
"minLength": 1,
"description": "Provide the span id."
},
"turn_id": {
"type": "string",
"minLength": 1,
"description": "Provide the turn id."
},
"search": {
"type": "string",
"minLength": 1,
"maxLength": 200,
"description": "Provide the search."
},
"include_descendants": {
"$ref": "#/anyOf/0/properties/is_error",
"default": "false",
"description": "Provide the include descendants."
}
},
"required": [
"run_id"
],
"additionalProperties": false,
"description": "Arguments for the list_run_events tool."
},
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"minLength": 1,
"maxLength": 128,
"pattern": "^[a-zA-Z0-9_-]+$",
"description": "Run identifier that scopes the request."
},
"event_representation": {
"type": "string",
"const": "canonical-v1",
"description": "Provide the event representation."
},
"limit": {
"anyOf": [
{
"type": "integer",
"minimum": -9007199254740991,
"maximum": 9007199254740991,
"description": "Maximum number of results to return."
},
{
"type": "string",
"pattern": "^\\d+$",
"description": "Maximum number of results to return."
}
],
"description": "Maximum number of results to return."
},
"cursor": {
"type": "string",
"description": "Opaque pagination cursor returned by a previous response."
},
"sort_order": {
"type": "string",
"enum": [
"asc",
"desc"
],
"description": "Provide the sort order."
},
"after_event_id": {
"anyOf": [
{
"$ref": "#/anyOf/1/properties/limit",
"description": "Provide the after event id."
},
{
"type": "null",
"description": "Provide the after event id."
}
],
"description": "Provide the after event id."
},
"event_type": {
"type": "array",
"items": {
"type": "string",
"description": "One event type item supplied to the tool."
},
"maxItems": 32,
"description": "Provide one or more event type values."
},
"event_class": {
"type": "string",
"enum": [
"fact",
"delta"
],
"description": "Provide the event class."
},
"is_error": {
"anyOf": [
{
"type": "boolean",
"description": "Provide the is error."
},
{
"type": "string",
"enum": [
"true",
"false"
],
"description": "Provide the is error."
}
],
"description": "Provide the is error."
},
"start": {
"type": "string",
"description": "Provide the start."
},
"end": {
"type": "string",
"description": "Provide the end."
},
"span_id": {
"type": "string",
"description": "Provide the span id."
},
"turn_id": {
"type": "string",
"description": "Provide the turn id."
},
"search": {
"type": "string",
"description": "Provide the search."
},
"include_descendants": {
"$ref": "#/anyOf/1/properties/is_error",
"description": "Provide the include descendants."
},
"cursor_profile": {
"type": "string",
"const": "run-events-descendants-v1",
"description": "Provide the cursor profile."
}
},
"required": [
"run_id",
"event_representation"
],
"additionalProperties": false,
"description": "Arguments for the list_run_events tool."
}
],
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Arguments for the list_run_events tool."
}
{
"type": "object",
"anyOf": [
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"type": "object",
"properties": {
"event_id": {
"type": "integer",
"minimum": 0,
"description": "The event id returned by the tool."
},
"event_type": {
"type": "string",
"description": "The event type returned by the tool."
},
"payload": {
"description": "The payload returned by the tool."
},
"is_error": {
"type": "boolean",
"description": "The is error returned by the tool."
},
"created_at": {
"type": "string",
"description": "Creation timestamp in ISO 8601 format."
},
"run_id": {
"type": "string",
"format": "uuid",
"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 returned by the tool."
},
{
"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 returned by the tool."
},
{
"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 returned by the tool."
},
{
"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."
}
},
"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"
],
"additionalProperties": false,
"description": "One data item returned by the tool."
},
"description": "Primary result records returned by the tool."
},
"page_info": {
"type": "object",
"properties": {
"next": {
"type": [
"string",
"null"
],
"description": "Cursor for the next page when pagination is available."
}
},
"required": [
"next"
],
"additionalProperties": false,
"description": "Opaque cursor for the next page; null means there are no more results."
}
},
"required": [
"data",
"page_info"
],
"additionalProperties": false,
"description": "Structured result returned by the list_run_events tool."
},
{
"type": "object",
"properties": {
"data": {
"type": "array",
"items": {
"description": "One data item returned by the tool."
},
"description": "Primary result records returned by the tool."
},
"page_info": {
"type": "object",
"properties": {
"next_cursor": {
"type": [
"string",
"null"
],
"description": "The next cursor returned by the tool."
},
"has_more": {
"type": "boolean",
"description": "The has more returned by the tool."
}
},
"required": [
"next_cursor",
"has_more"
],
"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."
},
{
"type": "object",
"properties": {
"entries": {
"type": "array",
"items": {
"anyOf": [
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "canonical",
"description": "The kind returned by the tool."
},
"event": {
"type": "object",
"properties": {
"specversion": {
"type": "string",
"const": "1.0",
"description": "The specversion returned by the tool."
},
"vfversion": {
"type": "string",
"const": "1",
"description": "The vfversion returned by the tool."
},
"id": {
"type": "string",
"description": "Unique identifier for the returned record."
},
"source": {
"type": "string",
"description": "The source returned by the tool."
},
"subject": {
"type": "string",
"minLength": 1,
"description": "The subject returned by the tool."
},
"type": {
"type": "string",
"minLength": 1,
"description": "The type returned by the tool."
},
"datacontenttype": {
"type": "string",
"const": "application/json",
"description": "The datacontenttype returned by the tool."
},
"dataschema": {
"type": "string",
"description": "The dataschema returned by the tool."
},
"data": {
"type": "object",
"additionalProperties": {
"$ref": "#/anyOf/0/properties/data/items/properties/payload",
"description": "Additional structured values returned by the tool."
},
"description": "Primary result records returned by the tool."
},
"runid": {
"type": "string",
"minLength": 1,
"description": "The runid returned by the tool."
},
"recordedat": {
"type": "string",
"format": "date-time",
"description": "The recordedat returned by the tool."
}
},
"required": [
"specversion",
"vfversion",
"id",
"source",
"subject",
"type",
"datacontenttype",
"dataschema",
"data",
"runid",
"recordedat"
],
"additionalProperties": {
"$ref": "#/anyOf/0/properties/data/items/properties/payload",
"description": "Additional structured values returned by the tool."
},
"description": "Structured event details returned by the tool."
},
"metadata": {
"type": "object",
"properties": {
"event_id": {
"type": "integer",
"exclusiveMinimum": 0,
"maximum": 9007199254740991,
"description": "The event id returned by the tool."
},
"run_id": {
"type": "string",
"minLength": 1,
"description": "Run identifier associated with this result."
},
"storage": {
"type": "string",
"const": "persisted",
"description": "The storage returned by the tool."
},
"view": {
"type": "string",
"enum": [
"public",
"diagnostic"
],
"description": "The view returned by the tool."
},
"recorded_at": {
"type": "string",
"format": "date-time",
"description": "The recorded at returned by the tool."
},
"event_class": {
"anyOf": [
{
"type": "string",
"enum": [
"fact",
"delta"
],
"description": "The event class returned by the tool."
},
{
"type": "null",
"description": "The event class returned by the tool."
}
],
"description": "The event class returned by the tool."
},
"is_error": {
"type": [
"boolean",
"null"
],
"description": "The is error returned by the tool."
},
"span_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "The span id returned by the tool."
},
{
"type": "null",
"description": "The span id returned by the tool."
}
],
"description": "The span id returned by the tool."
},
"turn_id": {
"anyOf": [
{
"type": "string",
"minLength": 1,
"description": "The turn id returned by the tool."
},
{
"type": "null",
"description": "The turn id returned by the tool."
}
],
"description": "The turn id returned by the tool."
},
"unrecoverable_fields": {
"type": "array",
"items": {
"type": "string",
"minLength": 1,
"description": "One unrecoverable field item returned by the tool."
},
"description": "List of unrecoverable fields returned by the tool."
},
"origin": {
"$ref": "#/anyOf/0/properties/data/items/properties/payload",
"description": "The origin returned by the tool."
}
},
"required": [
"event_id",
"run_id",
"storage",
"view",
"recorded_at",
"event_class",
"is_error",
"span_id",
"turn_id",
"unrecoverable_fields"
],
"additionalProperties": false,
"description": "Additional structured metadata returned by the tool."
}
},
"required": [
"kind",
"event",
"metadata"
],
"additionalProperties": false,
"description": "One entry item returned by the tool."
},
{
"type": "object",
"properties": {
"kind": {
"type": "string",
"const": "legacy",
"description": "The kind returned by the tool."
},
"reason": {
"type": "string",
"enum": [
"unknown_type",
"reserved_type",
"blocked_type",
"unclassified_outcome",
"unclassified_request",
"unclassified_dispatch",
"malformed_payload",
"discriminator_conflict",
"unavailable_converter",
"derived_history",
"unprojectable_view"
],
"description": "The reason returned by the tool."
},
"legacy": {
"type": "object",
"properties": {
"event_type": {
"type": "string",
"minLength": 1,
"description": "The event type returned by the tool."
},
"payload": {
"$ref": "#/anyOf/0/properties/data/items/properties/payload",
"description": "The payload returned by the tool."
}
},
"required": [
"event_type",
"payload"
],
"additionalProperties": false,
"description": "Structured legacy details returned by the tool."
},
"metadata": {
"type": "object",
"properties": {
"event_id": {
"$ref": "#/anyOf/2/properties/entries/items/anyOf/0/properties/metadata/properties/event_id",
"description": "The event id returned by the tool."
},
"run_id": {
"$ref": "#/anyOf/2/properties/entries/items/anyOf/0/properties/metadata/properties/run_id",
"description": "Run identifier associated with this result."
},
"storage": {
"type": "string",
"enum": [
"persisted",
"derived"
],
"description": "The storage returned by the tool."
},
"view": {
"$ref": "#/anyOf/2/properties/entries/items/anyOf/0/properties/metadata/properties/view",
"description": "The view returned by the tool."
},
"recorded_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"description": "The recorded at returned by the tool."
},
{
"type": "null",
"description": "The recorded at returned by the tool."
}
],
"description": "The recorded at returned by the tool."
},
"event_class": {
"$ref": "#/anyOf/2/properties/entries/items/anyOf/0/properties/metadata/properties/event_class",
"description": "The event class returned by the tool."
},
"is_error": {
"$ref": "#/anyOf/2/properties/entries/items/anyOf/0/properties/metadata/properties/is_error",
"description": "The is error returned by the tool."
},
"span_id": {
"$ref": "#/anyOf/2/properties/entries/items/anyOf/0/properties/metadata/properties/span_id",
"description": "The span id returned by the tool."
},
"turn_id": {
"$ref": "#/anyOf/2/properties/entries/items/anyOf/0/properties/metadata/properties/turn_id",
"description": "The turn id returned by the tool."
},
"unrecoverable_fields": {
"$ref": "#/anyOf/2/properties/entries/items/anyOf/0/properties/metadata/properties/unrecoverable_fields",
"description": "The unrecoverable fields returned by the tool."
},
"origin": {
"$ref": "#/anyOf/2/properties/entries/items/anyOf/0/properties/metadata/properties/origin",
"description": "The origin returned by the tool."
}
},
"required": [
"event_id",
"run_id",
"storage",
"view",
"recorded_at",
"event_class",
"is_error",
"span_id",
"turn_id",
"unrecoverable_fields"
],
"additionalProperties": false,
"description": "Additional structured metadata returned by the tool."
}
},
"required": [
"kind",
"reason",
"legacy",
"metadata"
],
"additionalProperties": false,
"description": "One entry item returned by the tool."
}
],
"description": "One entry item returned by the tool."
},
"maxItems": 100,
"description": "List of entries returned by the tool."
},
"next_cursor": {
"anyOf": [
{
"type": "string",
"description": "The next cursor returned by the tool."
},
{
"type": "null",
"description": "The next cursor returned by the tool."
}
],
"description": "The next cursor returned by the tool."
},
"has_more": {
"type": "boolean",
"description": "The has more returned by the tool."
}
},
"required": [
"entries",
"next_cursor",
"has_more"
],
"additionalProperties": false,
"description": "Structured result returned by the list_run_events tool."
},
{
"type": "object",
"properties": {
"cursor_profile": {
"type": "string",
"const": "run-events-descendants-v1",
"description": "The cursor profile returned by the tool."
},
"entries": {
"type": "array",
"items": {
"$ref": "#/anyOf/2/properties/entries/items",
"description": "One entry item returned by the tool."
},
"maxItems": 100,
"description": "List of entries returned by the tool."
},
"next_cursor": {
"anyOf": [
{
"type": "string",
"maxLength": 2048,
"description": "The next cursor returned by the tool."
},
{
"type": "null",
"description": "The next cursor returned by the tool."
}
],
"description": "The next cursor returned by the tool."
},
"has_more": {
"type": "boolean",
"description": "The has more returned by the tool."
}
},
"required": [
"cursor_profile",
"entries",
"next_cursor",
"has_more"
],
"additionalProperties": false,
"description": "Structured result returned by the list_run_events tool."
}
],
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Structured result returned by the list_run_events tool."
}