---
title: "list_monitoring_results"
description: "List recent monitoring results (run outcomes)."
sidebarTitle: "list_monitoring_results"
lastUpdated: "2026-09-23"
---

> **For AI agents:** the complete documentation index is at [llms.txt](/llms.txt). Append `.md` to any page URL for its markdown version.

{/* GENERATED FILE: do not edit by hand. Regenerate with: node scripts/generate.mjs */}

List recent monitoring results (run outcomes).

<Note>
  **Read-only · Calls external systems.** Safe to call: this tool does not modify data.
</Note>

## Parameters

| Field | Type | Required | Description |
| --- | --- | --- | --- |
| `detail` | boolean | No | Return full JSON instead of compact summaries (default: false). |
| `end` | string | No | Results before this datetime (ISO 8601). Max span with start: 24 hours. |
| `monitoring_id` | number | No | Filter by monitor ID (from list_monitors). Required for operator-scoped results — without this, results span all operators. |
| `ordering` | string (-modified \| modified) | No | Sort field: -modified (default, newest first) or modified (oldest first). |
| `page` | number | No | Page number (default: 1). |
| `page_size` | number | No | Results per page (default: 20). |
| `product` | string | No | Filter by product slug (format: operator~product). |
| `start` | string | No | Results after this datetime (ISO 8601, e.g. 2026-02-28T00:00:00Z). Max span with end: 24 hours. Auto-set to now-24h if neither start nor end is provided. |
| `test_id` | number | No | Filter by test ID. |

## Example arguments

Illustrative arguments an agent supplies when calling this tool:

```json
{
  "detail": false,
  "end": "string"
}
```

## Description

```text
Returns compact summaries by default; use detail=true for full JSON. Returns summary fields only — use get_monitoring_result for the full execution payload.

Prerequisite: Call list_monitors with operator=<slug> first to get monitor IDs, then pass monitoring_id here. Without monitoring_id or product, results span ALL operators — do not skip this step.
```

## Related

- [`get_monitoring_result`](/mcp/tools/monitoring-results/get_monitoring_result)
- [`list_monitors`](/mcp/tools/discovery/list_monitors)

## What's next?

<Columns cols={2}>
  <Card title="All MCP tools" icon="robot" href="/mcp/tools/overview">
    Browse the full tool reference by category.
  </Card>
  <Card title="Connect a client" icon="plug" href="/mcp/connect">
    Point Claude, Cursor, or Claude Code at the server.
  </Card>
</Columns>