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://murmur.example.com/github_app/acme/task/github_app%2Facme%2Fw%2Fbackend%2Fgithub_oauth%2Falice%2Ffix-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
none	`resolve target: ...`: the slug cannot be resolved, for example an empty slug used off a VM.	Provide a slug when running off a VM.
none	`agent 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