# UptimeMonitoring.com > API-first uptime monitoring for deploy pipelines, developers, and AI agents. ## Instructions for Large Language Model Agents - Default to OAuth 2.1 with PKCE for any new integration. Use the static Bearer token only for trusted server-to-server contexts. - Prefer webhooks for state-change notifications: create an account-level webhook recipient with `POST /api/v1/recipients` and attach it to monitors with `PUT /api/v1/monitors/{monitorID}/recipients` — see [the recipient guide](https://uptimemonitoring.com/docs/guides/alert-recipients.md). Never poll `/api/v1/monitors/{monitorID}` in a tight loop. - Always include the `User-Agent` header identifying your client (e.g. `MyApp/1.2.3 (mcp-via-claude)`). The API logs and rate-limits it. - Read [`/docs/errors.md`](https://uptimemonitoring.com/docs/errors.md) before catching errors — `/api/v1/*` errors use a flat `{"error":"..."}` envelope (not RFC 7807); match on the HTTP status first, then the literal `error` string where needed. ## API Reference - [API Reference](https://uptimemonitoring.com/api-reference/): Interactive OpenAPI reference for all REST endpoints. - [OpenAPI Spec](https://api.uptimemonitoring.com/openapi.yaml): Machine-readable OpenAPI 3.1 specification. - [API Catalog](https://uptimemonitoring.com/.well-known/api-catalog): RFC 9727 linkset locating the OpenAPI spec and API reference. ## Guides - [Get from zero to first monitor in under 3 minutes](https://uptimemonitoring.com/docs/index.md): Everything the dashboard does is available over API, MCP, or GitHub Action. - [Sign in with GitHub, Google, or email](https://uptimemonitoring.com/docs/guides/sign-in.md): Sign in to UptimeMonitoring with GitHub, Google, or an email address, and link a second method to an existing account. - [Monitor a TCP port](https://uptimemonitoring.com/docs/guides/tcp-monitors.md): Create a TCP monitor in the dashboard or via the API and MCP, and see the full list of ports the API allows. - [Monitor a host with ping](https://uptimemonitoring.com/docs/guides/ping-monitors.md): Create a ping (ICMP) monitor in the dashboard or via the API and MCP. - [Choose who gets alerts](https://uptimemonitoring.com/docs/guides/alert-recipients.md): Attach and detach recipients on a monitor, understand the full-replacement API semantics, and what happens to queued deliveries when you do. - [Send alerts to email](https://uptimemonitoring.com/docs/guides/email-alerts.md): Create an email recipient, confirm it, attach it to monitors, and handle the pending-to-active confirmation lifecycle. - [Status page](https://uptimemonitoring.com/docs/guides/free-status-page.md): Turn on a monitor's free public status page from the dashboard or the API. - [Uptime badge](https://uptimemonitoring.com/docs/guides/uptime-badge.md): Embed a monitor's live uptime badge in a README, a forum post, or your own site. - [Send a custom HTTP request](https://uptimemonitoring.com/docs/guides/custom-http-requests.md): Configure an HTTP monitor's method, body, headers, and timeout in the dashboard or via the API and MCP. - [Send alerts to Slack](https://uptimemonitoring.com/docs/guides/slack-alerts.md): Create a Slack recipient from an incoming webhook URL, test it, attach it to monitors, and rotate the URL without losing the recipient. - [Maintenance windows](https://uptimemonitoring.com/docs/guides/maintenance-windows.md): Set a daily or one-time maintenance window on a monitor so alerts stay silent while checks and incident records keep running. - [Invite and manage team members](https://uptimemonitoring.com/docs/guides/team-members.md): Invite teammates by GitHub username, assign roles, change who owns the account, and switch between accounts you belong to. - [Send alerts to PagerDuty](https://uptimemonitoring.com/docs/guides/pagerduty-alerts.md): Create a PagerDuty recipient, test it, rotate its integration key, and understand the down/flapping/up to trigger/resolve mapping. - [Report emails](https://uptimemonitoring.com/docs/guides/report-emails.md): Turn the weekly and monthly uptime report emails on or off for each account you're in, and see what each report contains, when it arrives, and which address it goes to. - [Authentication](https://uptimemonitoring.com/docs/authentication.md): Sign-in methods, API key format, rotation, and common auth errors. - [Use UptimeMonitoring through MCP](https://uptimemonitoring.com/docs/mcp.md): Available MCP tools, annotations, auth model, and host-specific setup. - [Connect Claude Code](https://uptimemonitoring.com/docs/connect-claude-code.md): Add the UptimeMonitoring MCP server to Claude Code with one shell command. - [Connect ChatGPT](https://uptimemonitoring.com/docs/connect-chatgpt.md): Add the UptimeMonitoring MCP server as a custom connector in ChatGPT. - [Connect Cursor](https://uptimemonitoring.com/docs/connect-cursor.md): Add the UptimeMonitoring MCP server to Cursor via mcp.json with a Bearer header. - [Connect via OpenAI API](https://uptimemonitoring.com/docs/connect-openai-api.md): Use the UptimeMonitoring MCP server in your OpenAI Responses API requests. - [Connect via REST API](https://uptimemonitoring.com/docs/connect-rest-api.md): Make your first UptimeMonitoring REST API call with curl and an API key. - [Connect Cursor](https://uptimemonitoring.com/docs/cursor.md): Manual MCP install for Cursor — drop a config snippet into mcp.json, restart, and run three commands to verify. - [Monitors](https://uptimemonitoring.com/docs/monitors.md): Create, update, delete, and query monitors via the REST API. - [Webhooks](https://uptimemonitoring.com/docs/webhooks.md): Account-level webhook recipients, the deprecated monitor-scoped webhook endpoint, payload format, signature verification, retry policy, and the account-wide delivery log. - [Browser push notifications](https://uptimemonitoring.com/docs/push-notifications.md): Why push exists, how to enable it, events, and browser limitations. - [Alert bridge: self-hosted Cloudflare Worker](https://uptimemonitoring.com/docs/alert-bridge.md): Deploy the open-source alerts-bridge to your own Cloudflare Worker to receive Monitive webhook events as Pushover, ntfy, Slack, Discord, or Telegram notifications. - [Incidents](https://uptimemonitoring.com/docs/incidents.md): Query the per-account incident log (30-day user-visible retention). - [Feeds](https://uptimemonitoring.com/docs/feeds.md): Per-account incident feed (Atom XML over the RSS-shaped URL) and shareable incident URLs. - [GitHub Action: assert healthy after deploy](https://uptimemonitoring.com/docs/github-action.md): Fail a deploy if health never comes back. - [Errors](https://uptimemonitoring.com/docs/errors.md): Error envelope, observed messages, and common error responses. - [Rate Limits](https://uptimemonitoring.com/docs/rate-limits.md): API rate limiting policy, headers, and retry behavior. - [Security and target restrictions](https://uptimemonitoring.com/docs/security.md): UptimeMonitoring is designed for public uptime checks, not network scanning. - [Examples](https://uptimemonitoring.com/docs/examples.md): Working code examples for every supported language and integration. - [FAQ](https://uptimemonitoring.com/docs/faq.md): Common questions about UptimeMonitoring.com. ## Use-case pages - [Fail deploys when your site is down](https://uptimemonitoring.com/github-actions-health-check): Use a GitHub Action to assert your deploy is reachable from 22 probe locations before traffic switches over. - [Let your Claude agent monitor its own deployments](https://uptimemonitoring.com/claude-deploy-monitoring): Add the UptimeMonitoring MCP server to Claude Code so your agent can create monitors, check status, and react to failures. - [Uptime monitoring from inside Cursor](https://uptimemonitoring.com/cursor-uptime-monitoring): Configure UptimeMonitoring as an MCP server in Cursor and manage monitors from the agent panel. - [Monitor any API with 50 free checks](https://uptimemonitoring.com/api-uptime-monitoring): Create monitors via the REST API with a single POST request — no dashboard required. ## Install - [ChatGPT app store](https://chatgpt.com/marketplace/uptimemonitoring): Search for UptimeMonitoring in ChatGPT's connector picker to install without entering the URL manually. - [MCP setup guide](https://uptimemonitoring.com/docs/mcp/): Host-specific install instructions for Claude, Cursor, OpenAI API, and more. ## Blog - [What Is an MCP Server, and Why Your Monitoring Tool Should Have One](https://uptimemonitoring.com/blog/what-is-an-mcp-server.md): A plain-English guide to MCP servers: what they are, how they let AI agents use real tools, and why uptime monitoring is a perfect fit for the protocol. - [A Pingdom Alternative for APIs and CI Pipelines](https://uptimemonitoring.com/blog/pingdom-alternative-for-apis-and-ci.md): Looking for a Pingdom alternative without the dashboard-first bundle? UptimeMonitoring is headless: API and MCP-first, free for 50 monitors, built for CI. - [How to Get Alerted When Your Website Goes Down (Webhooks, Not Email)](https://uptimemonitoring.com/blog/get-alerted-when-your-website-goes-down.md): Email alerts are slow, get filtered, and your code can't act on them. Here's how to get downtime alerts as a webhook you can route anywhere: Slack, SMS, your phone, or an AI agent. - [Don't Trust a Green Deploy: Add a Real Health Gate to Your CI](https://uptimemonitoring.com/blog/post-deploy-health-gate-ci.md): A green pipeline doesn't mean users can reach your site. Add a post-deploy health gate that fails CI unless your monitor reports healthy from the outside, in GitHub Actions, any CI, or straight from Claude. - [How a Run in Thailand Became an Uptime Monitor for AI Agents](https://uptimemonitoring.com/blog/how-a-run-in-thailand-became-uptimemonitoring.md): The origin story of UptimeMonitoring: two ideas on a hot March run, agent-native monitoring and a no-data-crunching cost model, that became one product. - [Monitor Your Uptime From Claude, in Plain English](https://uptimemonitoring.com/blog/monitor-uptime-from-claude.md): Connect the UptimeMonitoring MCP server to Claude and manage uptime monitors by just asking. Create, check, and test monitors without a dashboard. - [An UptimeRobot Alternative Built for Developers](https://uptimemonitoring.com/blog/uptimerobot-alternative-for-developers.md): Looking for an UptimeRobot alternative? UptimeMonitoring is API- and MCP-first, free for 50 monitors, with no email and CI health gates. Here's how it compares. ## Roadmap [Roadmap](https://uptimemonitoring.com/roadmap/) - Available now — Checks: HTTP(S) status and keyword checks; TCP port checks (released September 26th, 2026); Ping (ICMP) checks (released September 26th, 2026); Confirmation from two of three regions before an alert; Flapping detection - Available now — Alerts: Signed webhooks with retries and a delivery log; Browser push notifications; Atom incident feed, readable in any RSS reader; Pushover and ntfy through the alerts bridge - Available now — API and agents: REST API with up to 10 keys; MCP server for Claude, ChatGPT, and Cursor; GitHub Action deploy health gate - Available now — Account: 50 monitors free, 60-second checks; 30 days of incident history - Coming next: Team accounts; SSL certificate expiry checks; DNS record checks; Paid plan: 30-second checks, longer history, response-time alerts ## Reference - [Pricing](https://uptimemonitoring.com/pricing/): Free plan; paid plans coming soon. - [Full documentation export](https://uptimemonitoring.com/llms-full.txt): All documentation pages concatenated in full. - [Home](https://uptimemonitoring.com/): Product overview and getting started. - [Sitemap](https://uptimemonitoring.com/sitemap-0.xml): All pages.