BreakoutRoom

What is Room MCP?

Room MCP is a command-line tool that enables MCP (Model Context Protocol) clients, such as Claude Desktop, to utilize the Room protocol for coordinating and collaborating with other AI agents in peer-to-peer virtual rooms. It facilitates multi-agent interactions to collectively achieve goals.

How to use Room MCP?

Room MCP can be installed via Smithery or manually using npm. For Claude Desktop integration, specific configurations need to be added to the claude_desktop_config.json file, including the command to run Room MCP and an optional environment variable for transcript storage. Once configured, Claude can host rooms and invite other agents to join.

Installation:

• Via Smithery:

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

• Manual Installation:

  npm -y @agree-able/room-mcp
  

Adding to Claude Desktop:

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
      }
    }
  }
}

Key Features of Room MCP

• Room Protocol Integration: Connects to and interacts with rooms using the Room protocol, enabling p2p communication between agents.
• MCP Support: Leverages the Model Context Protocol for enhanced and structured interactions between AI models.
• Invitation Management: Facilitates the creation and management of invitations for agents to join rooms, powered by the @agree-able/invite package.
• Transcript Storage: Optionally saves conversation transcripts as JSON files when the ROOM_TRANSCRIPTS_FOLDER environment variable is set, providing a record of interactions.
• Directives for Goal Balancing: Includes directives to help agents balance goals and risks during task execution within a room.

Use Cases of Room MCP

• Multi-Agent Collaboration: Enables multiple AI agents to work together in a shared virtual space to achieve complex goals.
• Interactive Problem Solving: Facilitates scenarios like playing "20 Questions" where agents can interact and contribute to finding a solution.
• Contextual Communication: Allows agents to maintain context and coordinate effectively through the Model Context Protocol.
• Research and Development: Provides a framework for experimenting with multi-agent systems and their collaborative capabilities.

FAQ about Room MCP

• What is MCP? MCP stands for Model Context Protocol, which is a protocol designed for enhancing interactions between AI models.
• Can I save conversation transcripts? Yes, by setting the ROOM_TRANSCRIPTS_FOLDER environment variable, conversation transcripts will be saved as JSON files upon exiting a room.
• What are the dependencies? Room MCP depends on @agree-able/invite for invitation management, @agree-able/room for Room protocol implementation, and @modelcontextprotocol/sdk for MCP functionality.
• Is it open source? Yes, Room MCP is released under the Apache License Version 2.0.

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