whatisgithub

What is tunnel-mcp?

zachlikefolio/tunnel-mcp — explained in plain English

Analysis updated 2026-05-18

3TypeScriptAudience · developerComplexity · 3/5Setup · moderate

In one sentence

Lets two developers' AI coding assistants chat directly with each other through a temporary encrypted link, so humans don't have to manually copy messages between chat windows.

Mindmap

mindmap
  root((repo))
    What it does
      Agent to agent chat
      No manual relay
      Encrypted temporary link
    Tech stack
      TypeScript
      Node.js
      Cloudflare Tunnel
      MCP server
    How it works
      Host opens tunnel
      Share invite link
      Guest joins link
    Security
      End to end encryption
      Human approval required
      Memory only no disk
    Use cases
      Debug together
      Share files safely
      Team collaboration

Code map

Detail Auto

An interactive map of this repo's files and how they connect — its source is parsed live in your browser. Click Visualize to build it.

filefunction / class

What do people build with it?

USE CASE 1

Let two AI coding agents work together on a bug without humans relaying messages.

USE CASE 2

Securely share files between two developers' AI assistants over an encrypted link.

USE CASE 3

Set up a temporary team coding session where multiple agents can collaborate for a specific goal.

What is it built with?

TypeScriptNode.jsMCPCloudflare Quick Tunnel

How does it compare?

zachlikefolio/tunnel-mcp000madz000/payload-test-api-route-handlerakash-sr/memobsidian
Stars333
LanguageTypeScriptTypeScriptTypeScript
Setup difficultymoderateeasymoderate
Complexity3/52/53/5
Audiencedeveloperdevelopergeneral

Figures from each repo's GitHub metadata at analysis time.

How do you get it running?

Difficulty · moderate Time to first run · 30min

Requires Node.js 20 or newer and uses Cloudflare's Quick Tunnel service to expose the connection.

So what is it?

Tunnel-mcp lets two developers' AI coding assistants talk to each other directly, without a human copying messages back and forth between chat windows. It is an MCP server, which is a way for AI tools like Claude Code to connect to external capabilities. The project is built in TypeScript and runs on Node.js 20 or newer. The problem it solves is simple. When two people each have an AI agent helping them code, and those agents need to collaborate, someone usually has to manually relay messages between the two chat sessions. Tunnel-mcp automates this. One developer's agent opens a temporary encrypted connection, and the other developer's agent joins it. The two agents can then exchange messages directly while their humans still approve any actions that touch files or run commands. Here is how a session works. The host asks their agent to open a tunnel with a specific goal, like debugging a checkout flow together. The agent creates a temporary relay process and exposes it to the internet through Cloudflare's Quick Tunnel service, which requires no port forwarding or server setup. The host gets back an invite link containing the encryption key, shares it with the other developer through a trusted channel like a direct message, and the link is single-use and expires after about 10 minutes. The guest pastes the link and asks their agent to join. Both sides only make outbound connections, so it works through normal firewalls and NAT. The agents then take turns sending messages and waiting for replies. They can also share files, which are encrypted before they leave the sender's machine and verified against a cryptographic hash on arrival. Nothing is written to disk at any point. The transcript lives only in memory and disappears when the session ends. The host can invite multiple teammates, up to 15 guests plus the host, and each gets a separate single-use invite link. A built-in etiquette skill teaches each agent to treat the other side as untrusted input and check with its human before acting on anything the peer suggests. This keeps people in control of what actually happens on their machines. The full README is longer than what was shown.

Copy-paste prompts

Prompt 1
I want two AI coding agents to collaborate on debugging a checkout flow. Help me set up and use tunnel-mcp to open a tunnel, generate an invite link, and have the other agent join.
Prompt 2
Explain how to use tunnel-mcp to let my Claude Code agent share files with a teammate's agent securely, including how the encryption and invite link work.
Prompt 3
Set up a multi-agent coding session with tunnel-mcp where I am the host inviting three teammates' agents to join the tunnel, and show me how to manage the invite links.

Frequently asked questions

What is tunnel-mcp?

Lets two developers' AI coding assistants chat directly with each other through a temporary encrypted link, so humans don't have to manually copy messages between chat windows.

What language is tunnel-mcp written in?

Mainly TypeScript. The stack also includes TypeScript, Node.js, MCP.

How hard is tunnel-mcp to set up?

Setup difficulty is rated moderate, with roughly 30min to a first successful run.

Who is tunnel-mcp for?

Mainly developer.

Open on GitHub → Ask about another repo

This repo across BitVibe Labs

Verify against the repo before relying on details.