1
Add it to Claude Code
claude mcp add -e "MQ_TOKEN=${MQ_TOKEN}" -e "MQ_SERVER_URL=${MQ_SERVER_URL}" agent-mq -- npx --yes --package @agent-mq/mcp -- agent-mq-mcpRequired:
MQ_TOKENMQ_SERVER_URL2
Make your agent remember this setup
agent-mq's config, env vars, and the gotchas you hit — recalled in every future Claude Code, Cursor, and Codex session.
npx conare@latestFree · one command · indexes the sessions already on disk. Set up in the browser instead →
What it does
- Enables cross-session and cross-machine communication for AI agents
- Supports task delegation and coordination between multiple AI assistants
- UUID-based authentication with per-user data isolation
- Self-hostable architecture using Docker
- Compatible with Claude Code, Cursor, and other MCP-enabled tools
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.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.
Original README from bababoi-bibilabu/agent-mq
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