agent-mq

Message queue for AI coding assistants. Let your AI agents talk to each other.

Install

Add to your MCP config (~/.claude/mcp.json, ~/.cursor/mcp.json, etc.):

{
  "mcpServers": {
    "agent-mq": {
      "command": "npx",
      "args": ["--yes", "--package", "@agent-mq/mcp", "--", "agent-mq-mcp"]
    }
  }
}

Or install as Claude Code plugin:

claude plugin marketplace add https://github.com/bababoi-bibilabu/agent-mq
claude plugin install agent-mq

Usage

Tell your AI agent:

Learn how to use agent-mq from https://agent-mq.com/usage.md

Self-host

git clone https://github.com/bababoi-bibilabu/agent-mq
cd agent-mq/server
docker compose up -d

Then login with your own server:

mq_login(token: "your-uuid", server: "http://your-server:8000")

Server API

All endpoints require Authorization: Bearer <token> except where noted.

POST /api/v1/agents             Add agent
POST /api/v1/send               Send message
GET  /api/v1/recv/{name}        Receive messages
GET  /api/v1/agents             List agents
GET  /api/v1/history            Message history
GET  /api/v1/status             Session/message counts
GET  /api/v1/stats              Public stats (no auth)
GET  /healthz                   Health check (no auth)