> ## 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_url

> MCP tool that returns the dashboard URL for an agent so coding agents can link humans to the timeline, artifacts, and live status view.

Returns the murmur-ui dashboard URL for an [agent](/concepts/agents). Use this to share a direct link to an agent's detail view in the browser.

Equivalent to [`murmur url agent`](/cli/url-agent) in the CLI.

All normal slug semantics apply: empty slug means self (on VMs), relative slugs resolve under the current agent, and absolute paths like `/u/account/slug` or `/w/workspace/u/account/slug` target any agent.

## Parameters

| Name        | Type   | Required | Description                                                                                                              |
| ----------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------------ |
| `slug`      | string | no       | Agent task slug. Empty means self (on VMs). Use an absolute path like `/w/workspace/u/account/slug` to target any agent. |
| `workspace` | string | no       | Workspace name. Overrides the session default.                                                                           |

## Response

Returns the dashboard URL as a plain string.

## Examples

### Get own dashboard URL

```json theme={null}
{}
```

Response:

```
https://app.murmur.dev/agent/github%7Calice/backend/fix-auth
```

### Get URL for another agent

```json theme={null}
{
  "slug": "fix-auth"
}
```

### Get URL using absolute path

```json theme={null}
{
  "slug": "/w/backend/u/bob/api-refactor"
}
```

## Errors

| Code               | Meaning                                                          | What to do                          |
| ------------------ | ---------------------------------------------------------------- | ----------------------------------- |
| `INVALID_ARGUMENT` | Cannot resolve slug — empty slug used off-VM, or invalid format. | Provide a slug when running off-VM. |
| `INTERNAL`         | Dashboard URL not available (`public_url` missing from config).  | Contact your administrator.         |
| `UNAUTHENTICATED`  | Identity token is missing or expired.                            | Check credentials.                  |

## Related

* [`murmur url agent`](/cli/url-agent) — equivalent CLI command
* [`port_url`](/mcp-server/port-url) — get a tunnel URL for a VM port
* [`status`](/mcp-server/status) — check agent state
* [`ls`](/mcp-server/ls) — list running agents