# rustunnel

> rustunnel is a freemium MCP server for developer tools. Give agents public HTTPS, TCP or UDP URLs for local services with a self-hostable tunnel. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Starting price:** $3 a month
- **Platforms:** CLI, self-hosted, Linux, macOS, Windows
- **Website:** https://rustunnel.com
- **Repository:** https://github.com/joaoh82/rustunnel
- **MCP Registry name:** io.github.joaoh82/rustunnel
- **Categories:** developer tools, cloud and infrastructure
- **Listing updated:** 2026-11-14

## About

rustunnel is an open-source tunnel written in Rust, and this server lets an agent create, manage and close tunnels in plain language. It supports HTTP, TCP and UDP tunnels, custom subdomains, regions, peer-to-peer links and load-balanced pools with health checks.

The tunnel itself uses encrypted multiplexed connections with automatic Let's Encrypt TLS for generated endpoints. Every session also opens a local web inspector on 127.0.0.1:4040 with headers, bodies and replay, and a terminal dashboard. Hosted edge regions are in Helsinki, Hillsboro and Singapore, and the client picks the nearest.

The MCP server runs over stdio and is shipped as .mcpb bundles for macOS, Linux and Windows, plus a container image. It needs an API token in RUSTUNNEL_TOKEN. The site lists Claude Code, Claude Desktop, Codex, Cursor, Windsurf and Cline as working clients.

## Features

- **HTTP, TCP and UDP tunnels:** Expose different kinds of local services.
- **Custom subdomains:** Available on pay-as-you-go and self-hosted setups.
- **Load-balanced pools:** Several backends behind one subdomain or port with TCP or HTTP health probes.
- **Peer-to-peer tunnels:** NAT hole punching over QUIC with relay fallback.
- **Request inspector:** Local web view with replay of requests.
- **Self-host option:** Run the same server yourself under AGPL.

## Good for

- Share a local app for review
- Test webhooks against localhost
- Let an agent open an SSH or TCP port temporarily
- Run a hot-spare backend behind one address

## Install

### Claude Code (Terminal)

```sh
claude mcp add rustunnel -- docker run -i --rm ghcr.io/joaoh82/rustunnel-mcp:0.8.9
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "rustunnel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/joaoh82/rustunnel-mcp:0.8.9"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "rustunnel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/joaoh82/rustunnel-mcp:0.8.9"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "rustunnel": {
      "type": "stdio",
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/joaoh82/rustunnel-mcp:0.8.9"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "rustunnel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/joaoh82/rustunnel-mcp:0.8.9"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "rustunnel": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "ghcr.io/joaoh82/rustunnel-mcp:0.8.9"
      ]
    }
  }
}
```

## FAQ

### How is the hosted service priced?

The site says pay as you go from $3 a month, with the minimum credited to usage and idle time free. Self-hosting is free under AGPL.

### How do I authenticate?

Get an API key and set RUSTUNNEL_TOKEN.

### Which clients work?

Claude Code, Claude Desktop, Codex, Cursor, Windsurf, Cline and custom agents.

### Where are the edge servers?

Helsinki, Hillsboro and Singapore.

### Is rustunnel free?

rustunnel has a free plan, with paid plans for more usage or features. Paid plans start at $3 a month.

### How do I add rustunnel to Claude Code?

Run this command in your terminal: claude mcp add rustunnel -- docker run -i --rm ghcr.io/joaoh82/rustunnel-mcp:0.8.9

### What are the best alternatives to rustunnel?

The closest alternatives to rustunnel are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/rustunnel
