List run events

veryfront__list_run_events

Access

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.

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 and isError when handling a call.

See the full schema below for the accepted shape and constraints.

Full schemas

json
{
  "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."
}
json
{
  "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."
}