Skip to main content
Glama
Camusama

uptime-kuma-mcp-server

by Camusama
README.md
# Uptime Kuma MCP Server

A server for managing Uptime Kuma monitors via MCP protocol.

## Installation

```bash
uvx uptime-kuma-mcp-server
```

```json
"mcpServers": {
  "uptime-kuma-mcp-server": {
    "command": "uvx",
    "args": ["uptime-kuma-mcp-server"],
    "env": {
      "KUMA_URL": "https://yourdomain.xyz",
      "KUMA_USERNAME": "username",
      "KUMA_PASSWORD": "passwd"
    }
  },
}
```

## Available Tools

- `add_monitors` - Batch add multiple monitors to Uptime Kuma, returns Uptime Kuma page URLs after completion
  - `urls` (list[str], required): List of monitor URLs (must be deduplicated and include full protocol, e.g. https://bing.com)
- `get_monitors` - Get all monitors list, returns trimmed fields to prevent context overflow
- `delete_monitors` - Batch delete multiple monitors
  - `ids` (list[int], required): List of monitor IDs to delete

## Run SSE

create .env

```bash
KUMA_URL=url
KUMA_USERNAME=username
KUMA_PASSWORD=pass
FASTMCP_HOST=0.0.0.0
FASTMCP_HOST=8000
```

```python
# run_sse.py

from uptime_kuma_mcp_server import run_sse

run_sse()

#  Uvicorn running on http://0.0.0.0:8000
```

TDQS

A3.9/5.0

Scored across 3 tools

Disambiguation5/5

Each tool has a distinct purpose: adding, deleting, or getting monitors. There is no overlap.

Naming Consistency5/5

All tools follow a consistent verb_noun pattern (add_monitors, delete_monitors, get_monitors).

Tool Count4/5

3 tools is slightly minimal but reasonably scoped for basic monitor management.

Completeness3/5

Missing an update operation for monitors, which is a notable gap in CRUD coverage.

Maintenance

ActivityInactive
ResponsivenessNo issues