Agent Junction

An MCP server that lets Claude Code instances communicate directly via an ephemeral, encrypted peer-to-peer message bus. Works on localhost or across your LAN.

Install

npm install -g agent-junction

The Problem

Multiple Claude Code sessions often have information the other needs — config paths, secrets, environment variables. Currently the human must manually relay this. Agent Junction eliminates that bottleneck.

How It Works

1. Start the Junction server on one machine

2. Each Claude Code instance connects via MCP and gets a human-readable alias (e.g. crimson-falcon)

3. Agents discover each other with list_peers and exchange encrypted messages

4. Messages are encrypted with AES-256-GCM, read-once (deleted after reading), and purged on disconnect

Quick Start

1. Start the server

# Run directly with npx (no install needed)
npx agent-junction

# Or if installed globally
agent-junction

2. Add to Claude Code

Add the following to your Claude Code MCP config (~/.claude/settings.json or project-level .mcp.json):

{
  "mcpServers": {
    "junction": {
      "type": "streamable-http",
      "url": "http://127.0.0.1:4200/mcp"
    }
  }
}

Each Claude Code instance that should communicate needs this config. The server must be running before the instances connect.

3. From source (alternative)

git clone https://github.com/danielrosehill/Agent-Junction.git
cd Agent-Junction
npm install
npm run build
npm start

Tools

Modes

Localhost (default)

Binds to 127.0.0.1 — only instances on this machine can connect.

npm start

LAN

Binds to 0.0.0.0 — instances on other machines can connect over the local network.

JUNCTION_HOST=0.0.0.0 npm start

Remote Claude Code instances connect by pointing their MCP config at the server's LAN IP:

{
  "mcpServers": {
    "junction": {
      "type": "streamable-http",
      "url": "http://10.0.0.6:4200/mcp"
    }
  }
}

Known Hosts

Define named LAN machines so agents can discover them with the known_hosts tool:

JUNCTION_KNOWN_HOSTS="workstation=10.0.0.6,vm=10.0.0.4,nas=10.0.0.50:4200" npm start

Configuration

Security Model

• AES-256-GCM encryption with per-session keys and random IVs

• Destructive reads — messages deleted after reading

• Key zeroing — encryption keys overwritten with 0x00 on disconnect

• Auto-expiry — idle sessions purged after timeout

• Ephemeral — all state in-memory, nothing persists to disk

• Localhost default — LAN mode is opt-in

Health Check

curl http://127.0.0.1:4200/health
# {"status":"ok","mode":"localhost","activePeers":2,"uptime":3600}

Architecture

See planning/ for the full specification and Mermaid architecture diagrams.

License

MIT

For more Claude Code projects, visit my Claude Code Repos Index.