> ## Documentation Index
> Fetch the complete documentation index at: https://docs.murmur.dev/llms.txt
> Use this file to discover all available pages before exploring further.

# agent_get

> Read a persisted agent record and its generation using an agent reference.

Calls the dedicated `GetAgent` RPC and returns the authorized [agent
record](https://docs.murmur.dev/catalog/agent.md) with its stored generation. Use this tool for identity-based
agent reads; do not construct a storage name for `catalog_get`.

## Parameters

| Name | Type | Required | Description |
| - | - | - | - |
| `slug` | string | no | Relative agent slug or absolute `/w/{workspace}/{owner_provider}/{account}/{slug}` path. Empty means self on a VM. A relative slug on a VM names a child. |
| `workspace` | string | no | Workspace name. Overrides the session default. |

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

```json theme={null}
{
  "slug": "/w/backend/github/7/fix-auth"
}
```

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.

## Related

* [`murmur agent get`](https://docs.murmur.dev/cli/agent-get): equivalent CLI command
* [`status`](https://docs.murmur.dev/mcp-server/status): live workflow state
* [Agents](https://docs.murmur.dev/concepts/agents.md): targeting and lifecycle


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.