How do I install the mcp server?

Use a recorded configuration for your client, replace example credential values and paths, and verify the documented runtime. Restart or reconnect the client, then inspect the available tools.

What credentials does it need?

It reads `UPTIME_KUMA_URL`, `UPTIME_KUMA_USERNAME`, `UPTIME_KUMA_PASSWORD`, `UPTIME_KUMA_2FA_TOKEN`, `UPTIME_KUMA_JWT_TOKEN` from the environment. Store these in your client's env block or a secrets manager — never commit them to a repository — and grant the narrowest scope that still covers your use case.

SSyncDev

Start a project

MCP Server — DavidFuchs/mcp-uptime-kuma

A Model Context Protocol (MCP) server for Uptime Kuma version 2.

Local serverstdioTypeScript

What is the MCP Server?

A Model Context Protocol (MCP) server for Uptime Kuma version 2.

What it actually does

A docker-compose.yml file is provided in the repository. Download it, configure your environment variables, and run:

Real-time Monitoring — Access monitors, heartbeats, uptime, and responsiveness metrics via Socket.IO with instant status change notifications
Context-Friendly — Returns only essential data by default to avoid overwhelming LLM context windows
Multiple Transports — Supports stdio (local) and streamable HTTP (remote) transports

More MCP options

Compare MCP servers by category, or browse hosted MCP servers if you prefer an endpoint over a local process.

How to install the MCP Server

{
  "mcpServers": {
    "uptime-kuma": {
      "command": "npx",
      "args": ["-y", "@davidfuchs/mcp-uptime-kuma"],
      "env": {
        "UPTIME_KUMA_URL": "http://your-uptime-kuma-instance:3001",
        "UPTIME_KUMA_USERNAME": "your_username",
        "UPTIME_KUMA_PASSWORD": "your_password"
      }
    }
  }
}

Configuration as documented by the project. Restart the client after saving.

Configuration

Variable	Description	Required
UPTIME_KUMA_URL	Endpoint or connection string the server talks to.	Yes
UPTIME_KUMA_USERNAME	Configuration value read at startup.	Optional
UPTIME_KUMA_PASSWORD	Configuration value read at startup.	Optional
UPTIME_KUMA_2FA_TOKEN	Credential the server authenticates with.	Yes
UPTIME_KUMA_JWT_TOKEN	Credential the server authenticates with.	Yes

Example prompts to try

“Use MCP to Monitors.”
“Use MCP to Heartbeats.”
“Use MCP to Notifications.”

Frequently asked questions

A Model Context Protocol (MCP) server for Uptime Kuma version 2. Confirm the tools offered by your installed version in the connected client. Tool availability and permissions depend on the server and account configuration.

Alternatives to the MCP Server

Chrome DevTools

Official

Give your coding agent the full DevTools toolbox: traces, network, console, heap snapshots and Lighthouse.

Browser AutomationTypeScript★ 48.4k

Cloudflare

Official

Workers, KV, R2 and D1 by conversation — Cloudflare's official remote servers for building and observability.

Cloud & DevOpsRemoteTypeScript★ 2.9k

MCP Prometheus

An [MCP (Model Context Protocol)][mcp] server for Prometheus and Mimir, written in Go. Deployed in-cluster at Giant Swarm to give AI assistants

Monitoring & ObservabilityRemoteGo

Exit1 Uptime Monitoring

MCP server for Exit1 uptime monitoring. Let your AI assistant set up monitoring for the project you just shipped — read your repo, create the checks, configure alerts, and send a real test alert to…

Monitoring & ObservabilityRemote

Boosthis

Read-only performance insights for your Boosthis projects: speed, crashes, traces, and fixes.