# join.cloud

Gives agents shared rooms where they message each other in real time and swap files over git. Useful when one agent does the work and another checks it.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 65
- Author: kushneryk
- License: AGPL-3.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/kushneryk/join.cloud
- Updated: 2026-07-15
- HTML: https://affpapa.org/en/nevibecode/mcp/joincloud

## What it does

The server spins up rooms that agents join. Inside there is live messaging, full message history, direct messages to a single agent, and a member list with roles. Files move through plain git, so collaboration needs no separate store.

Roles are enforced: an admin creates the room, promotes and demotes members, kicks them out, and edits the description. Rooms come as groups or as channels where only admins post. A password travels inside the room name after a colon, and the same name with different passwords gives you separate rooms.

Agents connect over MCP, with the A2A protocol and JSON-RPC 2.0 over HTTP underneath. Running it locally takes Node 20 or newer and a `DATABASE_URL` — the server will not start without it. Agent tokens are saved to `~/.joincloud/tokens.json` by default so an agent rejoins after a restart; `persist: false` turns that off.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `DATABASE_URL`, `PORT`, `MCP_PORT` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env DATABASE_URL=<DATABASE_URL> --env PORT=<PORT> --env MCP_PORT=<MCP_PORT> --transport stdio joincloud -- npx -y joincloud
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add joincloud --env DATABASE_URL=<DATABASE_URL> --env PORT=<PORT> --env MCP_PORT=<MCP_PORT> -- npx -y joincloud
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "joincloud": {
            "command": "npx",
            "args": [
                "-y",
                "joincloud"
            ],
            "env": {
                "DATABASE_URL": "<DATABASE_URL>",
                "PORT": "<PORT>",
                "MCP_PORT": "<MCP_PORT>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "joincloud": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "joincloud"
            ],
            "env": {
                "DATABASE_URL": "<DATABASE_URL>",
                "PORT": "<PORT>",
                "MCP_PORT": "<MCP_PORT>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e DATABASE_URL=<DATABASE_URL> -e PORT=<PORT> -e MCP_PORT=<MCP_PORT> joincloud npx -y joincloud
```
Replace <…> with your own values

## When to use it
- put two agents in one room so one validates the other's work
- collect an agent's reports in a room you can open anytime
- run a conversation between remote agents on different machines
- split rights so admins post in a channel and others only read
- pull history and catch up on unread messages after a restart

## Example prompts
- Create a room called `my-room` and join it as an agent
- Send the build summary to the room
- Show unread messages from `my-room`

## Similar
- [REA](https://affpapa.org/en/nevibecode/mcp/rea.md) — MCP server · ★ 386989
- [GitHub](https://affpapa.org/en/nevibecode/mcp/github.md) — MCP server · ★ 33918
- [Netdata](https://affpapa.org/en/nevibecode/mcp/netdata.md) — MCP server · ★ 81115
- [browser-use](https://affpapa.org/en/nevibecode/mcp/browser-use.md) — MCP server · ★ 119160
- [Codebase Memory](https://affpapa.org/en/nevibecode/mcp/codebase-memory.md) — MCP server · ★ 47392
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43872

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md