read
Retrieve a correlated, time-ordered timeline of events matching label selectors across sources or a chosen project, optionally with full payloads for investigation.
Instructions
Read one correlated, time-ordered timeline of everything matching selector across all
sources, or only a project's sources, or only the sources you name. selector is a
{label: value} conjunction, matched with strict AND, e.g. {"repo": "frontend"} or
{"service": "api-server", "endpoint": "/login"}. An event matches only if it carries every
named label with that value, so adding a label narrows and removing one widens. Use this to
investigate any entity on the fly; once you know which sources matter, create_trigger() over
them. Set include_payload when the one-line summaries aren't enough and you need each
event's full lossless record: the return becomes JSON {timeline, events[]} where each event
carries raw. With a project key the read covers that project only, its findings
included.
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": {
"selector": "<selector>"
},
"name": "read"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| window | No | 15m | |
| project | No | ||
| sources | No | ||
| selector | Yes | ||
| include_payload | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |