port_url - Murmur

Returns a public URL that tunnels to a TCP port on the agent’s VM, accessible from the internet. Use this to share links to services running locally on the VM (e.g. embed a preview URL in a PR description). Equivalent to murmur url port in the CLI. This tool is only available on VMs. It requires the MURMUR_WORKFLOW_ID environment variable to be set, which is automatically configured on agent VMs.

Parameters

Name	Type	Required	Description
`port`	integer	yes	TCP port number (1-65535). The port must be listening on the VM.

Response

Returns the public HTTPS tunnel URL as a plain string.

Examples

Get URL for a dev server

{
  "port": 3000
}

Response:

https://port-a1b2c3d4-3000.murmur.dev

Get URL for a database admin UI

{
  "port": 8080
}

Errors

Code	Meaning	What to do
`INVALID_ARGUMENT`	Port is outside the valid range (1-65535).	Use a valid port number.
`FAILED_PRECONDITION`	`MURMUR_WORKFLOW_ID` not set — tool must run on a VM.	This tool is VM-only. It cannot be used from the CLI or off-VM MCP sessions.
`INTERNAL`	Port proxy not configured (`public_url` missing).	Contact your administrator.

murmur url port — equivalent CLI command
upload — upload a static file instead of sharing a live port
agent_url — get the dashboard URL for an agent

upload agent_url

⌘I

​Parameters

​Response

​Examples

​Get URL for a dev server

​Get URL for a database admin UI

​Errors

​Related