Skip to main content

​
Sentinel MCP Tools

Sentinel provides MCP (Model Context Protocol) tools for AI assistants to monitor infrastructure.

​
Available Tools

​
sentinel_hosts

List all hosts with their status. 
{
  "name": "sentinel_hosts",
  "arguments": {}
}
Response: 
{
  "hosts": [
    {
      "name": "web-1",
      "status": "healthy",
      "cpu_percent": 45,
      "memory_percent": 68,
      "disk_percent": 52,
      "load_average": 1.2,
      "containers": 3,
      "last_seen": "2024-01-15T10:30:00Z"
    }
  ],
  "summary": {
    "total": 5,
    "healthy": 4,
    "warning": 1,
    "critical": 0
  }
}

​
sentinel_metrics

Get detailed metrics for a host. 
{
  "name": "sentinel_metrics",
  "arguments": {
    "host": "web-1",
    "period": "1h"
  }
}
Response: 
{
  "host": "web-1",
  "current": {
    "cpu_percent": 45,
    "memory_percent": 68,
    "disk_percent": 52,
    "load_average": 1.2
  },
  "averages": {
    "cpu_percent": 42,
    "memory_percent": 65
  },
  "peaks": {
    "cpu_percent": 78,
    "memory_percent": 82
  }
}

​
sentinel_processes

List top processes on a host. 
{
  "name": "sentinel_processes",
  "arguments": {
    "host": "web-1",
    "sort_by": "cpu",
    "limit": 10
  }
}
Response: 
{
  "processes": [
    {
      "pid": 1234,
      "name": "ruby",
      "command": "puma -w 4",
      "cpu_percent": 25.5,
      "memory_mb": 512,
      "user": "deploy"
    }
  ]
}

​
sentinel_containers

List Docker containers. 
{
  "name": "sentinel_containers",
  "arguments": {
    "host": "web-1"
  }
}
Response: 
{
  "containers": [
    {
      "name": "nginx",
      "image": "nginx:latest",
      "status": "running",
      "cpu_percent": 2.5,
      "memory_mb": 64,
      "uptime": "5d 12h"
    }
  ]
}

​
sentinel_alerts

List active infrastructure alerts. 
{
  "name": "sentinel_alerts",
  "arguments": {}
}
Response: 
{
  "alerts": [
    {
      "id": "alert_abc123",
      "host": "api-1",
      "metric": "memory",
      "current_value": 92,
      "threshold": 90,
      "status": "warning",
      "triggered_at": "2024-01-15T10:25:00Z"
    }
  ]
}

​
Example Conversations

User: “How are our servers doing?” Assistant uses: sentinel_hosts Response: “Your infrastructure looks healthy. 4 of 5 hosts are in good shape. web-1 is at 45% CPU, 68% memory. api-1 has a warning - memory is at 85%.”
User: “What’s using memory on api-1?” Assistant uses: sentinel_processes with host: "api-1", sort_by: "memory" Response: “The top memory consumers on api-1 are: Ruby/Puma at 2.1GB, PostgreSQL at 512MB, and Redis at 256MB.”
User: “Are all our containers running?” Assistant uses: sentinel_containers Response: “All 8 containers across your hosts are running. The nginx containers are using minimal resources. The api-server containers are at 45% of their memory limits.”

​
Setup

Add Sentinel MCP to your Claude Desktop or Cursor configuration: 
{
  "mcpServers": {
    "brainzlab-sentinel": {
      "command": "npx",
      "args": ["-y", "@brainzlab/mcp-server"],
      "env": {
        "BRAINZLAB_SECRET_KEY": "your-secret-key",
        "BRAINZLAB_PRODUCTS": "sentinel"
      }
    }
  }
}