systemoverwatch-mcp

Claude MCP server for System Overwatch — query your alerts, incidents, monitors and metrics in plain language from Claude Desktop.

Example prompts:

• "Is anything on fire right now?"
• "Acknowledge incident 42"
• "Show me the last 24 hours of the request-latency series"
• "Which monitors are currently in a CRITICAL state?"
• "Annotate the cpu-usage series at 14:30: deployed v2.3"

Setup

1. Generate a personal access token

In System Overwatch, go to Integrations and generate a personal access token. Copy the token — it is shown only once.

2. Configure Claude Desktop

Add one of the following to your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json on macOS, %APPDATA%\Claude\claude_desktop_config.json on Windows):

Option A — Remote (recommended, no local install needed):

{
  "mcpServers": {
    "systemoverwatch": {
      "url": "https://systemoverwatch.com/mcp",
      "headers": {
        "Authorization": "Bearer qam_pat_your-token-here"
      }
    }
  }
}

Option B — Local via npx (requires Node.js 20+):

{
  "mcpServers": {
    "systemoverwatch": {
      "command": "npx",
      "args": ["-y", "systemoverwatch-mcp"],
      "env": {
        "QAM_API_TOKEN": "qam_pat_your-token-here"
      }
    }
  }
}

Restart Claude Desktop. The System Overwatch tools will appear automatically.

Tools

| Tool | Description | |---|---| | list_organizations | List orgs you have access to | | get_organization_summary | Quick health snapshot: firing alerts, open incidents, critical monitors | | list_monitors | Monitor states for an org | | list_alerts | Alerts with optional status/severity/time filters | | list_incidents | Incidents with optional status filter (OPEN/ACKNOWLEDGED/RESOLVED) | | acknowledge_incident | Acknowledge an open incident | | resolve_incident | Resolve an incident | | add_incident_comment | Log investigation notes on an incident | | list_series | Available metrics with latest value | | get_series_data | Fetch data points with time range and limit; ignored points flagged | | list_annotations | Chart annotations for a series or org, with time range filter | | create_annotation | Mark an event on a series chart |

Environment variables

| Variable | Description | |---|---| | QAM_API_TOKEN | Personal access token generated in the UI (required) | | QAM_BASE_URL | Override the API URL (default: https://systemoverwatch.com) |