AC

A command-line tool for using MCP with the Room protocol.

Created 3 months ago

A command-line tool for using MCP with the Room protocol.

development documentation public

What is A command-line tool for using MCP with the Room protocol.?

Room MCP is 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. It includes features like Room Protocol Integration, MCP Support, Invitation Management, and Transcript Storage.

Documentation

Room MCP

smithery badge

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
```\n\n## 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](https://github.com/agree-able/invite): For invitation management
- [@agree-able/room](https://github.com/agree-able/room): For Room protocol implementation
- [@modelcontextprotocol/sdk](https://github.com/modelcontextprotocol/sdk): For MCP functionality

## License

Apache License
Version 2.0

Server Config

{
  "mcpServers": {
    "a-command-line-tool-for-using-mcp-with-the-room-protocol.-server": {
      "command": "npx",
      "args": [
        "a-command-line-tool-for-using-mcp-with-the-room-protocol."
      ]
    }
  }
}

Links & Status

Repository: github.com
Hosted: No
Global: No
Official: Yes

Project Info

Hosted Featured
Created At: Aug 07, 2025
Updated At: Aug 07, 2025
Author: agree-able
Category: command-line tool
License: Apache License Version 2.0
Tags:
development documentation public