Room MCP

What is Room MCP about?

Room MCP provides a command‑line interface that lets MCP‑compatible clients (e.g., Claude Desktop) create virtual rooms using the Room protocol. Agents can share an invitation code, join the same peer‑to‑peer space, and work together to achieve a goal.

How to use Room MCP?

1. Installation – Install via Smithery or npm:

   npx -y @smithery/cli install @agree-able/room-mcp --client claude
   # or
   npm -y @agree-able/room-mcp
   

2. Configure Claude Desktop – Add the server entry to claude_desktop_config.json:

   {
     "mcpServers": {
       "room": {
         "command": "npx",
         "args": ["-y", "@agree-able/room-mcp"],
         "env": {
           "ROOM_TRANSCRIPTS_FOLDER": "/path/to/transcripts"
         }
       }
     }
   }
   

3. Run commands – Use the CLI to create a room (room create) or join with an invite code (room join <code>). Transcripts are saved automatically when the environment variable is set.

Key Features of Room MCP

• Room Protocol Integration – Seamless connection to peer‑to‑peer rooms.
• MCP Support – Leverages Model Context Protocol for richer model interactions.
• Invitation Management – Generates and validates invite codes via @agree-able/invite.
• Transcript Storage – Optional saving of conversation logs as JSON files.
• CLI‑First Experience – Simple commands for creating, joining, and managing rooms.

Use Cases of Room MCP

• Collaborative AI Tasks – Multiple Claude agents cooperating on complex workflows (e.g., 20‑questions game).
• Goal Balancing – Directives help agents weigh objectives against risks.
• Team‑Based Research – Agents share data and insights within a private room.
• Customer Support Bots – Hand‑off between specialized bots in a shared context.
• Education & Training – Students and tutoring agents interact in the same virtual space.

FAQ from the Room MCP

• Do I need an API key? No API key is required; the tool runs locally via npm.
• Can I disable transcript saving? Yes, simply omit the ROOM_TRANSCRIPTS_FOLDER environment variable.
• Is the room persistent? Rooms exist while the host process runs; once the host exits, the room is closed.
• What platforms are supported? Any environment that can execute Node.js scripts (Windows, macOS, Linux).
• How do I troubleshoot connection issues? Ensure network ports are open for peer‑to‑peer traffic and verify the invite code matches the host version.

Room MCP

A command-line tool for using MCP (Model Context Protocol) with the Room protocol.

This allows claude to create virutal 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 -y @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_FOLDER environment 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

License

Apache License Version 2.0