agent_url MCP tool

Returns the murmur-ui dashboard URL for an agent. Use this to share a direct link to an agent’s detail view in the browser. Equivalent to murmur 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 /github_oauth/alice/fix-auth or /w/backend/github_oauth/alice/fix-auth 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}/{owner_provider}/{account}/{slug}` (e.g. `/w/backend/github_oauth/alice/fix-auth`) to target any agent.
`workspace`	string	no	Workspace name. Overrides the session default. Required only when nothing else supplies one: off a VM, with no session default, and with a slug that is not a `/w/{workspace}/...` path.

Response

Returns the dashboard URL as a plain string.

Examples

Get own dashboard URL

{}

Response:

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

Get URL for another agent

{
  "slug": "fix-auth"
}

Get URL using absolute path

{
  "slug": "/w/backend/github_oauth/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.

murmur url agent — equivalent CLI command
port_url — get a tunnel URL for a VM port
status — check agent state
ls — list running agents

Getting Started

Core Concepts

Guides

agent_url MCP tool

Parameters

Response

Examples

Get own dashboard URL

Get URL for another agent

Get URL using absolute path

Errors

​Parameters

​Response

​Examples

​Get own dashboard URL

​Get URL for another agent

​Get URL using absolute path

​Errors

​Related

Parameters

Response

Examples

Get own dashboard URL

Get URL for another agent

Get URL using absolute path

Errors

Related