List alerts

veryfront__list_project_alerts

Requires project.logs.read.

Access

No external-service connection is required. Use a Veryfront credential with access to the requested resources.

Call type: Read-only.

Arguments

FieldTypeRequiredDescription and constraints
cursorstringNoOpaque cursor pointing at the next page. Omit it to read the first page.
limitnumberNoMaximum number of entries to return. Defaults to 20 and is capped at 100. Default: 20. Minimum: 1. Maximum: 100.
statusstring[]NoOnly alerts in one of these statuses. Omit for firing and resolved alerts.
sort_orderstringNodesc lists the newest alert first. Default: "desc". Values: "asc", "desc".
project_referencestringNoProject ID or slug

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_project_alerts",
    "arguments": {}
  }
}

Result

The published output shape is summarized below. Inspect both the MCP response content and isError when handling a call.

FieldTypeRequiredDescription and constraints
dataobject[]YesPrimary result records returned by the tool.
page_infoobjectYesPagination cursor values for traversing the result set.

Full schemas

json
{
  "type": "object",
  "properties": {
    "cursor": {
      "type": "string",
      "description": "Opaque cursor pointing at the next page. Omit it to read the first page."
    },
    "limit": {
      "type": "number",
      "minimum": 1,
      "maximum": 100,
      "description": "Maximum number of entries to return. Defaults to 20 and is capped at 100.",
      "default": 20
    },
    "status": {
      "type": "array",
      "items": {
        "type": "string",
        "enum": [
          "firing",
          "resolved"
        ],
        "description": "One statu item supplied to the tool."
      },
      "minItems": 1,
      "description": "Only alerts in one of these statuses. Omit for firing and resolved alerts."
    },
    "sort_order": {
      "type": "string",
      "enum": [
        "asc",
        "desc"
      ],
      "description": "desc lists the newest alert first.",
      "default": "desc"
    },
    "project_reference": {
      "type": "string",
      "description": "Project ID or slug"
    }
  },
  "additionalProperties": false,
  "description": "Each alert is one firing of a Veryfront alert rule over the last 30 days of retained history. Follow up with list_project_logs or list_project_traces over the alert window.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}
json
{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "Identifies this firing of the alert."
          },
          "rule_id": {
            "type": "string",
            "description": "UID of the Grafana alert rule, for example project-agent-run-failures."
          },
          "title": {
            "type": "string",
            "description": "Short human-readable title returned by the tool."
          },
          "status": {
            "type": "string",
            "enum": [
              "firing",
              "resolved"
            ],
            "description": "Lifecycle status for the returned record."
          },
          "error_code": {
            "type": [
              "string",
              "null"
            ],
            "description": "Terminal error code of the failed runs; null for rules without one."
          },
          "run_kind": {
            "type": [
              "string",
              "null"
            ],
            "description": "Kind of the runs the alert is about, when the rule tells them apart."
          },
          "run_status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Status of the unfinished runs the alert is about."
          },
          "started_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "When the alert fired; null when it fired before the 30 days of retained history."
          },
          "resolved_at": {
            "type": [
              "string",
              "null"
            ]
          },
          "_links": {
            "type": "object",
            "properties": {
              "logs": {
                "type": "object",
                "properties": {
                  "href": {
                    "type": "string"
                  }
                },
                "required": [
                  "href"
                ],
                "additionalProperties": false
              },
              "traces": {
                "$ref": "#/properties/data/items/properties/_links/properties/logs"
              }
            },
            "additionalProperties": false,
            "description": "Investigation links clipped to retained telemetry; omitted when the episode is outside the available window."
          }
        },
        "required": [
          "id",
          "rule_id",
          "title",
          "status",
          "error_code",
          "run_kind",
          "run_status",
          "started_at",
          "resolved_at",
          "_links"
        ],
        "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_project_alerts tool.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}