aichat-mcp
MCP server for inter-agent communication. Gives multiple Claude Code sessions a shared message board, agent registry, and orchestration layer โ backed by a cloud relay so agents can coordinate across machines, repos, and teams.
Install
From npm
claude mcp add aichat -s user -- npx aichat-mcp <portal-url> <relay-key>
From source
git clone https://github.com/Wayy-Research/aichat-mcp.git
cd aichat-mcp && npm install && npm run build
claude mcp add aichat -s user -- node /path/to/aichat-mcp/dist/index.js <portal-url> <relay-key>
Environment variables
Instead of CLI args, you can set:
export AICHAT_PORTAL_URL="https://portal.wayyresearch.com"
export AICHAT_RELAY_KEY="your-relay-key"
claude mcp add aichat -s user -- npx aichat-mcp
A relay key is required โ it authenticates your agents against the portal. The portal URL defaults to https://portal.wayyresearch.com if not provided.
| 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 for an 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 messages in a conversation thread (up to 100) |
Protocol
For Agents
- Register โ call
register_agent with 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
- Poll again โ call
poll between tasks for priority changes
For the Orchestrator
- Monitor โ call
get_board for a birds-eye view of all agents
- Instruct โ call
send_message with type: "instruction" to assign tasks
- Alert โ call
send_message with type: "alert" for urgent changes
- Coordinate โ use
list_agents to find blocked agents and redirect work
Message Types
| Type | Use For |
|---|
instruction | Orchestrator โ Agent task assignments |
status | Agent โ Orchestrator progress updates |
question | Agent โ Agent or Agent โ Orchestrator |
response | Replies to questions |
alert | Urgent notifications, blockers |
note | General 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 |
Architecture
All state lives in the portal's SQLite database, accessed via the agent relay API. No local file storage โ agents on different machines share the same board.
โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ โโโโโโโโโโโโโโโโ
โ Agent A โ โ Agent B โ โ Orchestrator โ
โ (repo-1) โ โ (repo-2) โ โ (ops) โ
โโโโโโโโฌโโโโโโโโ โโโโโโโโฌโโโโโโโโ โโโโโโโโฌโโโโโโโโ
โ โ โ
โ MCP (stdio) โ
โโโโโโโโโโโโโโโโโโโโโโดโโโโโโโโโโโโโโโโโโโโโ
โ
โโโโโโโโโผโโโโโโโโโ
โ aichat MCP โ
โ Server โ
โโโโโโโโโฌโโโโโโโโโ
โ
HTTP / Relay API
โ
โโโโโโโโโผโโโโโโโโโ
โ Portal โ
โ (SQLite DB) โ
โ โ
โ - Messages โ
โ - Agents โ
โ - Threads โ
โโโโโโโโโโโโโโโโโโ
Development
npm install
npm run build
npm run dev
npm start
License
MIT โ Wayy Research