veryfront__get_run_events_summary
Access
No external-service connection is required. Use a Veryfront credential with access to the requested resources.
Call type: Read-only.
Arguments
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.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "veryfront__get_run_events_summary",
"arguments": {
"run_id": "00000000-0000-4000-8000-000000000000"
}
}
}Result
The published output shape is summarized below. Inspect both the MCP response content and isError when handling a call.
Full schemas
{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"format": "uuid",
"description": "Run identifier that scopes the request."
},
"buckets": {
"type": "integer",
"minimum": 1,
"maximum": 500,
"default": 60,
"description": "Provide the buckets."
},
"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": "#/properties/is_error",
"default": "false",
"description": "Provide the include descendants."
}
},
"required": [
"run_id"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Arguments for the get_run_events_summary tool."
}{
"type": "object",
"properties": {
"run_id": {
"type": "string",
"format": "uuid",
"description": "Run identifier associated with this result."
},
"total": {
"type": "integer",
"minimum": 0,
"description": "The total returned by the tool."
},
"error_count": {
"type": "integer",
"minimum": 0,
"description": "The error count returned by the tool."
},
"first_event_id": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"description": "The first event id returned by the tool."
},
{
"type": "null",
"description": "The first event id returned by the tool."
}
],
"description": "The first event id returned by the tool."
},
"last_event_id": {
"anyOf": [
{
"type": "integer",
"minimum": 0,
"description": "The last event id returned by the tool."
},
{
"type": "null",
"description": "The last event id returned by the tool."
}
],
"description": "The last event id returned by the tool."
},
"first_event_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"description": "The first event at returned by the tool."
},
{
"type": "null",
"description": "The first event at returned by the tool."
}
],
"description": "The first event at returned by the tool."
},
"last_event_at": {
"anyOf": [
{
"type": "string",
"format": "date-time",
"description": "The last event at returned by the tool."
},
{
"type": "null",
"description": "The last event at returned by the tool."
}
],
"description": "The last event at returned by the tool."
},
"by_event_class": {
"type": "object",
"properties": {
"fact": {
"type": "integer",
"minimum": 0,
"description": "The fact returned by the tool."
},
"delta": {
"type": "integer",
"minimum": 0,
"description": "The delta returned by the tool."
}
},
"required": [
"fact",
"delta"
],
"additionalProperties": false,
"description": "Structured by event class details returned by the tool."
},
"by_event_type": {
"type": "array",
"items": {
"type": "object",
"properties": {
"event_type": {
"type": "string",
"minLength": 1,
"description": "The event type returned by the tool."
},
"event_class": {
"type": "string",
"enum": [
"fact",
"delta"
],
"description": "The event class associated with this record."
},
"count": {
"type": "integer",
"minimum": 0,
"description": "The count returned by the tool."
},
"error_count": {
"type": "integer",
"minimum": 0,
"description": "The error count returned by the tool."
}
},
"required": [
"event_type",
"event_class",
"count",
"error_count"
],
"additionalProperties": false,
"description": "One by event type item returned by the tool."
},
"description": "List of by event type returned by the tool."
},
"buckets": {
"type": "array",
"items": {
"type": "object",
"properties": {
"start": {
"type": "string",
"format": "date-time",
"description": "The start returned by the tool."
},
"end": {
"type": "string",
"format": "date-time",
"description": "The end returned by the tool."
},
"count": {
"type": "integer",
"minimum": 0,
"description": "The count returned by the tool."
},
"error_count": {
"type": "integer",
"minimum": 0,
"description": "The error count returned by the tool."
}
},
"required": [
"start",
"end",
"count",
"error_count"
],
"additionalProperties": false,
"description": "One bucket item returned by the tool."
},
"description": "Half-open time buckets `[start, end)` covering `first_event_at` through `last_event_at + 1 ms`. Boundaries use whole milliseconds; widths differ by at most 1 ms. Boundaries can be passed directly as the event-list `start` and `end` filters. The bucket count cannot exceed the span in milliseconds. Empty if no events match."
}
},
"required": [
"run_id",
"total",
"error_count",
"first_event_id",
"last_event_id",
"first_event_at",
"last_event_at",
"by_event_class",
"by_event_type",
"buckets"
],
"additionalProperties": false,
"$schema": "http://json-schema.org/draft-07/schema#",
"description": "Structured result returned by the get_run_events_summary tool."
}