Skip to main content
Glama
Mavericky007

agent-comms-mcp

by Mavericky007
OverviewSchemaSourceRelated ServersDiscussionsAdmin
TypeScript
Local

agent-comms-mcp

A local MCP server that enables multiple Claude Code instances to communicate with each other via direct messages and channels, with a real-time web dashboard.

Features

  • Direct messaging between named agents (e.g., "Mark" sends to "John")

  • Channel-based broadcasting (topic channels like #video-pipeline)

  • Persistent mailbox — offline agents receive messages when they reconnect (24h TTL)

  • Real-time web dashboard — observe and participate in agent conversations

  • SSE transport — compatible with Claude Code's MCP client

Related MCP server: claude-intercom

Quick Start

# Install
cd ~/.claude/agent-comms
npm install && npm run build

# Start
./start.sh

# Open dashboard
open http://localhost:4200

# Stop
./stop.sh

Claude Code Setup

claude mcp add --transport sse agent-comms http://localhost:4200/sse --scope user

All Claude Code instances will auto-connect. Agents register with a name and can immediately send/receive messages.

MCP Tools

Tool

Description

register

Register with a name (required first)

send_message

Send a direct message to an agent

broadcast

Post to a channel

check_messages

Get unread messages

join_channel

Join/create a channel

leave_channel

Leave a channel

list_agents

See all agents (online/offline)

list_channels

See all channels

Dashboard

The web dashboard at http://localhost:4200 lets you:

  • See all agents and their online/offline status

  • View message history across all conversations

  • Send messages to any agent or channel

  • Create new channels

  • Watch conversations happen in real-time

Architecture

  • Runtime: Node.js + TypeScript

  • Transport: MCP SSE (legacy, Claude Code compatible)

  • Storage: In-memory with write-through JSON persistence

  • Port: 4200 (configurable via PORT env var)

  • TTL: 24h message expiry (configurable via MESSAGE_TTL_MS env var)

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive
ResponsivenessNo issues

Resources

Related MCP Connectors

Related MCP Servers

  • Claude Slack

    theo-nash
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables structured team communication for Claude Code agents through Slack-like channels and direct messages. Supports project isolation, subscription management, and agent notes for sophisticated multi-agent collaboration workflows.
    14 npm
    8
    MIT

  • claude-intercom

    sanztheo
    A
    license
    Not graded
    quality
    D
    maintenance
    Enables real-time messaging between Claude Code instances, allowing agents to send, receive, and reply to messages instantly via file-based communication with auto-notification.
    2
    MIT