1. Conduid
  2. Agents
  3. io.github.rcgalbo/aichat
MCP server · Agents

io.github.rcgalbo/aichat

· github.com/Wayy-Research/aichat-mcp

Inter-agent communication for multi-agent Claude Code workflows.

Unclaimed agents
InstallView source
37Low

Scored 6 months ago · breakdown

About io.github.rcgalbo/aichat

io.github.rcgalbo/aichat is an MCP server in the Agents category: inter-agent communication for multi-agent Claude Code workflows.

Install

Claude Code
claude mcp add io-github-rcgalbo-aichat -- npx -y aichat-mcp
npx
npx -y aichat-mcp

This server has no ConduID identity, so agent calls to it are not receipted. Pin the version you install and review the source before granting it credentials.

Tools (8)

get_boardFull orchestration board: agents, unread counts, recent messages

Parameters not published.

get_threadGet messages in a conversation thread (up to 100)

Parameters not published.

list_agentsList all registered agents and their current state

Parameters not published.

pollCheck for new unread instructions — call between tasks

Parameters not published.

read_messagesRead messages for an agent (marks as read)

Parameters not published.

register_agentRegister an agent with name, role, and workspace path

Parameters not published.

send_messageSend a message to another agent or broadcast to all

Parameters not published.

update_statusUpdate agent status (idle / working / blocked / completed)

Parameters not published.

Ask AI

✦

Ask AI about io.github.rcgalbo/aichat

Powered by Claude · Grounded in docs

I know everything about io.github.rcgalbo/aichat. Ask me about installation, configuration, usage, or troubleshooting.

Security checks

  • ✓README presentThe repository ships documentation.

5 checks have not been run yet.

README

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.

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 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

  1. Register — call register_agent with name, role, and workspace
  2. Poll — call poll to check for instructions from the orchestrator
  3. Work — execute tasks, calling update_status when starting/finishing
  4. Report — call send_message to report results back
  5. Poll again — call poll between tasks for priority changes

For the Orchestrator

  1. Monitor — call get_board for a birds-eye view of all agents
  2. Instruct — call send_message with type: "instruction" to assign tasks
  3. Alert — call send_message with type: "alert" for urgent changes
  4. 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    # Compile TypeScript
npm run dev      # Run with tsx (hot reload)
npm start        # Run compiled version

License

MIT — Wayy Research

README copy captured when this server was indexed; it may lag the repository. The original is authoritative.

Questions

About io.github.rcgalbo/aichat

How do I install io.github.rcgalbo/aichat?

Run claude mcp add io-github-rcgalbo-aichat -- npx -y aichat-mcp, then add the server to your MCP client's configuration.

Is io.github.rcgalbo/aichat safe to use with an AI agent?

Its trust score is 37 out of 100 (low). It passes 1 of the 1 static security checks run so far. It has no ConduID identity yet, so agent calls to it are not receipted.

Is io.github.rcgalbo/aichat still maintained?

Conduid hasn't recorded a commit date for this repository yet. Check the repository directly for recent activity.