Skip to main content
Calls the dedicated GetAgent RPC and returns the authorized agent record with its stored generation. Use this tool for identity-based agent reads; do not construct a storage name for catalog_get.

Parameters

Off a VM, provide an agent target. Both login and subject owner spellings are supported. This read-only tool is available through local stdio and hosted MCP.

Example

The result contains agent and generation. The returned agent.agentId is the recorded execution identity, which can retain a historical login spelling. A missing exact key or record returns NOT_FOUND; denied access returns PERMISSION_DENIED. No other storage address is guessed.