Skip to main content

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.

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

NameTypeRequiredDescription
portintegeryesTCP 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

CodeMeaningWhat to do
INVALID_ARGUMENTPort is outside the valid range (1-65535).Use a valid port number.
FAILED_PRECONDITIONMURMUR_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.
INTERNALPort 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