OhSnap uptime monitoring

One-off check of whether a website is up right now, from OhSnap's probe network. Works without an account. Use when the user asks "is my site down?", "is X up?", or wants a status code, response time, or the reason a site fails (DNS failure, SSL error, timeout, HTTP error, Cloudflare edge error). Results are cached for 60 seconds per site, and each user can run 10 checks per minute.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "description": "Website URL or bare domain, e.g. \"example.com\" or \"https://example.com/shop\"."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns the OhSnap account this MCP key belongs to: email, plan (Free, Unlimited, Agency), the monitor cap, and the fastest allowed check interval. Call before add_monitor to explain plan limits up front.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Lists every website this OhSnap account monitors, with its current status (up, down, warning, pending), last response time, and check interval. Use to answer "are my sites up?" and to find a website_id for other tools.

{
  "type": "object",
  "properties": {},
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Adds a website to OhSnap so it is checked around the clock and the user is alerted when it goes down or comes back. Free accounts can monitor 5 sites every 5 minutes; Unlimited allows any number every 30 seconds. Pass alert_email if the account has no alert channel yet, otherwise the monitor will run silently. SMS, WhatsApp, Slack and Telegram alerts are configured in the OhSnap dashboard.

{
  "type": "object",
  "properties": {
    "url": {
      "type": "string",
      "minLength": 1,
      "maxLength": 2048,
      "description": "Website URL or bare domain to monitor."
    },
    "name": {
      "type": "string",
      "minLength": 1,
      "maxLength": 100,
      "description": "Display name. Defaults to the hostname."
    },
    "check_frequency_seconds": {
      "type": "integer",
      "minimum": 30,
      "maximum": 86400,
      "description": "Seconds between checks. Raised to the plan minimum (300 on Free, 30 on Unlimited). Defaults to 300."
    },
    "alert_email": {
      "type": "string",
      "format": "email",
      "maxLength": 254,
      "description": "Email address for down/up alerts. Used only if the account has no email alert channel yet."
    }
  },
  "required": [
    "url"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Returns recent outages for one monitored website: when each started and ended, how long it lasted, and the error. On the Unlimited plan each incident includes an AI diagnosis in plain language; on Free it is marked ai_locked.

{
  "type": "object",
  "properties": {
    "website_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Monitor id from list_monitors or add_monitor."
    },
    "days": {
      "type": "integer",
      "minimum": 1,
      "maximum": 90,
      "description": "How far back to look. Default 30, max 90."
    },
    "limit": {
      "type": "integer",
      "minimum": 1,
      "maximum": 100,
      "description": "Maximum incidents to return. Default 10."
    }
  },
  "required": [
    "website_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}

Sends a clearly labelled test DOWN alert through every alert channel linked to a monitor (email, SMS, WhatsApp, Slack, Telegram), so the user can confirm alerts reach them. Limited to one test per monitor per minute.

{
  "type": "object",
  "properties": {
    "website_id": {
      "type": "string",
      "minLength": 1,
      "maxLength": 64,
      "description": "Monitor id from list_monitors or add_monitor."
    }
  },
  "required": [
    "website_id"
  ],
  "additionalProperties": false,
  "$schema": "http://json-schema.org/draft-07/schema#"
}