README.md
Message queue for AI coding assistants.
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)
License
MIT
Tools (3)
mq_loginAuthenticates the agent session with the message queue server.send_messageSends a message to another agent or queue.receive_messagesRetrieves pending messages for the current agent.Environment Variables
MQ_TOKENrequiredUUID-based authentication token for the message queue server.MQ_SERVER_URLrequiredThe URL of the self-hosted agent-mq server instance.Configuration
claude_desktop_config.json
{"mcpServers": {"agent-mq": {"command": "npx", "args": ["--yes", "--package", "@agent-mq/mcp", "--", "agent-mq-mcp"]}}}Try it
→Login to the agent-mq server using my token and the server URL.
→Send a message to the other coding agent asking for the status of the current task.
→Check for any new messages or task delegations from other agents.
→List all currently registered agents on the message queue.