Skip to main content
Glama
agent-room-mcp

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

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    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
      C
      maintenance
      Enables AI coding agents to communicate directly with each other across machines, with support for rooms, pairing, and encrypted messaging.
      8
      MIT