Generations
MCP tools for the Generations module. See the Generations module docs for permissions and data model.
list-generations
List generations
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
agent_id | string | no | Filter by agent public ID |
trace_id | string | no | Filter by trace public ID |
session_id | string | no | Return only the generations dispatched through one session — the turns behind that conversation's spend. A session that does not exist in scope yields an empty page. |
actor_id | string | no | Return only the generations one end user started, across every session they appear in. An actor that does not exist in scope yields an empty page. |
initiator_generation_id | string | no | Filter by the public ID of the parent generation. Returns every generation started by that generation: sub-agent invocations, approval continuations, client-tool re-handoffs and memory-rule handler turns. Top-level generations are not returned. |
chain_id | string | no | Filter by the continuation chain the generation belongs to. This is how a chain is expanded into its members — the chain record carries only their count. |
orchestration_run_id | string | no | Filter by the orchestration run that dispatched the generation. This is how a run is traced back to what its agent nodes did — a node execution record stores no generation id. |
node_id | string | no | Filter by the orchestration node that dispatched the generation. Combine with orchestration_run_id to narrow to one node of one run; a retried node returns one generation per node_attempt. |
status | array<string> | no | Filter by lifecycle status. Repeat the parameter to OR values. A value outside the enum, empty string included, is a 400. |
limit | number | no | Results per page. Above the maximum it is clamped; below 1 or not an integer it is 400 VALIDATION_FAILED. |
cursor | string | no | The previous page's next_cursor; omit it for the first page. Send it with the same filters as the request that returned it: a malformed cursor, or one sent with other filters, is 400 INVALID_CURSOR. |
get-generation
Get a generation
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
generation_id | string | yes | Public ID of the generation |
update-generation
Update generation metadata
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
generation_id | string | yes | Public ID of the generation |
metadata | any | yes | Caller-supplied key/value metadata to shallow-merge into the generation record's caller-owned metadata bag. No key is reserved: server-owned state lives in its own top-level fields and cannot be written from here. |
purge-generation-content
Purge generation content
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
generation_id | string | yes | Public ID of the generation |
list-generation-memory-assertions
List the memory writes a generation made
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
generation_id | string | yes | Public ID of the generation |
limit | number | no | Results per page. Above the maximum it is clamped; below 1 or not an integer it is 400 VALIDATION_FAILED. |
cursor | string | no | The previous page's next_cursor; omit it for the first page. Send it with the same filters as the request that returned it: a malformed cursor, or one sent with other filters, is 400 INVALID_CURSOR. |
get-generation-transcript
Get a generation's transcript
Arguments
| Argument | Type | Required | Description |
|---|---|---|---|
generation_id | string | yes | Public ID of the generation |