mcpField
U
Uptime Kuma MCP Server

Uptime Kuma MCP Server

Local
github.com/CamusamaCloud & Infra9Updated 72w ago
Repository

About Uptime Kuma MCP Server

Uptime Kuma MCP Server lets users manage Uptime Kuma monitors through MCP, with tools for batch creation, listing, and deletion.

Key features

  1. 01Batch-add monitors
  2. 02List monitors with trimmed fields
  3. 03Batch-delete monitors
  4. 04Return monitor page URLs

Use cases

  1. 01Add multiple website monitors
  2. 02Review existing monitors
  3. 03Remove monitors by ID in batches

MCP support

It exposes Uptime Kuma monitor creation, listing, and deletion tools to MCP clients.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "uptime-kuma": {
      "command": "uvx",
      "args": [
        "uptime-kuma-mcp-server"
      ]
    }
  }
}
Run commanduvx uptime-kuma-mcp-server

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
pypiuptime-kuma-mcp-server

Tools

No tool list yet

Local servers expose tools only once running on your machine, and the maintainer has not provided a tool list.

Details

From the project README

Uptime Kuma MCP Server

A server for managing Uptime Kuma monitors via MCP protocol.

Installation

uvx uptime-kuma-mcp-server

"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

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

# run_sse.py

from uptime_kuma_mcp_server import run_sse

run_sse()

#  Uvicorn running on http://0.0.0.0:8000

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.