Skip to main content
Glama
rabbitmq-mcp

rabbitmq-mcp

by kmitchell

rabbitmq-mcp NPM Version

A Model Context Protocol (MCP) server for RabbitMQ, enabling MCP clients to interact with RabbitMQ. This server aims to expose the full range of features available in the official RabbitMQ HTTP API as tools.

MCP is a standardized protocol for managing context between large language models (LLMs) and external systems, such as RabbitMQ. It allows users to ask MCP-enabled AI agents, like Claude Desktop or Cursor, to interact with external systems using natural language.

💬 Example Requests:

  • Get me the message count in the inbound signup metrics queue, and if it's over 10,000, move half of them to the metrics overflow queue.

  • Purge the outbound email deadletter queue.

  • Check if there are any alarms triggered in the production vhost.

These are parseable and actionable requests that an MCP client can handle with this server.

Installation

If you prefer to install locally:

npm install -g rabbitmq-mcp

Or with npx:

npx -y rabbitmq-mcp

Related MCP server: RabbitMQ MCP Server

Environment Variables

The following environment variables are required to configure a connection to your RabbitMQ instance:

  • RABBITMQ_HOST – accessible host (e.g. test.abc.cloudamqp.com)

  • RABBITMQ_USERNAME – RabbitMQ username

  • RABBITMQ_PASSWORD – RabbitMQ password

  • RABBITMQ_MANAGEMENT_PORT – management port (e.g. 443 or 15672)

  • RABBITMQ_PROTOCOL – https (default) or http. Use https for secure connections.

Optional TLS/HTTPS Options

You can provide TLS/HTTPS credentials either as file paths or as environment variable strings:

  • RABBITMQ_CA – CA certificate (PEM string)

  • RABBITMQ_CERT – Client certificate (PEM string)

  • RABBITMQ_KEY – Client private key (PEM string)

  • RABBITMQ_CA_PATH – Path to CA certificate file

  • RABBITMQ_CERT_PATH – Path to client certificate file

  • RABBITMQ_KEY_PATH – Path to client private key file

A cert verification flag exists for debugging, if needed:

  • RABBITMQ_REJECT_UNAUTHORIZED – Set to false to disable server certificate verification (defaults to true)

MCP Client Configuration Example

As MPC is in rapid development, clients can be finicky to set up correctly. Here's an example best-case config for Claude and Cursor:

{
  "mcpServers": {
    "rabbitmq-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "rabbitmq-mcp"],
      "env": {
        "RABBITMQ_HOST": "your-host",
        "RABBITMQ_USERNAME": "your-username",
        "RABBITMQ_PASSWORD": "your-password",
        "RABBITMQ_MANAGEMENT_PORT": "15671",
        "RABBITMQ_CA_PATH": "/path/to/rabbit-cert.crt"
      }
    }
  }
}

If you experience initialization errors, you may need to use absolute paths for the command and/or args:

  "command": "/local/path/to/node",
  "args": ["/local/path/to/rabbitmq-mcp/dist/index.js"],
IMPORTANT

Currently, this server only supports running locally with stdio. Remote functionality using SSE/streaming is planned for a future update.

IMPORTANT

The management pluginmust be enabled in your RabbitMQ instance to use this server. While there are many options for interacting with RabbitMQ directly via AMQP, the protocol only provides a small subset of the capabilities available through the HTTP API.

License

MIT

Available Tools

123 tools
bulk-delete-usersC

Bulk delete users.

Inputs: users (required).

create-binding-exchange-exchangeC

Create a binding from one exchange to another.

Inputs: vhost (required), source (required), destination (required), routing_key, +1 more.

create-binding-exchange-queueC

Create a binding from an exchange to a queue.

Inputs: vhost (required), exchange (required), queue (required), routing_key, +1 more.

delete-binding-exchange-exchangeC

Delete a binding from one exchange to another.

Inputs: vhost (required), source (required), destination (required), props (required).

delete-binding-exchange-queueC

Delete a binding from an exchange to a queue.

Inputs: vhost (required), exchange (required), queue (required), props (required).

delete-connectionC

Close a specific connection.

Inputs: name (required), reason.

delete-connections-usernameA

Close all connections for a specific username. Optionally provide a reason.

Inputs: username (required), reason.

delete-exchangeC

Delete an exchange.

Inputs: vhost (required), name (required).

delete-global-parameterC

Delete a global parameter.

Inputs: name (required).

delete-operator-policyC

Delete an operator policy for a vhost.

Inputs: vhost (required), name (required).

delete-parameterB

Delete a parameter for a component in a vhost.

Inputs: component (required), vhost (required), name (required).

delete-permissionB

Delete permissions for a user in a vhost.

Inputs: vhost (required), user (required).

delete-policyC

Delete a policy for a vhost.

Inputs: vhost (required), name (required).

delete-queueC

Delete a queue

Inputs: vhost (required), name (required).

delete-stream-connectionC

Delete a specific stream connection in a vhost.

Inputs: vhost (required), name (required).

delete-topic-permissionB

Delete topic permissions for a user in a vhost.

Inputs: vhost (required), user (required).

delete-userC

Delete a user.

Inputs: name (required).

delete-user-limitB

Delete a user limit.

Inputs: user (required), name (required).

delete-vhostC

Delete a virtual host

Inputs: name (required).

delete-vhost-limitC

Delete a vhost limit for a vhost.

Inputs: vhost (required), name (required).

get-authA
Read-only

Get authentication status for the current user.

Inputs: no named parameters.

get-auth-infoA
Read-only

Get authentication info for the current user.

Inputs: no named parameters.

get-channelB
Read-only

Get details for a specific channel.

Inputs: name (required).

get-connectionB
Read-only

Get details for a specific connection.

Inputs: name (required).

get-connection-channelsB
Read-only

List all channels for a given connection.

Inputs: name (required).

get-exchangeB
Read-only

Get details for a specific exchange.

Inputs: vhost (required), name (required).

get-exchange-bindings-destinationA
Read-only

List bindings to an exchange (destination).

Inputs: vhost (required), name (required).

get-exchange-bindings-sourceB
Read-only

List bindings from an exchange (source).

Inputs: vhost (required), name (required).

get-extensionsA
Read-only

Get information about enabled RabbitMQ extensions.

Inputs: no named parameters.

get-global-parameterB
Read-only

Get a specific global parameter.

Inputs: name (required).

get-health-alarmsB
Read-only

Get health check status for alarms.

Inputs: no named parameters.

get-health-certificate-expirationC
Read-only

Get health check status for certificate expiration within a given time.

Inputs: within (required), unit (required).

get-health-local-alarmsB
Read-only

Get health check status for local alarms.

Inputs: no named parameters.

get-health-node-is-quorum-criticalB
Read-only

Get health check status for node quorum criticality.

Inputs: no named parameters.

get-health-port-listenerB
Read-only

Get health check status for a port listener.

Inputs: port (required).

get-health-protocol-listenerB
Read-only

Get health check status for a protocol listener.

Inputs: protocol (required).

get-health-virtual-hostsA
Read-only

Get health check status for all virtual hosts.

Inputs: no named parameters.

get-nodeB
Read-only

Get metrics of an individual cluster node

Inputs: name (required).

get-node-memoryC
Read-only

Get memory usage breakdown of a specific cluster node

Inputs: name (required).

get-operator-policyA
Read-only

Get a specific operator policy for a vhost.

Inputs: vhost (required), name (required).

get-parameterA
Read-only

Get a specific parameter for a component in a vhost.

Inputs: component (required), vhost (required), name (required).

get-permissionB
Read-only

Get permissions for a user in a vhost.

Inputs: vhost (required), user (required).

get-policyB
Read-only

Get a specific policy for a vhost.

Inputs: vhost (required), name (required).

get-queueB
Read-only

Get details for a specific queue

Inputs: vhost (required), name (required).

get-queue-bindingsC
Read-only

List queue bindings

Inputs: vhost (required), name (required).

get-queue-messagesC
Read-only

Get messages from a queue

Inputs: vhost (required), name (required), count, ackmode, +3 more.

get-queue-unackedC
Read-only

List unacked messages for a queue

Inputs: vhost (required), name (required).

get-rebalance-queuesB
Read-only

Get rebalance status for queues.

Inputs: no named parameters.

get-stream-connectionB
Read-only

Get details for a specific stream connection in a vhost.

Inputs: vhost (required), name (required).

get-stream-connection-consumersB
Read-only

Get all consumers for a specific stream connection in a vhost.

Inputs: vhost (required), name (required).

get-stream-connection-publishersA
Read-only

Get all publishers for a specific stream connection in a vhost.

Inputs: vhost (required), name (required).

get-topic-permissionB
Read-only

Get topic permissions for a user in a vhost.

Inputs: vhost (required), user (required).

get-userC
Read-only

Get details for a specific user.

Inputs: name (required).

get-user-limitC
Read-only

Get a user limit.

Inputs: user (required).

get-vhostA
Read-only

Get details for a specific virtual host

Inputs: name (required).

get-vhost-permissionsA
Read-only

List all permissions for a given virtual host

Inputs: name (required).

get-vhost-topic-permissionsC
Read-only

List all topic permissions for a given virtual host

Inputs: name (required).

get-whoamiA
Read-only

Get information about the current user.

Inputs: no named parameters.

hash-passwordB
Read-only

Hash a password using RabbitMQ's internal hashing.

Inputs: password (required).

list-auth-attempts-nodeB
Read-only

List all authentication attempts for a node.

Inputs: node (required).

list-auth-attempts-node-sourceC
Read-only

List all authentication attempts for a node/source.

Inputs: node (required).

list-bindingsA
Read-only

List all bindings in the RabbitMQ cluster.

Inputs: no named parameters.

list-bindings-exchange-exchangeB
Read-only

List bindings between two exchanges.

Inputs: vhost (required), source (required), destination (required).

list-bindings-exchange-queueA
Read-only

List bindings between an exchange and a queue.

Inputs: vhost (required), exchange (required), queue (required).

list-bindings-vhostB
Read-only

List all bindings for a specific vhost.

Inputs: vhost (required).

list-channelsA
Read-only

List all channels in the RabbitMQ cluster.

Inputs: no named parameters.

list-channels-connectionB
Read-only

List all channels for a given connection.

Inputs: name (required).

list-connectionsA
Read-only

List all open connections.

Inputs: no named parameters.

list-connections-usernameB
Read-only

List all open connections for a specific username.

Inputs: username (required).

list-connections-vhostA
Read-only

List all open connections in a specific virtual host.

Inputs: vhost (required).

list-consumersB
Read-only

List all consumers in the RabbitMQ cluster.

Inputs: no named parameters.

list-consumers-queueB
Read-only

List all consumers for a specific queue.

Inputs: vhost (required), queue (required).

list-consumers-vhostB
Read-only

List all consumers for a specific vhost.

Inputs: vhost (required).

list-exchangesA
Read-only

List all exchanges in the RabbitMQ cluster.

Inputs: no named parameters.

list-exchanges-vhostB
Read-only

List all exchanges for a specific vhost.

Inputs: vhost (required).

list-global-parametersA
Read-only

List all global parameters in the RabbitMQ cluster.

Inputs: no named parameters.

list-nodesA
Read-only

List all nodes in the RabbitMQ cluster with their metrics

Inputs: no named parameters.

list-operator-policiesA
Read-only

List all operator policies in the RabbitMQ cluster.

Inputs: no named parameters.

list-operator-policies-vhostB
Read-only

List all operator policies for a given vhost.

Inputs: vhost (required).

list-parametersB
Read-only

List all parameters in the RabbitMQ cluster.

Inputs: no named parameters.

list-parameters-componentB
Read-only

List all parameters for a given component.

Inputs: component (required).

list-parameters-component-vhostA
Read-only

List all parameters for a given component in a vhost.

Inputs: component (required), vhost (required).

list-permissionsA
Read-only

List all permissions in the RabbitMQ cluster.

Inputs: no named parameters.

list-policiesB
Read-only

List all policies in the RabbitMQ cluster.

Inputs: no named parameters.

list-policies-vhostA
Read-only

List all policies for a given vhost.

Inputs: vhost (required).

list-queuesA
Read-only

List all queues across all known vhosts

Inputs: no named parameters.

list-queues-vhostB
Read-only

List queues for a specific vhost

Inputs: vhost (required).

list-stream-connectionsA
Read-only

List all stream connections in the RabbitMQ cluster.

Inputs: no named parameters.

list-stream-connections-vhostA
Read-only

List all stream connections for a given vhost.

Inputs: vhost (required).

list-stream-consumersA
Read-only

List all stream consumers in the RabbitMQ cluster.

Inputs: no named parameters.

list-stream-consumers-vhostC
Read-only

List all stream consumers for a given vhost.

Inputs: vhost (required).

list-stream-publishersA
Read-only

List all stream publishers in the RabbitMQ cluster.

Inputs: no named parameters.

list-stream-publishers-vhostB
Read-only

List all stream publishers for a given vhost.

Inputs: vhost (required).

list-stream-publishers-vhost-streamB
Read-only

List all stream publishers for a stream in a vhost.

Inputs: vhost (required), stream (required).

list-topic-permissionsA
Read-only

List all topic permissions in the RabbitMQ cluster.

Inputs: no named parameters.

list-user-limitsB
Read-only

List all user limits.

Inputs: no named parameters.

list-user-permissionsC
Read-only

List all permissions for a user.

Inputs: user (required).

list-usersA
Read-only

List all users in the RabbitMQ cluster.

Inputs: no named parameters.

list-users-without-permissionsA
Read-only

List all users without permissions.

Inputs: no named parameters.

list-user-topic-permissionsB
Read-only

List all topic permissions for a user.

Inputs: user (required).

list-vhost-limitsA
Read-only

List all vhost limits in the RabbitMQ cluster.

Inputs: no named parameters.

list-vhost-limits-vhostA
Read-only

List all vhost limits for a specific vhost.

Inputs: vhost (required).

list-vhostsA
Read-only

List all virtual hosts in the cluster

Inputs: no named parameters.

pause-queueC

Pause a queue

Inputs: vhost (required), name (required).

protect-vhostB

Protect a virtual host from deletion

Inputs: name (required).

purge-queueC

Purge a queue

Inputs: vhost (required), name (required).

put-exchangeC

Create or update an exchange.

Inputs: vhost (required), name (required), type (required), durable, +3 more.

put-global-parameterC

Create or update a global parameter.

Inputs: name (required), value.

put-operator-policyC

Create or update an operator policy for a vhost.

Inputs: vhost (required), name (required), pattern (required), definition (required), +2 more.

put-parameterB

Create or update a parameter for a component in a vhost.

Inputs: component (required), vhost (required), name (required), value.

put-policyC

Create or update a policy for a vhost.

Inputs: vhost (required), name (required), pattern (required), definition (required), +2 more.

put-queueC

Create or update a queue

Inputs: vhost (required), name (required), durable, auto_delete, +1 more.

put-userC

Create or update a user.

Inputs: name (required), password, tags.

put-vhostC

Create or update a virtual host

Inputs: name (required), description, tags, default_queue_type, +2 more.

put-vhost-limitC

Set a vhost limit for a vhost.

Inputs: vhost (required), name (required), value.

resume-queueC

Resume a queue

Inputs: vhost (required), name (required).

set-permissionC

Set permissions for a user in a vhost.

Inputs: vhost (required), user (required), configure (required), write (required), +1 more.

set-topic-permissionC

Set topic permissions for a user in a vhost.

Inputs: vhost (required), user (required), exchange (required), write (required), +1 more.

set-user-limitD

Set a user limit.

Inputs: user (required), name (required), value (required).

start-vhost-on-nodeC

Start or restart a virtual host on a node

Inputs: name (required), node (required).

unprotect-vhostB

Remove deletion protection from a virtual host

Inputs: name (required).

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    B3/5.0

    Scored across 123 tools

    Disambiguation5/5

    Each tool targets a distinct resource and action, with clear naming that avoids overlap. Even similar operations like list-queues and list-queues-vhost are differentiated by scope.

    Naming Consistency5/5

    All tool names follow a consistent lowercase-hyphenated pattern: verb-resource-qualifier. No mixing of styles.

    Tool Count2/5

    123 tools is excessive. Many tools could be consolidated using parameters (e.g., list-queues vs list-queues-vhost). This volume overwhelms agents and increases selection complexity.

    Completeness5/5

    The tool set comprehensively covers RabbitMQ management: CRUD for users, vhosts, queues, exchanges, bindings, policies, parameters, connections, channels, nodes, health checks, stream connections, and more. No obvious gaps.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    Related MCP Connectors

    Related MCP Servers