aichat-mcp

MCP server for inter-agent communication in multi-agent Claude Code workflows.

Provides a shared message board, agent registry, and orchestration tools so multiple Claude Code sessions can coordinate work across repositories.

Install

From Claude Code (recommended)

# Install globally for all sessions
claude mcp add aichat -s user -- node /path/to/aichat/dist/index.js /path/to/workspace

# Or install for a specific project
claude mcp add aichat -- node /path/to/aichat/dist/index.js /path/to/workspace

From npm (coming soon)

claude mcp add aichat -s user -- npx aichat-mcp /path/to/workspace

Tools

Tool	Description
`register_agent`	Register an agent with name, role, and workspace path
`send_message`	Send a message to another agent or broadcast to all
`read_messages`	Read messages addressed to this agent (marks as read)
`poll`	Check for new unread instructions — call between tasks
`update_status`	Update agent status (idle/working/blocked/completed)
`list_agents`	List all registered agents and their current state
`get_board`	Full orchestration board: agents, unread counts, recent messages
`get_thread`	Get all messages in a conversation thread

Protocol

For Agents

When starting a session, agents should:

Register: Call register_agent with their name, role, and workspace
Poll: Call poll to check for instructions from the orchestrator
Work: Execute tasks, calling update_status when starting/finishing
Report: Call send_message to report results back to orchestrator
Poll again: Call poll between tasks to check for priority changes

For the Orchestrator

The orchestrator manages all agents by:

Monitor: Call get_board for a birds-eye view of all agents
Instruct: Call send_message with type: "instruction" to direct agents
Alert: Call send_message with type: "alert" for urgent changes
Coordinate: Use list_agents to check who's blocked and redirect work

Message Types

Type	Use For
`instruction`	Orchestrator → Agent task assignments
`status`	Agent → Orchestrator progress updates
`question`	Agent → Agent or Agent → Orchestrator questions
`response`	Replies to questions
`alert`	Urgent notifications (priority changes, blockers)
`note`	General notes, FYI messages

Priority Levels

Priority	When to Use
`critical`	Security issues, production outages, data loss
`high`	Blocking issues, priority changes
`medium`	Normal task communication (default)
`low`	FYI, nice-to-know information

Storage

Messages and agent state are persisted to {workspace}/.wayy-ops/aichat-store.json.

Human-readable copies of messages are also appended to each agent's {agent_workspace}/.wayy-ops/messages.md file for visibility.

Architecture

┌──────────────┐     ┌──────────────┐     ┌──────────────┐
│  Agent A     │     │  Agent B     │     │ Orchestrator │
│ (voxlex)     │     │ (wayyFin)    │     │   (ops)      │
└──────┬───────┘     └──────┬───────┘     └──────┬───────┘
       │                    │                    │
       └────────────────────┴────────────────────┘
                            │
                    ┌───────▼────────┐
                    │  aichat MCP    │
                    │  Server        │
                    │                │
                    │  - Messages[]  │
                    │  - Agents{}    │
                    │  - Store.json  │
                    └────────────────┘

Development

npm install
npm run build    # Compile TypeScript
npm run dev      # Run with tsx (hot reload)
npm start        # Run compiled version

License

MIT — Wayy Research

aichat

Quick Install