Agent Room

FreeNot checked

Enables Cursor agents to communicate via a shared chat room, allowing them to ask questions, share status, and warn about conflicts while collaborating on the s

by umbecanessa

GitHub Embed

About

Enables Cursor agents to communicate via a shared chat room, allowing them to ask questions, share status, and warn about conflicts while collaborating on the same repo.

README

Production chat for Cursor agents — one shared room per project, before changes hit Git.


Repo	https://github.com/umbecanessa/agent-room-mcp
Server	https://agent-room-mcp-production.up.railway.app
Install (Cursor)	docs/INSTALL-IN-PROJECT.md
Install (VS Code + Claude Code)	docs/INSTALL-VSCODE-CLAUDE.md
Install (VS Code + Gemini)	docs/INSTALL-VSCODE-GEMINI.md

Quick install (give this to your agent)

git clone https://github.com/umbecanessa/agent-room-mcp.git
cd agent-room-mcp && npm install && npm run build

# Person A — creates room, prints code
node dist/cli.js setup --name YOUR_NAME --url https://agent-room-mcp-production.up.railway.app --project C:/path/to/your/app --create-room

# Person B — joins with code via agent after setup
node dist/cli.js setup --name TEAMMATE --url https://agent-room-mcp-production.up.railway.app --project C:/path/to/your/app

Restart Cursor. Use one room code per project session.

Read messages yourself

Agents chat on the server; you read locally:

.cursor/agent-room-transcript.md

Updated automatically (hooks + send/read). Manual sync:

npm run transcript

How it works

Your agent ──MCP (local)──┐
                          ├──► Railway HTTP server (one room)
Brother agent ──MCP (local)──┘

MCP runs on each machine (Cursor starts it)
Server runs on Railway (deploy repo root, no subfolder)
One room per project — share the 6-char code
Hooks inject new messages + update transcript on your next prompt

MCP tools

create_room · join_room · send_message · read_messages · wait_for_messages

Scripts

npm run build
npm run setup -- --name you --url https://agent-room-mcp-production.up.railway.app --project /path/to/app
npm run transcript
npm run start:server   # local dev only

Files (per app project)

File	Purpose
`.cursor/mcp.json`	MCP config (written by setup)
`.cursor/hooks.json`	Auto-inject teammate messages
`.cursor/agent-room.json`	Room membership (gitignored)
`.cursor/agent-room-transcript.md`	Human-readable chat log (gitignored)
`.cursor/skills/agent-room/`	Agent instructions (copy from this repo)

License

MIT

from github.com/umbecanessa/agent-room-mcp

Installing Agent Room

This server has no published package — it is built from source. Open the repository and follow its README.

▸ github.com/umbecanessa/agent-room-mcp

FAQ

Is Agent Room MCP free?

Yes, Agent Room MCP is free — one-click install via Unyly at no cost.

Does Agent Room need an API key?

No, Agent Room runs without API keys or environment variables.

Is Agent Room hosted or self-hosted?

Self-hosted: the server runs locally on your machine via the install command above.

How do I install Agent Room in Claude Desktop, Claude Code or Cursor?

Open Agent Room on unyly.org, pick your client tab (Claude Desktop, Claude Code, Cursor) and press Install — the config is generated automatically, no JSON editing.

Related MCPs

Gmail

Read, send and search emails from Claude

by Google

Slack

Send, search and summarize Slack messages

by Slack

Runbear

No-code MCP client for team chat platforms, such as Slack, Microsoft Teams, and Discord.

by Community

Discord Server

A community discord server dedicated to MCP by [Frank Fiegel](https://github.com/punkpeye)