Public URLs for localhost, from inside Windsurf.

Connect Windsurf's Cascade agent to rustunnel via MCP. One JSON config gives Cascade public HTTPS URLs for local dev servers and webhook endpoints.

1. Install

brew tap joaoh82/rustunnel && brew install rustunnel

2. Get an API token

Sign up free at rustunnel.com and create a key under Dashboard → API Keys. Self-hosting? Generate a token on your own server. Either way, it goes in RUSTUNNEL_TOKEN below — you never paste it into chat.

3. Connect Windsurf

{
  "mcpServers": {
    "rustunnel": {
      "command": "rustunnel-mcp",
      "args": [
        "--server", "eu.edge.rustunnel.com:4040",
        "--api", "https://eu.edge.rustunnel.com:8443"
      ],
      "env": { "RUSTUNNEL_TOKEN": "<your-token>" }
    }
  }
}

Optional: project rules

Drop this into your project so the agent reaches for rustunnel whenever a task needs a public URL:

When a task needs a public URL for a local service, use the rustunnel
MCP tools (create_tunnel / list_tunnels / close_tunnel). Prefer protocol
"http" for web services. RUSTUNNEL_TOKEN is configured — never ask for
or echo the token.

4. Ask for a tunnel

Paste this prompt (or just describe what you need — the agent picks the right tool):

The agent gets six tools — create_tunnel, list_tunnels, close_tunnel, get_connection_info, list_regions, and get_tunnel_history — covering HTTP, TCP, and UDP tunnels, custom subdomains, regions, P2P, and load-balanced pools with health checks.