MCP server

The Oh Dear MCP server lets AI assistants query your monitoring data and manage maintenance windows directly through the Model Context Protocol. Ask questions about your monitors, uptime, broken links, DNS, performance, sitemaps, and more, in natural language.

Connect #

Add this URL to your AI client as an MCP server (or "Custom Connector"):

https://ohdear.app/mcp

The client will redirect you to Oh Dear. You log in (if you aren't already), pick which teams to share, and choose which permissions to grant. After approving, you're bounced back to your client and the connection is live.

The connection appears under Connected AI assistants, where you can revoke it any time.

Claude.ai (web) #

In Claude.ai, open Settings, Custom Connectors, and add the URL above. Claude.ai walks you through the OAuth approval.

Claude Code #

claude mcp add --transport http ohdear https://ohdear.app/mcp

Claude Code opens the OAuth flow on first use.

Claude Desktop, Cursor, VS Code, others #

These clients reach our server through mcp-remote, which handles OAuth automatically. Example for Claude Desktop:

{
  "mcpServers": {
    "ohdear": {
      "command": "npx",
      "args": ["-y", "mcp-remote", "https://ohdear.app/mcp"]
    }
  }
}

Save the file and restart Claude Desktop. The first request opens a browser window for OAuth approval; after that, the token is stored locally and reused.

Permissions #

The consent screen offers two scopes:

• Read access (always granted): read your monitors, uptime, broken links, DNS, performance, sitemaps, cron checks, and existing maintenance windows.
• Write access (opt-in): create, update, and delete monitors, monitor settings, status pages, and recurring maintenance windows.

You can grant access to one or more teams in a single approval. Tools take a team_id argument when more than one is granted.

What you can do #

Examples:

• "Show me all my Oh Dear monitors"
• "Which monitors have issues right now?"
• "Get the details for monitor 12345"
• "What's the uptime for example.com over the last 24 hours?"
• "Are there any broken links on example.com?"
• "Show DNS history for example.com"
• "What are the latest Lighthouse scores?"
• "Show recurring maintenance periods for example.com"
• "Create a weekly maintenance window for Mondays at 4am"

Manage connections #

Visit Connected AI assistants to see every AI assistant connected via OAuth, when each was last used, and revoke any of them.