Edit

Share via

Azure Service Bus tools for the Azure MCP Server

The Azure MCP Server allows you to manage Azure Service Bus resources, including queues and topics with natural language prompts. You can peek at messages and view message details without specialized knowledge of messaging protocols.

Azure Service Bus is a fully managed enterprise message broker with message queues and publish-subscribe topics. Service Bus is used to decouple applications and services from each other.

Note

The Azure MCP Server tools define parameters for data they need to complete tasks. Some of these parameters are specific to each tool and are documented below. Other parameters are global and shared by all tools. For more information, see Tool parameters.

Get queue runtime details

The Azure MCP Server can retrieve runtime details about a Service Bus queue, including its message count and status.

Example prompts include:

  • Details queue: "Show me details about the 'orders' queue in my 'app-messaging' namespace."
  • Queue info: "What's the status of queue 'notifications' in namespace 'messaging-hub'?"
  • Check queue: "Get details for my 'user-events' queue"
  • Queue status: "Show me message count for the orders queue"
Parameter Required or optional Description
Subscription Required The Azure subscription ID or name.
Namespace Required The fully qualified Service Bus namespace host name.
Queue name Required The queue name to get details for.

Get topic runtime details

The Azure MCP Server can retrieve runtime details about a Service Bus topic, including its subscription count and status.

Example prompts include:

  • Details topic: "Show me runtime details about the 'product-events' topic in my 'retail-messaging' namespace."
  • Topic info: "What's the runtime status of topic 'system-updates' in namespace 'app-messaging'?"
  • Check topic: "Get details for my 'notifications' topic"
  • Topic status: "Show me subscription count for the events topic"
  • View topic: "Tell me about the broadcast-topic runtime in my service bus"
Parameter Required or optional Description
Subscription Required The Azure subscription ID or name.
Namespace Required The fully qualified Service Bus namespace host name.
Topic name Required The name of the topic to get information about.

Get topic subscription runtime details

The Azure MCP Server can retrieve runtime details about a subscription within a Service Bus topic, including message counts.

Example prompts include:

  • Details subscription: "Show me details about the 'mobile-app' subscription in topic 'notifications'."
  • Subscription info: "What's the status of subscription 'admin' in topic 'system-updates'?"
  • Check subscription: "Get message count for my 'premium-users' subscription in the 'offers' topic"
  • Subscription status: "Show me details for the email-service subscription"
  • View subscription: "Tell me about the analytics subscription in my events topic"
Parameter Required or optional Description
Subscription Required The Azure subscription ID or name.
Namespace Required The fully qualified Service Bus namespace host name.
Topic name Required The name of the topic containing the subscription.
Topic subscription name Required The name of the topic subscription to get details for.

Peek at queue messages

The Azure MCP Server can peek at messages in a Service Bus queue without removing them.

Example prompts include:

  • Peek queue: "Show me messages in the 'orders' queue in my 'app-messaging' namespace."
  • View messages: "What messages are in queue 'notifications' right now?"
  • Check messages: "Let me see the first 5 messages in my 'user-events' queue"
  • Preview queue: "Show me what's in the processing queue without removing messages"
  • Read queue: "Look at messages in my orders queue"
Parameter Required or optional Description
Subscription Required The Azure subscription ID or name.
Namespace Required The fully qualified Service Bus namespace host name.
Queue name Required The queue name to peek messages from.
Max messages Optional The maximum number of messages to retrieve.

Peek at topic subscription messages

The Azure MCP Server can peek at messages in a subscription within a Service Bus topic without removing them.

Example prompts include:

  • Peek subscription: "Show me messages in the 'mobile-app' subscription of topic 'notifications'."
  • View subscription messages: "What messages are in subscription 'admin' of topic 'system-updates'?"
  • Check subscription messages: "Let me see the messages in my 'premium-users' subscription"
  • Preview subscription: "Show me what's in the email-service subscription without removing messages"
  • Read subscription: "Look at messages in my analytics subscription"
Parameter Required or optional Description
Subscription Required.The Azure subscription ID or name.
Namespace Required.The fully qualified Service Bus namespace host name.
Topic name Required.The name of the topic containing the subscription.
Topic subscription name Required.The name of topic subscription to peek messages from.
Max messages Optional The maximum number of messages to retrieve.

Related content