Get run event

veryfront__get_run_event

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__get_run_event",
    "arguments": {
      "run_id": "00000000-0000-4000-8000-000000000000",
      "event_id": 1
    }
  }
}

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_id": {
          "type": "integer",
          "exclusiveMinimum": 0,
          "description": "Provide the event id."
        }
      },
      "required": [
        "run_id",
        "event_id"
      ],
      "additionalProperties": false,
      "description": "Arguments for the get_run_event 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_id": {
          "anyOf": [
            {
              "type": "integer",
              "minimum": -9007199254740991,
              "maximum": 9007199254740991,
              "description": "Provide the event id."
            },
            {
              "type": "string",
              "pattern": "^\\d+$",
              "description": "Provide the event id."
            }
          ],
          "description": "Provide the event id."
        },
        "event_representation": {
          "type": "string",
          "const": "canonical-v1",
          "description": "Provide the event representation."
        }
      },
      "required": [
        "run_id",
        "event_id",
        "event_representation"
      ],
      "additionalProperties": false,
      "description": "Arguments for the get_run_event tool."
    }
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "Arguments for the get_run_event tool."
}
json
{
  "type": "object",
  "anyOf": [
    {
      "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": "Structured result returned by the get_run_event tool."
    },
    {
      "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/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/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/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": "Structured result returned by the get_run_event 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/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/1/anyOf/0/properties/metadata/properties/event_id",
                  "description": "The event id returned by the tool."
                },
                "run_id": {
                  "$ref": "#/anyOf/1/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/1/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/1/anyOf/0/properties/metadata/properties/event_class",
                  "description": "The event class returned by the tool."
                },
                "is_error": {
                  "$ref": "#/anyOf/1/anyOf/0/properties/metadata/properties/is_error",
                  "description": "The is error returned by the tool."
                },
                "span_id": {
                  "$ref": "#/anyOf/1/anyOf/0/properties/metadata/properties/span_id",
                  "description": "The span id returned by the tool."
                },
                "turn_id": {
                  "$ref": "#/anyOf/1/anyOf/0/properties/metadata/properties/turn_id",
                  "description": "The turn id returned by the tool."
                },
                "unrecoverable_fields": {
                  "$ref": "#/anyOf/1/anyOf/0/properties/metadata/properties/unrecoverable_fields",
                  "description": "The unrecoverable fields returned by the tool."
                },
                "origin": {
                  "$ref": "#/anyOf/1/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": "Structured result returned by the get_run_event tool."
        }
      ],
      "description": "Structured result returned by the get_run_event tool."
    }
  ],
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "Structured result returned by the get_run_event tool."
}