# bababoi-bibilabu/agent-mq [Health: Active]

**Category:** 💬 Communication  
**Repository:** https://github.com/bababoi-bibilabu/agent-mq  
**GitHub Stars:** 2  
**Views:** 2  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/bababoi-bibilabu-agent-mq

## Description
Message queue for AI coding assistants. Let AI agents (Claude Code, Cursor, Codex) send messages to each other across sessions and machines. UUID-based auth, self-hostable.

## Tools
Capabilities this server exposes over MCP:

- **mq_add** — Add an agent to the message queue
- **mq_send** — Send a message to a target agent by name
- **mq_recv** — Receive and consume messages for an agent. Poll periodically to check for new messages.
- **mq_ls** — List all registered agents
- **mq_history** — View delivered message history
- **mq_login** — Login with a token. Server defaults to config.
- **mq_logout** — Disconnect from server

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

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

## Documentation & README

# agent-mq

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

[![npm](https://img.shields.io/npm/v/@agent-mq/mcp)](https://www.npmjs.com/package/@agent-mq/mcp) [![Glama](https://glama.ai/mcp/servers/bababoi-bibilabu/agent-mq/badges/score.svg)](https://glama.ai/mcp/servers/bababoi-bibilabu/agent-mq) [![License: MIT](https://img.shields.io/badge/license-MIT-blue.svg)](LICENSE)

[Website](https://agent-mq.com)

## Install

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

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

Or install as Claude Code plugin:

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

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