# rustunnel (oci · ghcr.io/joaoh82/rustunnel-mcp:0.8.5)

Give AI agents public HTTPS/TCP/UDP URLs for any localhost service. Open source, self-hostable.

- Trust score: 48/100 (low)
- Change this week: +3
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-09-20

## Components

- mcpb · `rustunnel-mcp-aarch64-apple-darwin.mcpb`: 14/100, [markdown](https://verifymcp.io/servers/joaoh82-rustunnel/https-github-com-joaoh82-rustunnel-releases-download-v0-8-5-rustunnel-mcp-aarch6.md), [page](https://verifymcp.io/servers/joaoh82-rustunnel/https-github-com-joaoh82-rustunnel-releases-download-v0-8-5-rustunnel-mcp-aarch6)
- mcpb · `rustunnel-mcp-aarch64-unknown-linux-gnu.mcpb`: 14/100, [markdown](https://verifymcp.io/servers/joaoh82-rustunnel/https-github-com-joaoh82-rustunnel-releases-download-v0-8-5-rustunnel-mcp-aarch6-2.md), [page](https://verifymcp.io/servers/joaoh82-rustunnel/https-github-com-joaoh82-rustunnel-releases-download-v0-8-5-rustunnel-mcp-aarch6-2)
- mcpb · `rustunnel-mcp-x86_64-apple-darwin.mcpb`: 14/100, [markdown](https://verifymcp.io/servers/joaoh82-rustunnel/https-github-com-joaoh82-rustunnel-releases-download-v0-8-5-rustunnel-mcp-x86-64.md), [page](https://verifymcp.io/servers/joaoh82-rustunnel/https-github-com-joaoh82-rustunnel-releases-download-v0-8-5-rustunnel-mcp-x86-64)
- mcpb · `rustunnel-mcp-x86_64-pc-windows-msvc.mcpb`: 14/100, [markdown](https://verifymcp.io/servers/joaoh82-rustunnel/https-github-com-joaoh82-rustunnel-releases-download-v0-8-5-rustunnel-mcp-x86-64-2.md), [page](https://verifymcp.io/servers/joaoh82-rustunnel/https-github-com-joaoh82-rustunnel-releases-download-v0-8-5-rustunnel-mcp-x86-64-2)
- mcpb · `rustunnel-mcp-x86_64-unknown-linux-musl.mcpb`: 14/100, [markdown](https://verifymcp.io/servers/joaoh82-rustunnel/https-github-com-joaoh82-rustunnel-releases-download-v0-8-5-rustunnel-mcp-x86-64-3.md), [page](https://verifymcp.io/servers/joaoh82-rustunnel/https-github-com-joaoh82-rustunnel-releases-download-v0-8-5-rustunnel-mcp-x86-64-3)
- oci · `ghcr.io/joaoh82/rustunnel-mcp:0.8.5`: 48/100 (this document), [markdown](https://verifymcp.io/servers/joaoh82-rustunnel/ghcr-io-joaoh82-rustunnel-mcp-0-8-5.md), [page](https://verifymcp.io/servers/joaoh82-rustunnel/ghcr-io-joaoh82-rustunnel-mcp-0-8-5)

## Channel facts

- Registry: `oci`
- Package: `ghcr.io/joaoh82/rustunnel-mcp:0.8.5`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-09-20.

- **Supply Chain Security**: 0/100
  - Malware scan not yet available for this package.
  - Known CVEs could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.
  - Install-script risk not yet assessed.
  - Dependency health could not be checked: this artifact ships no SBOM, so there is no dependency list to read. Publishing one would let us assess it.
- **Provenance & Transparency**: 48/100
  - Source repository is publicly reachable at the declared URL.
  - Provenance check failed: no build-provenance attestation is published.
  - Clear OSI-approved license (AGPL-3.0).
  - Actively maintained (last published 16 days ago).
  - Publishes a security disclosure policy (SECURITY.md).
- **Schema Quality & AI Usability**: 69/100
  - AI-judged instruction clarity (excellent).
  - Context-footprint check failed: tool/resource definitions use about 1191 tokens (~198/item across 6 items; 6 tools + 0 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 57/100
  - Stability observed for 17 of 30 days with no destabilising changes; credit accrues until the full window elapses.
- **Tool Coverage**: 100/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 100% of tool parameters carry a description.
- **Tool Safety**: 100/100
  - No prompt-injection markers were found in the server instructions, tool names or descriptions we captured.
  - We read all 6 captured tool definition(s), and no name or description among them implies an irreversible operation.
  - An AI judge read all 6 captured unit(s) of tool text and found none that tries to manipulate the model reading it.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### How do I install the rustunnel MCP server?

rustunnel runs locally as a container image, launched with docker run --rm -i ghcr.io/joaoh82/rustunnel-mcp:0.8.5. Ready-made configuration for Claude, Cursor, VS Code, Codex and 3 more is on this page, copied from each client's own documentation.

### Claude

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

### Cursor

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

### VS Code

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

### Codex

```bash
codex mcp add joaoh82-rustunnel -- docker run --rm -i ghcr.io/joaoh82/rustunnel-mcp:0.8.5
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "joaoh82-rustunnel": {
      "type": "local",
      "command": [
        "docker",
        "run",
        "--rm",
        "-i",
        "ghcr.io/joaoh82/rustunnel-mcp:0.8.5"
      ],
      "enabled": true
    }
  }
}
```

### Hermes

```yaml
mcp_servers:
  joaoh82-rustunnel:
    command: "docker"
    args: ["run", "--rm", "-i", "ghcr.io/joaoh82/rustunnel-mcp:0.8.5"]
```

### Netclaw

```json
{
  "McpServers": {
    "joaoh82-rustunnel": {
      "Transport": "stdio",
      "Command": "docker",
      "Arguments": [
        "run",
        "--rm",
        "-i",
        "ghcr.io/joaoh82/rustunnel-mcp:0.8.5"
      ]
    }
  }
}
```

### Other

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

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-09-20 (score 48, +1)

No change was recorded against any check on this day. Stability & Change Management went from 53 to 57. That category is still filling its 30-day observation window: 16 days of observed history at the previous scan, 17 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-17 (score 47, +1)

No change was recorded against any check on this day. Stability & Change Management went from 43 to 47. That category is still filling its 30-day observation window: 13 days of observed history at the previous scan, 14 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-15 (score 46, +1)

No change was recorded against any check on this day. Stability & Change Management went from 37 to 40. That category is still filling its 30-day observation window: 11 days of observed history at the previous scan, 12 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-13 (score 45, +1)

No change was recorded against any check on this day. Stability & Change Management went from 30 to 33. That category is still filling its 30-day observation window: 9 days of observed history at the previous scan, 10 at this one. The score rises as the window fills, whether or not the server changes.

### 2026-09-11 (score 44, +4)

- [functional improvement] Stability: unverified → 0.27

### 2026-09-05 (score 40, +1)

- [functional improvement] Security disclosure: fail → pass

### 2026-09-03 (score 39)

First indexed and scored.

## MCP tools (6)

### `create_tunnel` (~547 tokens)

Open a tunnel to a locally running service and get a public URL. Use this when the user or task needs a public URL for a service running locally — webhook testing, sharing a dev server, or letting another agent or device reach localhost. Spawns the rustunnel CLI as a subprocess — the tunnel stays open until close_tunnel is called or the MCP server exits.

Modes:
\- protocol='http'  → public https:// URL (web/API services)
\- protocol='tcp'   → public host:port (databases, SSH, raw TCP)
\- protocol='udp'   → public host:port (game servers, DNS)
\- protocol='p2p'   → peer-to-peer; requires `secret` plus `peer_name` (to publish) or `peer_target` (to connect)
\- load balancing   → set `group` + `group_key` (http/tcp only) to join this tunnel into a load-balanced pool; add `health_check` to auto-remove sick backends.

The token may be omitted if RUSTUNNEL_TOKEN is configured.

Input parameters:

- `group` (string): Load-balancing pool name. Tunnels sharing the same (group, group_key) form one pool (http/tcp only).
- `group_key` (string): Shared secret for the load-balancing group. Members of one pool must agree on this value.
- `health_check` (object): Optional client-side health probe. The client probes the local service and reports health so the server routes around a sick backend. Only meaningful for load-balanced tunnels (group set).
- `local_host` (string): Local hostname to forward to (default 'localhost'). Use to expose a service on another host in your network.
- `local_port` (integer, required): Local port the service is listening on, e.g. 3000
- `peer_name` (string): P2P publisher mode: publish the local service under this name.
- `peer_target` (string): P2P subscriber mode: connect to a published P2P tunnel with this name.
- `protocol` (string, required): Tunnel type
- `region` (string): Region ID (e.g. 'eu', 'us', 'ap'). Omit to auto-select the nearest by latency. Use list_regions to see options.
- `secret` (string): Shared secret for P2P (protocol='p2p'). Publisher and subscriber must use the same value.
- `subdomain` (string): Custom subdomain (HTTP tunnels only). Server assigns a random one if omitted.
- `token` (string): API token. Optional if RUSTUNNEL_TOKEN is set in the MCP client config.

### `list_tunnels` (~87 tokens)

List all tunnels currently open on this server. Returns the public URL, protocol, and traffic count for each active tunnel. Use this when you need to check whether a tunnel is still running, recover the public URL of an existing tunnel, or find a tunnel_id to pass to close_tunnel.

Input parameters:

- `token` (string): API token. Optional if RUSTUNNEL_TOKEN is set.

### `close_tunnel` (~97 tokens)

Force-close a specific tunnel by its ID. The public URL stops working immediately. Use this when a tunnel is no longer needed or public access must be revoked right away — e.g. after a webhook test or demo finishes. Use list_tunnels to find the tunnel_id.

Input parameters:

- `token` (string): API token. Optional if RUSTUNNEL_TOKEN is set.
- `tunnel_id` (string, required): UUID of the tunnel to close

### `get_connection_info` (~313 tokens)

Get the CLI command (and, for load-balanced tunnels, a config file) needed to create a tunnel manually — without spawning anything. Use this when the MCP server cannot spawn subprocesses (e.g. cloud sandbox), when the tunnel must outlive the MCP server, or when you prefer to run the client yourself. Accepts the same arguments as create_tunnel.

Input parameters:

- `group` (string): Load-balancing pool name (http/tcp only)
- `group_key` (string): Shared secret for the load-balancing group
- `health_check` (object): Optional client-side health probe. The client probes the local service and reports health so the server routes around a sick backend. Only meaningful for load-balanced tunnels (group set).
- `local_host` (string): Local hostname to forward to (default 'localhost')
- `local_port` (integer, required): Local port the service is listening on
- `peer_name` (string): P2P publisher mode: publish under this name
- `peer_target` (string): P2P subscriber mode: connect to this name
- `protocol` (string, required): Tunnel type
- `region` (string): Region ID (e.g. 'eu', 'us', 'ap'). Omit to auto-select.
- `secret` (string): Shared secret for P2P (protocol='p2p')
- `subdomain` (string): Custom subdomain (HTTP only)
- `token` (string): API token. Optional if RUSTUNNEL_TOKEN is set.

### `list_regions` (~49 tokens)

List available tunnel server regions with their IDs, names, and locations. Use this when you need to pick a specific `region` for create_tunnel or check which edge locations exist. No authentication required.

### `get_tunnel_history` (~98 tokens)

Retrieve the history of past tunnels, including their duration and which token opened them. Use this when auditing past tunnel activity or debugging why a tunnel dropped or is no longer listed by list_tunnels.

Input parameters:

- `limit` (integer): Maximum number of entries to return
- `protocol` (string): Optional: filter by protocol. Omit for all.
- `token` (string): API token. Optional if RUSTUNNEL_TOKEN is set.

## Diagnostics

Captured diagnostic sections: Provenance. The full working is on the page: https://verifymcp.io/servers/joaoh82-rustunnel/ghcr-io-joaoh82-rustunnel-mcp-0-8-5#diagnostics

## Score history

- 2026-09-20: 48
- 2026-09-19: 47
- 2026-09-18: 47
- 2026-09-17: 47
- 2026-09-16: 46
- 2026-09-15: 46
- 2026-09-14: 45
- 2026-09-13: 45
- 2026-09-12: 44
- 2026-09-11: 44
- 2026-09-10: 40
- 2026-09-09: 40
- 2026-09-08: 40
- 2026-09-07: 40
- 2026-09-06: 40
- 2026-09-05: 40
- 2026-09-04: 39
- 2026-09-03: 39

## Common questions

### What is the rustunnel MCP server?

rustunnel is an MCP server listed in the public MCP registry as io.github.joaoh82/rustunnel. Give AI agents public HTTPS/TCP/UDP URLs for any localhost service. Open source, self-hostable. This page covers its container image (ghcr.io/joaoh82/rustunnel-mcp:0.8.5).

### Is the rustunnel MCP server safe to use?

rustunnel scores 48 out of 100 on VerifyMCP. That is a record of what we were able to check automatically, not an endorsement. The category breakdown on this page shows every signal behind the number, including the ones we could not confirm.

### What tools does the rustunnel MCP server expose?

rustunnel exposes 6 tools: create_tunnel, list_tunnels, close_tunnel, get_connection_info, list_regions, get_tunnel_history. Their descriptions and schemas cost roughly 1,191 tokens of context every time the server is loaded.

### Is the rustunnel MCP server still maintained?

rustunnel is still listed as active in the MCP registry. We last reached this channel on 20 September 2026. Those dates come from our own scans of the registry and the channel itself, not from anything the publisher announced.

### What licence is the rustunnel MCP server under?

rustunnel declares the AGPL-3.0 licence, which is OSI-approved. That covers the source only, and says nothing about the cost of any service it calls.

## Links

- Repository: https://github.com/joaoh82/rustunnel
- Website: https://rustunnel.com/
- Changelog RSS feed: https://verifymcp.io/servers/joaoh82-rustunnel/ghcr-io-joaoh82-rustunnel-mcp-0-8-5.xml
- Changelog JSON feed: https://verifymcp.io/servers/joaoh82-rustunnel/ghcr-io-joaoh82-rustunnel-mcp-0-8-5.json
- HTML version of this page: https://verifymcp.io/servers/joaoh82-rustunnel/ghcr-io-joaoh82-rustunnel-mcp-0-8-5