Agent skill · software engineering · aradotso
claude-peers-mcp
Enable multiple Claude Code instances to discover each other and exchange messages in real-time via a local broker daemon and MCP server.
Why this skill is useful
Adds a local broker daemon and specific commands for real-time messaging between Claude Code instances that the AI wouldn't reliably generate on its own.
What it needs
Requires bun installed locally. Requires claude.ai account access. About 4k tokens when loaded. Last updated 2026-07-09. 70 stars on the source repository.
What this skill does
claude-peers-mcp Skill by ara.so — Daily 2026 Skills collection. claude-peers is an MCP server that lets multiple Claude Code instances running on the same machine discover each other and exchange messages in real-time. A local broker daemon (SQLite + HTTP on localhost:7899) handles peer registration and message routing; each session's MCP server pushes inbound messages directly into the Claude channel so they appear instantly. Installation 1. Clone and install dependencies 2. Register as a global MCP server Adjust the path if you cloned elsewhere. 3. Launch Claude Code with the channel enabled Add a shell alias to avoid typing it every time: The broker daemon starts automatically on first use. No manual daemon management needed. Requirements Bun runtime Claude Code v2.1.80+ claude.ai login (channels require it — API key auth does not work) Architecture Each Claude Code session spawns its own server.ts MCP process over stdio MCP servers register with the broker and poll every second Inbound messages are pushed via the claude/channel protocol for instant delivery The broker auto-cleans dead peers and is localhost-only MCP Tools Reference Tool Description --- --- listpeers Discover other Claude Code instances; scope: machine, directory, or repo sendmessage Send a message to a peer by ID — delivered instantly via channel push setsummary Set a description of what this instance is working on checkmessages Manually poll for messages (fallback without channel mode) Example prompts to Claude CLI Usage Inspect and interact with the broker directly from the terminal: Configuration Set these environment variables before starting Claude Code: Variable Default Description --- --- --- CLAUDEPEERSPORT 7899 Port the broker listens on CLAUDEPEERSDB ~/.claude-peers.db Path to the SQLite database OPENAIAPIKEY — Enables auto-summary via gpt-4o-mini on startup Auto-Summary Feature With OPENAIAPIKEY set, each instance generates a brief summary on startup describing what you're likely wor …
How to use it
Reference it in AdaL, Claude Code, Cursor or any coding agent — nothing to install:
@skills aradotso/claude-peers-mcp