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