Use UptimeMonitoring through MCP

What is MCP

Model Context Protocol (MCP) lets AI agents interact with external tools. UptimeMonitoring’s MCP server lets any compatible agent create, inspect, and manage monitors using natural language.

Available tools

Tool	Description	Read-only
`list_monitors`	List all monitors with current status	Yes
`get_monitor`	Get monitor details + recent evidence	Yes
`create_monitor`	Create a new monitor	No
`update_monitor`	Update monitor configuration	No
`delete_monitor`	Delete a monitor	No (destructive)
`list_incidents`	Query incidents with filtering	Yes
`assert_monitor_healthy`	Check if monitor is healthy (for deploy gates)	Yes
`get_account_status`	Usage against caps	Yes

Tool annotations

Tool	title	readOnlyHint	destructiveHint	idempotentHint	openWorldHint
`list_monitors`	”List Monitors”	`true`	`false`	`false`	`true`
`get_monitor`	”Get Monitor”	`true`	`false`	`false`	`true`
`list_incidents`	”List Incidents”	`true`	`false`	`false`	`true`
`assert_monitor_healthy`	”Assert Monitor Healthy”	`true`	`false`	`false`	`true`
`get_account_status`	”Get Account Status”	`true`	`false`	`false`	`true`
`create_monitor`	”Create Monitor”	`false`	`true`	`false`	`true`
`update_monitor`	”Update Monitor”	`false`	`true`	`false`	`true`
`delete_monitor`	”Delete Monitor”	`false`	`true`	`true`	`true`

openWorldHint: true reflects that all tools make external API calls. idempotentHint: true is set only on delete_monitor — repeating the call after the monitor is gone produces the same result.

Auth model

The MCP endpoint accepts Bearer credentials: API keys, session tokens, and OAuth access tokens. Which credential you configure depends on the host.

OAuth-based connector hosts such as Claude.ai, Claude Desktop, and ChatGPT should use the OAuth flow when prompted. Config-file and API clients such as Claude Code, Cursor, and the OpenAI API can pass an OAuth access token or a custom Authorization header when the host supports custom headers.

OAuth 2.1 discovery endpoints are published at https://api.uptimemonitoring.com/.well-known/oauth-authorization-server (authorization server metadata) and https://api.uptimemonitoring.com/.well-known/oauth-protected-resource/mcp (protected resource metadata for the MCP endpoint).

For API-key setups, use the same key as the REST API:

Authorization: Bearer umk_live_...

Create a dedicated key labeled mcp for API-key based agent setups.

Example

User:
Create a monitor for https://example.com/healthz
and tell me whether it is healthy right now.

Agent:
I'll create the monitor and check its status.

Tool: create_monitor
Result: Monitor created (id: 1287, name: "example-healthz")

Tool: assert_monitor_healthy
Result: Healthy — EU, 200, ttfb 184ms

Discovery

UptimeMonitoring’s MCP server is listed in the Official MCP Registry under com.uptimemonitoring/mcp. MCP-aware tools that auto-discover servers from the registry can install it without any manual configuration; the registry entry carries the canonical transport, endpoint, and auth metadata.

Host compatibility

Manually maintained pre-release — open an issue if your host should be listed.

Host	Transport	Auth	Status
Claude.ai	Remote MCP connector	OAuth	✅
Claude Desktop	Remote MCP connector	OAuth	✅
Claude Code	Remote MCP HTTP	OAuth / Bearer header	✅
ChatGPT	Custom MCP connector	OAuth	✅ Listed on ChatGPT app store
Cursor	MCP config	OAuth / Bearer header	✅
OpenAI API	Responses MCP	OAuth token / custom headers	✅

Last verified: 2026-05-26.

Listed in registries

⏳ GitHub MCP Registry — submission pending 2026-05-19 (#26)
⏳ Official MCP Registry — server.json shipped 2026-05-19 (#25), external submission PR pending

Support

Questions or issues with the MCP server? Email hello@uptimemonitoring.com.

Host-specific setup

Claude.ai

In Claude.ai, open Customize → Connectors, add a custom connector, and enter:

https://api.uptimemonitoring.com/mcp

Complete the OAuth flow when Claude prompts you to connect your UptimeMonitoring account.

Claude Desktop

In Claude Desktop, add UptimeMonitoring through Settings → Connectors as a custom remote MCP connector:

https://api.uptimemonitoring.com/mcp

Complete the OAuth flow when Claude prompts you to connect your UptimeMonitoring account. Remote MCP servers in Claude Desktop should be added through Connectors, not claude_desktop_config.json.

Claude Code

OAuth or Bearer header via claude mcp add. Full install steps, verification, and common errors: Connect Claude Code.

ChatGPT

OAuth via the ChatGPT connector UI. Listed on the ChatGPT app store. Full install steps, verification, and common errors: Connect ChatGPT.

Cursor

Bearer header or OAuth via mcp.json. Full install steps, verification, and common errors: Connect Cursor.

OpenAI API

MCP tool in Responses API calls, API key or OAuth token. Full install steps, verification, and common errors: Connect via OpenAI API.