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

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

- Trust score: 41/100 (low)
- Change this week: −2
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

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

## Channel facts

- Registry: `oci`
- Package: `ghcr.io/joaoh82/rustunnel-mcp:0.8.4`
- 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-08-03.

- **Supply Chain Security**: 0/100
  - Malware scan not yet available for this package.
  - CVE data not yet available for this package.
  - Install-script risk not yet assessed.
  - Dependency-health data not yet available.
- **Provenance & Transparency**: 45/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 7 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **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**: 23/100
  - Stability observed for 7 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.
- **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

### Claude

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

### Codex

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

### 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.4"
      ],
      "enabled": true
    }
  }
}
```

### Hermes

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

### Other

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

## 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-08-03 (score 41, +3)

- [functional improvement] Stability: unverified → 0.23

### 2026-07-31 (score 38, −5)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-27 (score 43, +32)

- [functional improvement] Tool coverage: unverified → 100
- [functional] First check of Schema quality: fail
- [functional] First check of Tool coverage: 100
- [functional] First check of Schema quality: excellent
- [functional] First check of Schema quality: fail

### 2026-07-26 (score 11)

First indexed and scored.

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

## 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-4#diagnostics

## Score history

- 2026-08-03: 41
- 2026-08-02: 38
- 2026-08-01: 38
- 2026-07-31: 38
- 2026-07-30: 43
- 2026-07-29: 43
- 2026-07-28: 43
- 2026-07-27: 43
- 2026-07-26: 11

## 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-4/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/joaoh82-rustunnel/ghcr-io-joaoh82-rustunnel-mcp-0-8-4/changelog.json
- HTML version of this page: https://verifymcp.io/servers/joaoh82-rustunnel/ghcr-io-joaoh82-rustunnel-mcp-0-8-4