Read a monitor's records
get_monitor_rowsRead the records an agent monitor follows -- one per item its answer lists, e.g. each plan of a pricing page -- as they stand, with the page each value was read on; and, with changes=true, what moved: records added, a column changed (before and after), records gone. Use it for a monitor made with follow_rows=true, to answer what changed or what the list is now. list_monitors shows a run's summary; this is the record-level detail. Inputs: monitor_id from list_monitors. active=false lists the records gone instead. q keeps records holding it. limit is 1 to 500 (100 by default). Read-only and free: it reads stored data and never fetches.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"monitor_id": "<monitor_id>"
},
"name": "get_monitor_rows"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Keep records holding this text. | |
| limit | No | The most records to return, 1 to 500. | |
| active | No | true (default) lists the records as they stand; false the records gone. | |
| changes | No | true also returns what moved, newest first, at most 50. | |
| monitor_id | Yes | The monitor's id, from list_monitors or create_monitor. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| code | No | Only on a failure: a machine-readable reason, e.g. read_only, validation, plan_limit or not_found. | |
| note | No | What was left out and how to get it. | |
| rows | No | The records as they stand, each {key, attrs (its columns), sources (the page each was read on), url, active, withheld, firstSeen, lastSeen}, at most `limit`. | |
| error | No | Only when the call failed: what went wrong, in words an assistant can act on. | |
| total | No | How many records match, whatever `limit` returned. | |
| detail | No | Only on a failure: the API's own wording, when the error was rephrased. | |
| events | No | With changes=true: what moved, newest first -- records added, a column changed (before and after), records gone or withheld -- at most 50. | |
| status | No | Only on a failure: the HTTP status code. | |
| monitor_id | No | The monitor read. |