# MCP Zmq

> MCP Zmq is an open-source MCP server for communication. MCP server giving AI clients ZeroMQ publish, subscribe, request and reply messaging. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Linux, macOS, Windows, self-hosted
- **Repository:** https://github.com/daedalus/mcp-zmq
- **MCP Registry name:** io.github.daedalus/mcp-zmq
- **Categories:** [communication](https://ai-powered.com/categories/communication)
- **Listing updated:** 2026-11-18

## About

The README describes mcp-zmq as a Model Context Protocol server that wraps ZeroMQ messaging so an AI client can send and receive messages over ZMQ sockets. It is installed from PyPI and started with a single command, using stdio as its transport.

The server exposes tools that map onto the main ZMQ socket patterns: publishing to a PUB socket, subscribing to a SUB socket, sending requests through a REQ socket, and listening for and answering requests on a REP socket. It also lists tools for connecting and binding PAIR sockets and a status tool for checking the server. The same functions are importable from the Python package for use outside MCP.

The project is aimed at developers who want an assistant or agent to take part in existing ZeroMQ-based message flows. The repository includes test, lint and type-check setup for contributors.

## Features

- **Publish and subscribe:** Sends messages to a ZMQ PUB socket and reads from a SUB socket.
- **Request and reply:** Supports REQ-side requests and REP-side listening and replies.
- **PAIR socket connections:** Provides tools to connect to or bind a ZMQ PAIR socket.
- **Stdio MCP transport:** Runs as a local MCP server over stdio, installed via pip.
- **Python API:** Exposes the same messaging functions for direct import in Python code.

## Good for

- Letting an AI assistant publish status messages to a ZeroMQ pub/sub system
- Querying a service that answers over a ZMQ REP socket
- Monitoring messages arriving on a ZMQ SUB socket
- Testing ZeroMQ-based components from an MCP client

## Install

### Claude Code (Terminal)

```sh
claude mcp add mcp-zmq -- uvx mcp-zmq
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "mcp-zmq": {
      "command": "uvx",
      "args": [
        "mcp-zmq"
      ]
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "mcp-zmq": {
      "command": "uvx",
      "args": [
        "mcp-zmq"
      ]
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "mcp-zmq": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "mcp-zmq"
      ]
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "mcp-zmq": {
      "command": "uvx",
      "args": [
        "mcp-zmq"
      ]
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "mcp-zmq": {
      "command": "uvx",
      "args": [
        "mcp-zmq"
      ]
    }
  }
}
```

## Tools

- `zmq_publish`: Publish a message to a ZMQ PUB socket
- `zmq_subscribe`: Subscribe to messages from a ZMQ SUB socket
- `zmq_send_request`: Send a request via ZMQ REQ socket
- `zmq_listen_reply`: Listen for requests and reply via ZMQ REP socket
- `zmq_pair_connect`: Connect to a ZMQ PAIR socket
- `zmq_pair_bind`: Bind a ZMQ PAIR socket
- `zmq_status`: Get ZMQ server status

## FAQ

### How is the server installed?

The README says to install it with pip install mcp-zmq and start it with the mcp-zmq command.

### Which ZMQ socket types are supported?

The README lists PUB, SUB, REQ, REP and PAIR socket tools.

### Is MCP Zmq free?

Yes. MCP Zmq is open source, so you can use and self-host it for free.

### How do I add MCP Zmq to Claude Code?

Run this command in your terminal: claude mcp add mcp-zmq -- uvx mcp-zmq

### What are the best alternatives to MCP Zmq?

The closest alternatives to MCP Zmq are MCP Telegram Bot and Zoko MCP by usefulapi.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [MCP Telegram Bot](https://ai-powered.com/mcp/mcp-telegram-bot): MCP Telegram Bot is an open-source MCP server for communication.
- [Zoko MCP by usefulapi](https://ai-powered.com/mcp/zoko-mcp-by-usefulapi): Zoko MCP by usefulapi is a freemium MCP server for communication.

---
Source: https://ai-powered.com/mcp/mcp-zmq
