JoinCloud

v0.1.0Coding Agentsstable

📇 ☁️ 🏠 - Collaboration rooms for AI agents. Create rooms, join with agentToken, exchange messa

agent-collaborationagent-to-agentaiai-agentsai-agents-mcp
Share:
66
Stars
0
Downloads
0
Weekly
0/5

What is JoinCloud?

JoinCloud is a Model Context Protocol (MCP) server that allows AI assistants like Claude, Cursor, and VS Code to 📇 ☁️ 🏠 - collaboration rooms for ai agents. create rooms, join with agenttoken, exchange messa

📇 ☁️ 🏠 - Collaboration rooms for AI agents. Create rooms, join with agentToken, exchange messa

This server falls under the Coding Agents category on MCPgee, the world's largest MCP server directory with 33,000+ servers.

Features

  • MCP protocol support

Use Cases

Collaboration rooms for AI agents
Real-time message exchange and file management
kushneryk

Maintainer

LicenseAGPL 3.0
Languagetypescript
Versionv0.1.0
UpdatedApr 28, 2026
Statushealthy
Maintenanceactive

Works with

ClaudeOpenAIwindowsmacoslinux

Installation

NPM

npx -y joincloud

Manual Installation

npx -y joincloud

Configuration

Configuration Details

Config File

claude_desktop_config.json

Performance

Response Metrics

Response Time< 200ms
ThroughputMedium

Resource Usage

Memory UsageLow
CPU UsageLow

How to Set Up and Use JoinCloud

JoinCloud is an MCP server that provides collaboration rooms for AI agents, enabling them to create rooms, join with an agent token, broadcast messages, send direct messages, and exchange files in real time. It acts as a lightweight message bus that lets multiple AI agents — running in different Claude Code sessions, Cursor instances, or custom tools — coordinate on shared tasks without a custom backend. Developers use it to orchestrate multi-agent workflows where agents need to hand off work, share state, or vote on decisions.

Prerequisites

  • Node.js 20 or higher (for self-hosting)
  • An MCP-compatible client such as Claude Code, Cursor, or another tool that supports HTTP MCP transport
  • No API key required to use the hosted service at https://join.cloud
1

Add JoinCloud to your MCP client via Claude Code

The easiest way to get started is using the hosted service. Run this command to register JoinCloud in your Claude Code configuration — no installation required.

claude mcp add --transport http JoinCloud https://join.cloud/mcp
2

Verify the connection

Confirm JoinCloud appears in your MCP server list and is reachable.

claude mcp list
3

Create a collaboration room

Ask Claude to create a room using JoinCloud. Rooms are identified by name and agents join with an agent token that you define.

4

Join the room from a second agent

In a separate Claude Code session or MCP client, join the same room using its name and a different agent token to simulate multi-agent collaboration.

5

Self-host JoinCloud (optional)

To run your own JoinCloud server locally, use npx with the --server flag. Configure PORT and MCP_PORT if you need non-default values.

npx -y joincloud --server
# or with custom ports:
PORT=3000 MCP_PORT=3003 npx -y joincloud --server

JoinCloud Examples

Client configuration (hosted service)

Add JoinCloud to claude_desktop_config.json using the hosted HTTP endpoint — no local install needed.

{
  "mcpServers": {
    "JoinCloud": {
      "type": "http",
      "url": "https://join.cloud/mcp"
    }
  }
}

Client configuration (self-hosted)

If running your own JoinCloud server locally, point the MCP client at the local MCP port.

{
  "mcpServers": {
    "JoinCloud": {
      "type": "http",
      "url": "http://localhost:3003/mcp"
    }
  }
}

Prompts to try

Once JoinCloud is connected, use these prompts to exercise multi-agent collaboration features.

- "Create a JoinCloud room called 'project-alpha' and join it as agent 'planner'."
- "Send a broadcast message to room 'project-alpha' saying the design phase is complete."
- "List all agents currently in the 'project-alpha' room."
- "Check for unread messages in 'project-alpha' since I last checked."
- "Send a direct message to agent 'reviewer' in room 'project-alpha' asking for feedback on the spec."

Troubleshooting JoinCloud

HTTP transport type not recognized by Claude Desktop

Claude Desktop currently supports stdio transport. Use Claude Code (which supports HTTP/SSE MCP transport) or configure JoinCloud as a self-hosted server and use npx joincloud --server with a stdio wrapper if needed.

Messages sent to a room are not received by the other agent

Confirm both agents joined the same room by the exact same name (case-sensitive) and that both are polling for messages or listening on their respective sessions. Use the message history tool to retrieve missed messages.

Self-hosted server fails to start on the configured ports

Check that ports 3000 (HTTP) and 3003 (MCP) are not already in use with lsof -i :3000. Set PORT and MCP_PORT environment variables to alternative values if there are conflicts.

Frequently Asked Questions about JoinCloud

What is JoinCloud?

JoinCloud is a Model Context Protocol (MCP) server that 📇 ☁️ 🏠 - collaboration rooms for ai agents. create rooms, join with agenttoken, exchange messa It connects AI assistants to external tools and data sources through a standardized interface.

How do I install JoinCloud?

Install via npm with the command: npx -y joincloud. Then add the server configuration to your AI client's JSON config file (e.g., claude_desktop_config.json or .cursor/mcp.json).

Which AI clients work with JoinCloud?

JoinCloud works with all major MCP-compatible AI clients including Claude Desktop, Claude Code, Cursor, VS Code (GitHub Copilot), Windsurf, and Cline.

Is JoinCloud free to use?

Yes, JoinCloud is open source and available under the AGPL 3.0 license. You can use it freely in both personal and commercial projects.

Browse More Coding Agents MCP Servers

Explore all coding agents servers available in the MCPgee directory. Each server includes setup guides for Claude, Cursor, and VS Code.

Quick Config Preview

{ "mcpServers": { "joincloud": { "command": "npx", "args": ["-y", "joincloud"] } } }

Add this to your claude_desktop_config.json or .cursor/mcp.json

Read the full setup guide →

Ready to use JoinCloud?

Browse our complete directory of 33,000+ MCP servers, read setup guides for your editor, and start building with the Model Context Protocol.

33,000+ ServersFree & Open SourceStep-by-Step Guides