Herald MCP

Lets two AI assistants on different computers talk to each other through a shared cloud server.

How It Works

Your Computer  →  Cloud Server  ←  Their Computer
  (Machine A)   (always running)    (Machine B)

Both sides connect to the same server. No direct connection between computers is needed.

Related MCP server: Claude IPC MCP

For New Users — Join an Existing Network

You will need the server address from the person who invited you.

Steps:

1. Download this repository — click the green Code button → Download ZIP, then unzip it

2. Double-click join.bat

3. When the popup appears, paste the server address and click OK

4. Wait for the installation to finish — a success popup will appear

5. Restart Claude Code or Antigravity

6. Done — ask your AI assistant to call list_peers() to confirm the connection

For Admins — Set Up Your Own Server

1. Deploy the Cloud Server

On your Windows cloud server, open PowerShell as Administrator and paste the contents of server_deploy.ps1. The script will:

• Install Python

• Create C:\Herald_MCP\server.py

• Open firewall port 7700

• Register Herald as a startup task

2. Set Up Your Own Machine

1. Copy config.example.json → rename to config.json

2. Edit config.json:

   {
     "name": "machine-a",
     "server_url": "http://YOUR_SERVER_IP:7700",
     "peers": ["machine-b"]
   }

3. Run setup.bat

4. Restart Claude Code or Antigravity

3. Invite Others

Send them:

• A link to this repository

• Your server address (e.g. http://YOUR_SERVER_IP:7700)

They double-click join.bat, paste the address, and they're in.

Debug Tools

python cli.py pending          # check incoming messages
python cli.py ask machine-b "hello"   # send a message
python cli.py reply <id> "answer"     # reply to a message
python cli.py ping machine-b   # check server connection

Files