ops-mcp

MCP server for managing maintenance windows across Atlassian Statuspage and Uptime Kuma from AI assistants like Claude.

Features

• Unified maintenance scheduling — create maintenance windows on both Statuspage and Uptime Kuma in a single call

• Statuspage management — create, update, and list incidents and scheduled maintenance

• Uptime Kuma management — create, end, and list maintenance windows; list monitors

• MCP protocol — works with any MCP-compatible client (Claude Desktop, Claude Code, etc.)

Tools

Setup

Install

pip install -e .

Environment variables

Copy .env.example to .env and fill in your credentials:

STATUSPAGE_API_KEY=your_statuspage_oauth_token
STATUSPAGE_PAGE_ID=your_page_id
UPTIME_KUMA_URL=https://status.example.com
UPTIME_KUMA_USERNAME=admin
UPTIME_KUMA_PASSWORD=your_password

• Statuspage API key: Generate at manage.statuspage.io under your user profile > API keys

• Statuspage page ID: Found in your page URL or page settings

• Uptime Kuma URL: The base URL of your Uptime Kuma instance

• Uptime Kuma credentials: A user with permission to manage maintenance windows

MCP client configuration

Add to your MCP client config (e.g. .mcp.json):

{
  "mcpServers": {
    "ops-mcp": {
      "command": "ops-mcp",
      "env": {
        "STATUSPAGE_API_KEY": "your_key",
        "STATUSPAGE_PAGE_ID": "your_page_id",
        "UPTIME_KUMA_URL": "https://status.example.com",
        "UPTIME_KUMA_USERNAME": "admin",
        "UPTIME_KUMA_PASSWORD": "your_password"
      }
    }
  }
}

Usage examples

Schedule maintenance on both systems:

"Schedule a 2-hour database maintenance window starting at 2am AEST tomorrow"

The ops_schedule_maintenance tool handles both Statuspage and Uptime Kuma, so monitors are silenced and subscribers are notified in one step.

List current monitors:

"Show me all Uptime Kuma monitors and their status"

Update an incident:

"Mark incident abc123 as resolved with message 'Database migration complete'"

License

MIT