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
agentId	string	no	Filter by agent public ID
traceId	string	no	Filter by trace public ID
initiatorGenerationId	string	no	Filter by the public ID of the parent generation. Returns all generations triggered by that generation — sub-agent invocations. Null-initiated (top-level) generations are not returned.
status	string	no	Filter by lifecycle status
limit	number	no	—
offset	number	no	—

get-generation

Get a generation

Arguments

Argument	Type	Required	Description
generationId	string	yes	Public ID of the generation

update-generation

Update generation metadata

Arguments

Argument	Type	Required	Description
generationId	string	yes	Public ID of the generation
metadata	object	yes	Caller-supplied key/value metadata to shallow-merge into the generation record. Reserved server-owned keys (action_id, trigger_id, run_id, node_id, extraction, and internal recovery state) are rejected with 400.