MCP Server for Uptime Kuma
Connects Claude to your Uptime Kuma v2 instance for monitoring management and status checks. Exposes tools to create, update, pause, and delete monitors across all supported types (HTTP, ping, DNS, etc.), plus CRUD operations for notifications, tags, and maintenance windows. Pulls real-time heartbeat data and monitor summaries with filtering by status, type, tags, and keywords. Works over stdio locally or streamable HTTP for remote deployments. Ships with a CLI utility to grab JWT tokens for 2FA setups. Useful when you want Claude to check service health, investigate outages, or manage monitoring configuration without switching to the Uptime Kuma UI.
- GitHub stars
- 70
- tools
- 26
- auth
- Secret needed
- transport
- STDIO, HTTP
- env vars
- 14
- last updated
- Nov 12, 2026
Tools
26 toolsPublic tool metadata for what this MCP can expose to an agent.
getMonitorSummaryGet a quick overview of all monitors with their current status. Supports filtering.
Get a quick overview of all monitors with their current status. Supports filtering.
No parameter schema in public metadata yet.
listMonitorsGet the full list of all monitors with configurations. Supports filtering.
Get the full list of all monitors with configurations. Supports filtering.
No parameter schema in public metadata yet.
listMonitorTypesGet all available monitor types supported by Uptime Kuma.
Get all available monitor types supported by Uptime Kuma.
No parameter schema in public metadata yet.
getMonitorGet detailed configuration for a specific monitor by ID.
Get detailed configuration for a specific monitor by ID.
No parameter schema in public metadata yet.
createMonitorCreate a new monitor (requires name and type at minimum).
Create a new monitor (requires name and type at minimum).
No parameter schema in public metadata yet.
updateMonitorUpdate an existing monitor's configuration.
Update an existing monitor's configuration.
No parameter schema in public metadata yet.
deleteMonitorPermanently delete a monitor and all its heartbeat history.
Permanently delete a monitor and all its heartbeat history.
No parameter schema in public metadata yet.
pauseMonitorPause a monitor to stop performing checks.
Pause a monitor to stop performing checks.
No parameter schema in public metadata yet.
resumeMonitorResume a paused monitor to restart checks.
Resume a paused monitor to restart checks.
No parameter schema in public metadata yet.
listHeartbeatsGet status check history for all monitors.
Get status check history for all monitors.
No parameter schema in public metadata yet.
getHeartbeatsGet status check history for a specific monitor.
Get status check history for a specific monitor.
No parameter schema in public metadata yet.
listNotificationsList all configured notification channels (Slack, Discord, email, webhooks, etc.).
List all configured notification channels (Slack, Discord, email, webhooks, etc.).
No parameter schema in public metadata yet.
addNotificationCreate a new notification channel.
Create a new notification channel.
No parameter schema in public metadata yet.
updateNotificationUpdate an existing notification channel.
Update an existing notification channel.
No parameter schema in public metadata yet.
deleteNotificationPermanently delete a notification channel.
Permanently delete a notification channel.
No parameter schema in public metadata yet.
listTagsList all tags defined in Uptime Kuma.
List all tags defined in Uptime Kuma.
No parameter schema in public metadata yet.
addTagCreate a new tag that can be assigned to monitors.
Create a new tag that can be assigned to monitors.
No parameter schema in public metadata yet.
deleteTagPermanently delete a tag (removes it from all monitors).
Permanently delete a tag (removes it from all monitors).
No parameter schema in public metadata yet.
getMaintenanceWindowsList all maintenance windows, with the monitors each one covers.
List all maintenance windows, with the monitors each one covers.
No parameter schema in public metadata yet.
createMaintenanceSchedule a new maintenance window and attach the monitors it suppresses.
Schedule a new maintenance window and attach the monitors it suppresses.
No parameter schema in public metadata yet.
updateMaintenanceChange a maintenance window's schedule, details, or monitor list.
Change a maintenance window's schedule, details, or monitor list.
No parameter schema in public metadata yet.
pauseMaintenanceSwitch a maintenance window off (ends a manual window).
Switch a maintenance window off (ends a manual window).
No parameter schema in public metadata yet.
resumeMaintenanceSwitch a paused maintenance window back on (starts a manual window).
Switch a paused maintenance window back on (starts a manual window).
No parameter schema in public metadata yet.
deleteMaintenancePermanently delete a maintenance window.
Permanently delete a maintenance window.
No parameter schema in public metadata yet.
listStatusPagesList all configured status pages.
List all configured status pages.
No parameter schema in public metadata yet.
getSettingsGet Uptime Kuma server settings.
Get Uptime Kuma server settings.
No parameter schema in public metadata yet.
Sponsors
Agent CaffeineSponsoredClose your lid, come back to finished work
SnugSponsoredThe clipboard manager for the AI eraPromote your product hereReach 125k+ visitors monthly
WaxSponsoredBlock anything with supervision, without erasing your iPhonePromote your product hereReach 125k+ visitors monthly
knobsSponsoredSee your site on any phone, any day, in any languageConfiguration
UPTIME_KUMA_URL*The URL of your Uptime Kuma instance
UPTIME_KUMA_USERNAMEYour Uptime Kuma username (not required if using JWT token authentication or if authentication is disabled)
UPTIME_KUMA_PASSWORDsecretYour Uptime Kuma password (not required if using JWT token authentication or if authentication is disabled)
UPTIME_KUMA_2FA_TOKENsecretYour 2FA token (only required if two-factor authentication is enabled on your account)
UPTIME_KUMA_JWT_TOKENsecretYour JWT token for authentication (takes precedence over username/password if provided)
UPTIME_KUMA_HEADERSsecretJSON object of extra HTTP headers sent on every request to Uptime Kuma, for reaching it through an authenticating proxy such as Cloudflare Access (e.g. {"CF-Access-Client-Id":"...","CF-Access-Client-Secret":"..."})
UPTIME_KUMA_INCLUDE_SECRETSSet to true to return credentials (passwords, tokens, auth headers) unredacted in tool output; by default they read "***"
UPTIME_KUMA_READ_ONLYSet to true to expose only the tools that report, and none that create, change, pause or delete
MCP_AUTH_TOKEN*secretShared secret clients must send as "Authorization: Bearer <token>"; requests without it are rejected
PORTdefault: 3000Port the HTTP server listens on
HOSTdefault: 0.0.0.0Address to bind. Default 0.0.0.0; use 127.0.0.1 to accept local connections only
ALLOWED_ORIGINComma-separated origins allowed to call /mcp. Default * (no Origin validation)
RATE_LIMIT_MAXdefault: 1000Requests allowed per client IP every 15 minutes. 0 turns the limit off
TRUST_PROXYTrust reverse-proxy X-Forwarded-For headers for rate limiting: a hop count (1), true/false, or an IP/subnet list. Unset = no trust
Readme
mcp-uptime-kuma
A Model Context Protocol (MCP) server for Uptime Kuma version 2. Supports stdio and streamable HTTP transports.
Details
- Repository
- github.com/davidfuchs/mcp-uptime-kuma
- Website
- github.com/DavidFuchs/mcp-uptime-kuma#readme
- Categories
- AI & LLM Tools, Monitoring & Observability
- Package
@davidfuchs/mcp-uptime-kuma- Transport
- STDIO, HTTP
- Auth
- Required
- Registry
- MCP registry, active
Related AI & LLM Tools MCP servers
View all
Agent360 Browser MCPagent360dk/browser-mcpDrive your real, logged-in Chrome from any AI agent - 40 tools. Needs our Chrome extension too.62stars
CtxVaultfilippo-venturini/ctxvaultLocal memory for AI agents: semantic, skill and episodic vaults as plain folders on disk.62stars
Markifact - Ads & Analyticsmarkifact/markifact-mcpAI marketing agent for Google Ads, Meta, GA4, TikTok, LinkedIn, Shopify, HubSpot and more.57stars
Openaffiliate Mcpaffitor/open-affiliateSearch and discover affiliate programs with agent-ready data and commission details.55stars
Mcpwaystation-ai/mcpUltimate toolbox to connect your LLM to popular productivity tools such as Monday, AirTable, Slack0stars
Ekwo OS — open source accounting: ledger, invoices and VAT on your own Supabase or Postgresekwo-ai/ekwo-osDouble-entry books an agent keeps as the user: invoices, VAT returns, 174 country packs.41stars