# bussin-mcp

Inspect Azure Service Bus queues, search message contents, and replay dead-lettered messages through an MCP client. Write operations require explicit flags.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 5
- Author: sgebb
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/sgebb/bussin/tree/HEAD/mcp-server
- Updated: 2026-10-24
- HTML: https://affpapa.org/en/nevibecode/mcp/bussin-mcp

## What it does

bussin-mcp connects an AI client to Azure Service Bus. It can list namespaces, queues, topics, and subscriptions, inspect messages without taking a lock, and search by body text, message ID, or subject. The default tool set is read-only.

Sending or replaying messages requires `--allow-send`; deleting messages and purging an entity require `--allow-destructive`. Scans and purges are bounded by `--search-timeout-ms`, and each message body is cut off at 4000 characters. For Entra ID, the server uses `DefaultAzureCredential`. Resource listing needs the Reader role, while message inspection needs Azure Service Bus Data Receiver. The built-in simulator runs with `--demo`, without an Azure account.

Add the server to Claude Code with `claude mcp add`. The supplied install command sets `YOUR_API_KEY`, while the server documentation describes Azure authentication through Entra ID or a SAS connection string. Check which credential setup applies before connecting.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `YOUR_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add bussin-mcp -e YOUR_API_KEY=<YOUR_API_KEY> -- npx -y bussin-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add mcp-server --env YOUR_API_KEY=<YOUR_API_KEY> -- npx -y bussin-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "bussin-mcp"
            ],
            "env": {
                "YOUR_API_KEY": "<YOUR_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "bussin-mcp"
            ],
            "env": {
                "YOUR_API_KEY": "<YOUR_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e YOUR_API_KEY=<YOUR_API_KEY> mcp-server npx -y bussin-mcp
```
Replace <…> with your own values

## When to use it
- inspect dead-letter counts across queues
- search messages by body text, ID, or subject
- read messages without locking or consuming them
- replay selected dead-letter messages to their source queue
- purge a queue after enabling destructive access

## Example prompts
- Show me which Azure Service Bus queues have dead-letter messages.
- Search the subscription for messages whose body mentions `timeout`.
- Replay the selected dead-letter messages to their source queue.

## Similar
- [mcp-server](https://affpapa.org/en/nevibecode/mcp/mcp-server.md) — MCP server · ★ 43902
- [Coder](https://affpapa.org/en/nevibecode/mcp/coder.md) — MCP server · ★ 17191
- [firebase-mcp](https://affpapa.org/en/nevibecode/mcp/firebase-mcp.md) — MCP server · ★ 4482
- [Radar Kubernetes MCP Server](https://affpapa.org/en/nevibecode/mcp/radar-kubernetes-mcp-server.md) — MCP server · ★ 3918
- [Supabase](https://affpapa.org/en/nevibecode/mcp/supabase.md) — MCP server · ★ 2974
- [Microsoft Fabric MCP Server](https://affpapa.org/en/nevibecode/mcp/microsoft-fabric-mcp-server.md) — MCP server · ★ 3804

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md