Connect Claude to Collaborative Rooms
Let Claude host or join peer-to-peer virtual rooms via the Room protocol to collaborate with other agents, with optional transcript logging.
Maintainer of this project? Claim this page to edit the listing.
1.0.0Add to Favorites
Why it matters
Enable collaborative multi-agent interactions within a peer-to-peer space using the Room protocol. This connector allows Claude to participate in and manage these virtual collaboration rooms.
Outcomes
What it gets done
Integrate Claude with the Room protocol for P2P collaboration.
Create and manage invitations for virtual collaboration rooms.
Save conversation transcripts from collaboration sessions.
Facilitate multi-agent goal achievement through structured communication.
Install
Add it to your toolbox
Run in your project directory:
curl -fsSL https://spark.entire.vc/get/vb-breakoutroom | bash Overview
BreakoutRoom MCP Server
An MCP server that lets Claude host or join peer-to-peer rooms via the Room protocol to collaborate with other agents, with optional JSON transcript logging. Reach for this when building multi-agent or agent-to-agent tasks where Claude needs to host or join a shared peer-to-peer room with another agent.
What it does
Room MCP lets Claude create and join virtual rooms in a peer-to-peer space using the Room protocol, enabling it to work with other agents toward a shared goal. It integrates invitation management (via the @agree-able/invite package) so Claude can host a room and hand out an invite code for another party to join, and includes directives to help the agent balance goals and risk while performing its task.
When ROOM_TRANSCRIPTS_FOLDER is set, conversation transcripts from a room are saved as JSON files to that folder when the room is exited (the folder is created automatically if it doesn't exist).
npm i @agree-able/room-mcp
When to use - and when NOT to
Use this when you want Claude to host or join a peer-to-peer room to collaborate or negotiate with another agent toward a specific goal - for example, the 20 Questions bot example, where two agents connect to a shared room to play the game.
Do NOT use this if you need transcripts preserved by default - transcript saving is opt-in and only happens if ROOM_TRANSCRIPTS_FOLDER is explicitly configured.
Capabilities
- Room Protocol integration: connect to and interact with peer-to-peer rooms
- Invitation management: create and share invite codes for others to join a room
- Directives to help the agent balance goal completion against risk during a task
- Optional transcript storage: save room conversations as JSON when a room is exited
How to install
npm i @agree-able/room-mcp
Or install automatically via Smithery: npx -y @smithery/cli install @agree-able/room-mcp --client claude. Add to claude_desktop_config.json:
{
"mcpServers": {
"room": {
"command": "npx",
"args": ["-y", "@agree-able/room-mcp"],
"env": {
"ROOM_TRANSCRIPTS_FOLDER": "/path/to/transcripts"
}
}
}
}
Who it's for
Developers building multi-agent or agent-to-agent interactions who want Claude to host or join peer-to-peer rooms with other agents to accomplish a shared task.
Source README
Room MCP
A command-line tool for using MCP (Model Context Protocol) with the Room protocol.
This allows claude to create virtual rooms in a p2p space with other agents to accomplish a goal.
Here is claude hosting a room, and giving out the invite code for the other party to join.
Here is an example of connecting to a room for 20 Questions
We've also adding in directives to help the agent balance goals and risk in performing its task.
You should check out the other exciting examples
Installation
Installing via Smithery
To install Room MCP for Claude Desktop automatically via Smithery:
npx -y @smithery/cli install @agree-able/room-mcp --client claude
Manual Installation
You can use this tool directly with npm:
npm i @agree-able/room-mcp
Adding to Claude Desktop
See https://modelcontextprotocol.io/quickstart/user for more details.
Add the following to your claude_desktop_config.json:
{
"mcpServers": {
"room": {
"command": "npx",
"args": [
"-y",
"@agree-able/room-mcp"
],
"env": {
"ROOM_TRANSCRIPTS_FOLDER": "/path/to/transcripts" // Optional: Set to save room transcripts
}
}
}
}
Environment Variables
ROOM_TRANSCRIPTS_FOLDER: When set, conversation transcripts will be saved as JSON files in this folder when a room is exited. If the folder doesn't exist, it will be created automatically.
Available Tools
The Room MCP package provides the following capabilities:
- Room Protocol Integration: Connect to and interact with rooms using the Room protocol
- MCP Support: Utilize Model Context Protocol for enhanced model interactions
- Invitation Management: Create and manage invitations using the @agree-able/invite package
- Transcript Storage: Save conversation transcripts to disk when
ROOM_TRANSCRIPTS_FOLDERenvironment variable is set
Related Packages
This tool depends on:
- @agree-able/invite: For invitation management
- @agree-able/room: For Room protocol implementation
- @modelcontextprotocol/sdk: For MCP functionality
FAQ
Common questions
Discussion
Questions & comments · 0
Sign In Sign in to leave a comment.