> ## Documentation Index
> Fetch the complete documentation index at: https://veryfront.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# List evaluation run projections

> List the runs of one eval, newest first by default, to follow their status or pick a run to inspect; returns one page of eval runs.

`veryfront__list_eval_run_projections`

Requires project.evals.read.

## Access

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

**Call type:** Read-only.

## Arguments

| Field | Type | Required | Description and constraints |
| - | - | - | - |
| `project_reference` | `string` | No | Project identifier or slug that scopes the tool call. Minimum length: `1`. |
| `eval_id` | `string` | Yes | Eval whose runs to list. Minimum length: `1`. |
| `limit` | `integer` | No | Maximum runs to return, 1 to 100. Defaults to 100. Maximum: `100`. |
| `cursor` | `string or null` | No | `page_info`.next of the previous page. Keep `sort_by` and `sort_order` the same across pages. |
| `sort_by` | `string or null` | No | Sort key. Defaults to `created_at`. |
| `sort_order` | `string or null` | No | Sort direction. Defaults to desc. |

## 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](https://veryfront.com/docs/cloud/getting-started/connect-mcp.md).

```json title="request.json" theme={null}
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "veryfront__list_eval_run_projections",
    "arguments": {
      "eval_id": "example"
    }
  }
}
```

## Result

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

| Field | Type | Required | Description and constraints |
| - | - | - | - |
| `data` | `object[]` | Yes | Primary result records returned by the tool. |
| `page_info` | `object` | Yes | Pagination cursor values for traversing the result set. |

## Full schemas

```json title="input-schema.json" theme={null}
{
  "type": "object",
  "properties": {
    "project_reference": {
      "type": "string",
      "minLength": 1,
      "description": "Project identifier or slug that scopes the tool call."
    },
    "eval_id": {
      "type": "string",
      "minLength": 1,
      "description": "Eval whose runs to list."
    },
    "limit": {
      "type": "integer",
      "exclusiveMinimum": 0,
      "maximum": 100,
      "description": "Maximum runs to return, 1 to 100. Defaults to 100."
    },
    "cursor": {
      "anyOf": [
        {
          "type": "string",
          "minLength": 1,
          "maxLength": 128,
          "description": "Opaque pagination cursor returned by a previous response."
        },
        {
          "type": "null",
          "description": "Opaque pagination cursor returned by a previous response."
        }
      ],
      "description": "page_info.next of the previous page. Keep sort_by and sort_order the same across pages."
    },
    "sort_by": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "created_at",
            "status"
          ],
          "description": "Provide the sort by."
        },
        {
          "type": "null",
          "description": "Provide the sort by."
        }
      ],
      "description": "Sort key. Defaults to created_at."
    },
    "sort_order": {
      "anyOf": [
        {
          "type": "string",
          "enum": [
            "asc",
            "desc"
          ],
          "description": "Provide the sort order."
        },
        {
          "type": "null",
          "description": "Provide the sort order."
        }
      ],
      "description": "Sort direction. Defaults to desc."
    }
  },
  "required": [
    "eval_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#",
  "description": "Arguments for the list_eval_run_projections tool."
}
```

```json title="output-schema.json" theme={null}
{
  "type": "object",
  "properties": {
    "data": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "kind": {
            "type": "string",
            "const": "eval-run",
            "description": "Always eval-run."
          },
          "run_id": {
            "type": "string",
            "description": "Run identifier."
          },
          "eval_id": {
            "type": "string",
            "description": "Eval the run executes."
          },
          "status": {
            "type": "string",
            "enum": [
              "pending",
              "running",
              "waiting",
              "completed",
              "failed",
              "cancelled"
            ],
            "description": "Run status: pending, running, waiting, completed, failed or cancelled."
          },
          "target_kind": {
            "type": "string",
            "const": "agent",
            "description": "What the eval runs against: always agent."
          },
          "target": {
            "type": "string",
            "description": "Identifier of the agent the eval runs against."
          },
          "source": {
            "type": "object",
            "properties": {
              "file_path": {
                "type": "string",
                "description": "Source file path of the eval definition."
              },
              "export_name": {
                "type": "string",
                "description": "Name of the export that declares the eval in its source file."
              }
            },
            "required": [
              "file_path",
              "export_name"
            ],
            "additionalProperties": false,
            "description": "Source of the eval definition the run executes, when known."
          },
          "summary": {
            "anyOf": [
              {
                "description": "The summary returned by the tool."
              },
              {
                "type": "null",
                "description": "The summary returned by the tool."
              }
            ],
            "description": "Result summary of a finished run: records, pass rate and metric results; null until it finishes."
          },
          "report_path": {
            "type": [
              "string",
              "null"
            ],
            "description": "Path of the run report, or null until the report is written."
          },
          "error": {
            "anyOf": [
              {
                "description": "Error details returned by the tool."
              },
              {
                "type": "null",
                "description": "Error details returned by the tool."
              }
            ],
            "description": "Error of a failed run, or null."
          },
          "metadata": {
            "type": "object",
            "additionalProperties": {
              "description": "Additional structured values returned by the tool."
            },
            "description": "Free-form JSON object stored with the run."
          },
          "created_at": {
            "type": "string",
            "description": "When the run was created, in ISO 8601 format."
          },
          "started_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "When the run started, in ISO 8601 format, or null."
          },
          "completed_at": {
            "type": [
              "string",
              "null"
            ],
            "description": "When the run finished, in ISO 8601 format, or null."
          }
        },
        "required": [
          "kind",
          "run_id",
          "eval_id",
          "status",
          "target_kind",
          "target",
          "report_path",
          "metadata",
          "created_at",
          "started_at",
          "completed_at"
        ],
        "additionalProperties": false,
        "description": "Eval run."
      },
      "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",
          "description": "The first returned by the tool."
        },
        "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": "One page of eval runs.",
  "$schema": "http://json-schema.org/draft-07/schema#"
}
```

<details>
  <summary>Try this tool</summary>

  Replace sample arguments with values for your project or connected account. Calls run only when you select Run tool.

  MCP tool call

  Call `veryfront__list_eval_run_projections` against the Veryfront MCP endpoint.

  Bearer token or API key

  Arguments (JSON)

  Run tool

  Output JSON

  <pre />
</details>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.