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 all generations triggered by that generation — sub-agent invocations. Null-initiated (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	string	no	Filter by lifecycle status
limit	number	no	—
offset	number	no	—

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	object	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

get-generation-transcript

Get a generation's transcript

Arguments

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