How do I install the Ngrok Tunnel skill?

Run npx skillmds@latest add tomevault-io/ngrok-tunnel in your terminal (requires Node.js), paste this page's agent-chat prompt into Claude, Cursor, or any MCP-connected agent, or download the SKILL.md file and copy it into your agent's skills directory.

Is Ngrok Tunnel safe to use?

This skill has not completed SkillMD's automated safety review yet. Independent scanners report: SkillSpector: PASS, Skill Scanner: PASS. SkillMD never runs a skill's scripts for you; review the SKILL.md before installing.

Which AI agents work with Ngrok Tunnel?

This skill is tagged as working with Claude Code, Claude.ai, OpenAI Codex. SKILL.md is an open format, so most agents that read a skills directory can load it too.

Is Ngrok Tunnel free to use?

Yes. Installing skills from SkillMD is free, and the skill stays under its author's original license.

Who published Ngrok Tunnel?

tomevault-io (@tomevault-io) published this skill. Their other Agent Skills are listed on their SkillMD profile.

Ngrok Tunnel by tomevault-io — Agent Skill

Name: Ngrok Tunnel
Author: tomevault-io

File contents

ngrok Tunnel Skill

Trit: +1 (PLUS - enables external connectivity)
Foundation: ngrok + WireGuard-style tunneling + Traffic Policies

Core Concept

ngrok creates secure tunnels from localhost to public endpoints:

HTTPS with automatic TLS certificates
Custom domains (paid plans)
IP whitelisting for Claude/Anthropic
Traffic policies for access control
Real-time request inspection

Quick Start

# Install (macOS)
brew install ngrok

# Authenticate
ngrok config add-authtoken YOUR_TOKEN

# Expose local MCP server
ngrok http 3000

# With custom domain (paid)
ngrok http --url=your-domain.ngrok.io 3000

MCP Server Exposure

# Start your MCP server
bun run mcp-server --port 8080

# Expose via ngrok
ngrok http 8080

# Copy the HTTPS URL (e.g., https://abc123.ngrok.io)
# Register in Claude Settings → Integrations → Add more

Traffic Policy: Claude-Only Access

Create policy.yml:

on_http_request:
  - actions:
      - type: restrict-ips
        config:
          enforce: true
          allow:
            - 160.79.104.0/23  # Anthropic IP range

Apply:

ngrok http 8080 --traffic-policy-file policy.yml

Custom Domain Setup

# Reserve domain in ngrok dashboard first
ngrok http --url=mcp.yourdomain.com 8080

# With traffic policy
ngrok http --url=mcp.yourdomain.com --traffic-policy-file policy.yml 8080

vers-agent Integration

# Expose vers-agent server for remote access
vers-agent --server --port 8765 &
ngrok http 8765

# Remote clients connect via ngrok URL
vers-agent --remote https://abc123.ngrok.io

GF(3) Integration

def trit_from_tunnel(tunnel):
    """Map tunnel status to GF(3) trit."""
    if tunnel.status == "online" and tunnel.has_custom_domain:
        return 1   # PLUS: full connectivity
    elif tunnel.status == "online":
        return 0   # ERGODIC: basic tunnel
    else:
        return -1  # MINUS: offline/error

Canonical Triads

skill-validation-gf3 (-1) ⊗ tailscale-mesh (0) ⊗ ngrok-tunnel (+1) = 0 ✓
bisimulation-game (-1) ⊗ localsend-mcp (0) ⊗ ngrok-tunnel (+1) = 0 ✓

Composio MCP Integration

For AI agent automation, use Composio's ngrok MCP:

https://mcp.composio.dev/ngrok
9+ tools for tunnel management
Works with Claude, Cursor, Windsurf

ToolHive Integration

# Expose ToolHive-managed MCP servers
thv proxy tunnel --server my-mcp-server

References

Converted and distributed by TomeVault — claim your Tome and manage your conversions.

---name: ngrok-tunneldescription: Secure tunnel for exposing local MCP servers to Claude, remote agents, and external clients. Supports custom domains, IP whitelisting, and traffic policies. Use when this capability is needed.---# ngrok Tunnel Skill**Trit**: +1 (PLUS - enables external connectivity) **Foundation**: ngrok + WireGuard-style tunneling + Traffic Policies ## Core Conceptngrok creates secure tunnels from localhost to public endpoints:- HTTPS with automatic TLS certificates- Custom domains (paid plans)- IP whitelisting for Claude/Anthropic- Traffic policies for access control- Real-time request inspection## Quick Start```bash# Install (macOS)brew install ngrok# Authenticatengrok config add-authtoken YOUR_TOKEN# Expose local MCP serverngrok http 3000# With custom domain (paid)ngrok http --url=your-domain.ngrok.io 3000```## MCP Server Exposure```bash# Start your MCP serverbun run mcp-server --port 8080# Expose via ngrokngrok http 8080# Copy the HTTPS URL (e.g., https://abc123.ngrok.io)# Register in Claude Settings → Integrations → Add more```## Traffic Policy: Claude-Only AccessCreate `policy.yml`:```yamlon_http_request: - actions: - type: restrict-ips config: enforce: true allow: - 160.79.104.0/23 # Anthropic IP range```Apply:```bashngrok http 8080 --traffic-policy-file policy.yml```## Custom Domain Setup```bash# Reserve domain in ngrok dashboard firstngrok http --url=mcp.yourdomain.com 8080# With traffic policyngrok http --url=mcp.yourdomain.com --traffic-policy-file policy.yml 8080```## vers-agent Integration```bash# Expose vers-agent server for remote accessvers-agent --server --port 8765 &ngrok http 8765# Remote clients connect via ngrok URLvers-agent --remote https://abc123.ngrok.io```## GF(3) Integration```pythondef trit_from_tunnel(tunnel): """Map tunnel status to GF(3) trit.""" if tunnel.status == "online" and tunnel.has_custom_domain: return 1 # PLUS: full connectivity elif tunnel.status == "online": return 0 # ERGODIC: basic tunnel else: return -1 # MINUS: offline/error```## Canonical Triads```skill-validation-gf3 (-1) ⊗ tailscale-mesh (0) ⊗ ngrok-tunnel (+1) = 0 ✓bisimulation-game (-1) ⊗ localsend-mcp (0) ⊗ ngrok-tunnel (+1) = 0 ✓```## Composio MCP IntegrationFor AI agent automation, use Composio's ngrok MCP:- https://mcp.composio.dev/ngrok- 9+ tools for tunnel management- Works with Claude, Cursor, Windsurf## ToolHive Integration```bash# Expose ToolHive-managed MCP serversthv proxy tunnel --server my-mcp-server```## See Also- `tailscale-mesh` - WireGuard mesh VPN- `tailscale-file-transfer` - P2P file transfer- `localsend-mcp` - Local network P2P- `mcp-builder` - MCP server creation guide## References- [ngrok MCP Docs](https://ngrok.com/docs/using-ngrok-with/using-mcp)- [Claude Remote MCP](https://support.anthropic.com/en/articles/11175166-about-custom-integrations-using-remote-mcp)- [ToolHive + ngrok](https://toolhive.dev)---> Converted and distributed by [TomeVault](https://tomevault.io/claim/plurigrid) — claim your Tome and manage your conversions.

Frequently asked questions

Ngrok Tunnel