# Sentinal

> Redis health, BullMQ queue monitoring, memory analysis, and slow query diagnostics

- **Type:** MCP server
- **Install:** `agentstack add mcp-musaraf-m-sentinal`
- **Verified:** Pending review
- **Seller:** [Musaraf-M](https://agentstack.voostack.com/s/musaraf-m)
- **Installs:** 0
- **Latest version:** 1.0.0
- **License:** MIT
- **Upstream author:** [Musaraf-M](https://github.com/Musaraf-M)
- **Source:** https://github.com/Musaraf-M/sentinal

## Install

```sh
agentstack add mcp-musaraf-m-sentinal
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# Sentinal

[](https://www.npmjs.com/package/@md-musaraf/sentinal-mcp)
[](https://glama.ai/mcp/servers/Musaraf-M/sentinal)
[](https://opensource.org/licenses/MIT)

Infrastructure monitoring tools for AI assistants. One codebase, multiple platforms.

Ask your AI assistant to check Redis health, inspect BullMQ queues, diagnose slow queries — all through natural conversation.

## Platforms

| Platform | Distribution | Install |
|---|---|---|
| **Claude, Cursor, Copilot, Cline, Warp, Gemini CLI** | MCP Server (npm) | `npx @md-musaraf/sentinal-mcp` |
| **OpenClaw** | ClawHub | `clawhub install sentinal-redis` |
| **ChatGPT** | GPT Store | Coming soon |
| **Raycast** | Raycast Store | Coming soon |

## Modules

| Module | Status | What it monitors |
|---|---|---|
| **Redis** | ✅ Ready | Server health, memory, slow queries, clients, BullMQ queues |
| **Docker** | 🔜 Planned | Container health, logs, resource usage |
| **Kubernetes** | 🔜 Planned | Pod status, restart counts, resource limits |
| **GitHub Actions** | 🔜 Planned | Workflow runs, failures, re-triggers |
| **Vercel** | 🔜 Planned | Deployment status, rollbacks |

## MCP Server

Works with any AI tool that supports [Model Context Protocol](https://modelcontextprotocol.io) — Claude Desktop, Claude Code, Cursor, GitHub Copilot, Cline, Warp, Gemini CLI, Continue, and more.

### Install

Add to your MCP client config:

```json
{
  "mcpServers": {
    "sentinal": {
      "command": "npx",
      "args": ["@md-musaraf/sentinal-mcp"],
      "env": {
        "REDIS_URL": "redis://localhost:6379"
      }
    }
  }
}
```

### Tools

| Tool | Description |
|---|---|
| `redis_ping` | Test connectivity to a Redis instance |
| `redis_health` | Full health report — server, memory, clients, slow queries, BullMQ queues |
| `redis_memory` | Deep memory analysis with fragmentation diagnostics |
| `redis_slowlog` | Inspect slow queries |
| `bullmq_list` | List all BullMQ queues with job counts per state |
| `bullmq_failed_jobs` | Inspect failed jobs with payloads and stack traces |
| `bullmq_job_details` | Full details of a specific job |
| `bullmq_stale_jobs` | Find jobs stuck in active state |

### Example Usage

Just ask your AI assistant:

- *"Check my Redis health"*
- *"Are any BullMQ queues backing up?"*
- *"Show me failed jobs in the email-queue"*
- *"Why is Redis slow?"*
- *"How much memory is Redis using?"*
- *"Find stale jobs in the payment-queue"*

## OpenClaw Skills

Install individual skills from [ClawHub](https://clawhub.ai):

```bash
clawhub install sentinal-redis
```

The skill teaches your OpenClaw assistant to monitor Redis and BullMQ using `redis-cli`. No code required — just install and ask.

## Project Structure

```
sentinal/
├── core/                     # Shared knowledge and scripts
│   ├── redis/
│   ├── docker/
│   └── kubernetes/
├── platforms/
│   ├── mcp/                  # MCP Server → npm
│   ├── openclaw/             # OpenClaw Skills → ClawHub
│   ├── chatgpt/              # Custom GPT → GPT Store
│   └── raycast/              # Extension → Raycast Store
└── scripts/                  # Build and publish automation
```

## Development

### Prerequisites

- Node.js 22+
- pnpm 10+

### Setup

```bash
git clone https://github.com/Musaraf-M/sentinal.git
cd sentinal
pnpm install
```

### Build

```bash
pnpm build
```

### Run MCP server locally

```bash
node platforms/mcp/dist/index.js
```

## Contributing

Contributions are welcome! Areas where help is needed:

- New monitoring modules (Docker, Kubernetes, GitHub Actions)
- New platform adapters
- Bug fixes and improvements

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [Musaraf-M](https://github.com/Musaraf-M)
- **Source:** [Musaraf-M/sentinal](https://github.com/Musaraf-M/sentinal)
- **License:** MIT

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Versions

- **1.0.0** — security scan: pending review — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-musaraf-m-sentinal
- Seller: https://agentstack.voostack.com/s/musaraf-m
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.