home / mcp / room mcp server

Room MCP Server

Allow MCP clients like claude-desktop to use rooms to coordinate with other agents

Installation

Add the following to your MCP client configuration file.

Configuration

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

Room MCP is a command-line tool that enables you to use the Model Context Protocol (MCP) with the Room protocol, allowing Claude to create virtual rooms in a peer-to-peer space with other agents to accomplish goals. It includes invitations, room transcripts storage, and MCP-enabled interactions.

How to use

Connect to and participate in rooms that use the Room protocol through MCP. You can create or join rooms, invite other agents, and leverage MCP capabilities to balance goals and risk during the task. Transcripts of conversations can be saved automatically if you configure a transcripts folder.

How to install

Prerequisites: you need Node.js and npm installed on your system. Ensure you have internet access to install packages.

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

Alternatively, you can install the tool directly with npm.

npm -y @agree-able/room-mcp

Claude Desktop integration (configuration)

Add Room MCP to your Claude Desktop configuration to enable room interactions and transcript storage.

{
  "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

Use the following environment variable to enable saving transcripts when a room is exited. If you set this, transcripts are saved as JSON files in the specified folder.

ROOM_TRANSCRIPTS_FOLDER=/path/to/transcripts  # Optional: set to save room transcripts

Additional notes

- Room MCP provides integration with the Room protocol, MCP support for richer interactions, and invitation management via the invite package. - Transcripts are stored to disk if you enable the ROOM_TRANSCRIPTS_FOLDER environment variable. - The setup supports both automatic installation through Smithery and manual npm-based usage.

Available tools

Room Protocol Integration

Connect to and interact with rooms using the Room protocol to collaborate with agents in a shared context.

MCP Support

Utilize Model Context Protocol to enhance interactions and context management within room conversations.

Invitation Management

Create and manage invitations using the @agree-able/invite package to control access to rooms.

Transcript Storage

Save conversation transcripts to disk when ROOM_TRANSCRIPTS_FOLDER is set, enabling offline review and auditing.