- CollectionAgent Runtime & Infrastructure
- Classificationagent-native
- MCPAvailable
- Agent SkillUnavailable
- InterfacesMCP · CLI · STDIO · http
What it does
Claude Peers runs a localhost broker (default port 7899, SQLite-backed) so multiple Claude Code sessions on the same machine can discover each other and exchange messages in real time. Each session runs an MCP server that registers with the broker; inbound messages can be delivered instantly through the Claude Code channels protocol. Traffic stays local — no cloud relay for peer messaging.
Agent-facing interfaces
- Interaction pattern: MCP (stdio) + local broker
- Catalog protocols: MCP, CLI, STDIO, http
- MCP: ✅ Primary interface — stdio MCP server (server.ts) exposing peer discovery and messaging tools.
- Agent Skill: ⚠️ Not published — onboarding is via repo README and MCP registration.
- Onboarding type:
mcp
How agents onboard
Interaction pattern: MCP (stdio) + local broker
git clone https://github.com/louislva/claude-peers-mcp.git ~/claude-peers-mcp
cd ~/claude-peers-mcp
bun install
# Register the MCP server for Claude Code (user scope)
claude mcp add --scope user --transport stdio claude-peers -- bun ~/claude-peers-mcp/server.ts
# Run Claude Code with the claude-peers development channel
claude --dangerously-skip-permissions --dangerously-load-development-channels server:claude-peers
See the full onboarding section in the dossier.
Protocol surface
| Interface | Detail |
|---|---|
| MCP | stdio — server.ts (register via claude mcp add) |
| Broker | HTTP on configurable port (default 7899) |
| Channels | Claude Code server:claude-peers development channel for push delivery |
| CLI | bun cli.ts — operational commands |