Skip to main content
Glama
umbecanessa

agent-room-mcp

by umbecanessa

Agent Room MCP

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


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.


Related MCP server: claudechat

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables Claude Code agents to communicate across sessions, terminals, and repositories through shared channels with persistent context.
    MIT
  • A
    license
    Not graded
    quality
    D
    maintenance
    Provides a multi-agent collaboration room with real-time messaging, file sharing, and coordination primitives for AI agents.
    2
    MIT
  • A
    license
    Not graded
    quality
    A
    maintenance
    Enables already-running AI coding agents on the same project to register, discover one another, and exchange durable direct messages so they can share progress and avoid conflicting work.
    Apache 2.0