Tunnels

The tunnel command exposes your local MCP gateway via a public URL, useful for remote access or sharing with teammates.

Basic Usage

routermcp tunnel

This starts an interactive wizard to select a tunnel provider.

Available Providers

Cloudflare Tunnel

brew install cloudflared

routermcp tunnel --tunnel=cloudflare

routermcp tunnel --tunnel=cloudflare --port 8080

ngrok Tunnel

ngrok config add-authtoken YOUR_TOKEN

routermcp tunnel --tunnel=ngrok

Configuration

Custom Port

Specify the port via command line:

routermcp tunnel --port 8080

Or configure in routermcp.jsonc:

{
  "httpServer": {
    "port": 8080
  },
  "mcpServers": {
    // ... servers
  }
}

Tunnel Output

When a tunnel is established, you'll see:

Tunnel established!
  MCP Gateway URL: https://your-tunnel-url.com/mcp
  Use this URL in your MCP client configuration

CLI Options

Use Cases

Remote Development

Access your local MCP tools from a remote machine:

1. Start the tunnel on your local machine
2. Configure the tunnel URL in your remote MCP client
3. Tools run locally but are accessible remotely

Team Sharing

Share your MCP setup with teammates:

1. Start a tunnel to your configured gateway
2. Share the tunnel URL with your team
3. Multiple people can connect to your running tools

Testing Cloud Integrations

Test MCP integrations that require a public URL:

1. Start a tunnel
2. Configure the tunnel URL as a webhook endpoint
3. Receive events from external services