port_url

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. The hosted MCP endpoint does not expose it.

Parameters

Name	Type	Required	Description
`port`	number	yes	TCP port number (e.g. `3000`). Must be a whole number from 1 to 65535. The tool does not check that anything is listening on the port.

Response

Returns the public tunnel URL as a plain string. The host has the form {provider}-{org}-{short_id}-{port}.port.{host}, and the agent’s slug is appended as an ?agent= query parameter.

Examples

Get URL for a dev server

{
  "port": 3000
}

Response:

https://github_app-acme-a1b2c3d4e5f6-3000.port.murmur.example.com/?agent=fix-auth

Get URL for a database admin UI

{
  "port": 8080
}

Errors

Code	Meaning	What to do
none	`invalid port <n>`: the port is outside 1-65535.	Use a valid port number.
none	`MURMUR_WORKFLOW_ID not set — port_url must run on a VM`.	This tool is VM-only. It cannot be used off-VM.
none	`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

Getting Started

Core Concepts

Guides

Parameters

Response

Examples

Get URL for a dev server

Get URL for a database admin UI

Errors

​Parameters

​Response

​Examples

​Get URL for a dev server

​Get URL for a database admin UI

​Errors

​Related

Parameters

Response

Examples

Get URL for a dev server

Get URL for a database admin UI

Errors

Related