Uptimeify

{
  "name": "Uptimeify",
  "description": "Uptimeify monitoring agent. Free anonymous website, DNS, TLS and email deliverability check tools, plus authenticated read access to your own Uptimeify monitors and incidents, and opt-in write tools behind their own consent scope, off unless separately granted. Interact over the Model Context Protocol (MCP) at /mcp.",
  "url": "https://uptimeify.io/mcp",
  "provider": {
    "organization": "Uptimeify",
    "url": "https://uptimeify.io"
  },
  "version": "1.0.0",
  "documentationUrl": "https://docs.uptimeify.io",
  "iconUrl": "https://uptimeify.io/favicon.ico",
  "supportedInterfaces": [
    {
      "url": "https://uptimeify.io/mcp",
      "protocolBinding": "https://uptimeify.io/a2a/bindings/mcp/v1",
      "protocolVersion": "1.0"
    }
  ],
  "capabilities": {
    "streaming": true,
    "pushNotifications": false,
    "extendedAgentCard": false,
    "extensions": [
      {
        "uri": "https://uptimeify.io/a2a/bindings/mcp/v1",
        "description": "Uptimeify is reached over the Model Context Protocol (streamable HTTP) rather than an A2A protocol binding. Connect an MCP client to the interface URL; tools map to the skills below.",
        "required": false,
        "params": {
          "mcpProtocolVersion": "2025-11-25",
          "transport": "streamable-http",
          "discovery": "https://uptimeify.io/.well-known/mcp.json"
        }
      }
    ]
  },
  "securitySchemes": {
    "bearer": {
      "httpAuthSecurityScheme": {
        "scheme": "Bearer",
        "description": "Uptimeify API token (starts with wsm_), created in the dashboard under API Tokens. OAuth 2.0 with PKCE is also supported; see /.well-known/oauth-authorization-server."
      }
    }
  },
  "defaultInputModes": [
    "text/plain",
    "application/json"
  ],
  "defaultOutputModes": [
    "text/plain",
    "application/json"
  ],
  "skills": [
    {
      "id": "check_ssl",
      "name": "check_ssl",
      "description": "Fetches and evaluates a host's TLS certificate over a live handshake: subject, issuer, validity window, days until expiry, hostname match, chain trust, self-signed and expired flags, SANs, serial and SHA-256 fingerprint. Takes a hostname (not an IP address) and an optional port (default 443). A single sample taken now; HTTP behaviour is covered by website_status and the HSTS policy by hsts_check. Anonymous, rate-limited per IP; private and reserved addresses are refused.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "check_dns",
      "name": "check_dns",
      "description": "Resolves a domain's DNS records in one call (A, AAAA, CNAME, MX, TXT, NS, SOA and more) and returns each record type with its values, or a per-type error where a lookup failed. Answers come from a single resolver; dns_propagation compares several. Reads records only and never connects to the host. Anonymous, rate-limited per IP.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "dns_propagation",
      "name": "dns_propagation",
      "description": "Queries one domain against several public resolvers and compares the answers, which tells a recent record change apart from a stale cache. Returns each resolver with its values and a `consistent` flag that stays false while the answers differ. check_dns is the cheaper call for a single reading of all record types. Anonymous, rate-limited per IP.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "mx_lookup",
      "name": "mx_lookup",
      "description": "Looks up a domain's MX records and resolves each mail exchanger to its IPv4 and IPv6 addresses, ordered by priority, flagging hosts that resolve into private address space. Shows where mail is delivered; it does not connect to the servers or test SMTP, and sender authorisation is covered by spf_check, dkim_check and dmarc_check. Anonymous, rate-limited per IP.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "spf_check",
      "name": "spf_check",
      "description": "Fetches a domain's SPF record and evaluates it: raw record, parsed terms with qualifiers, DNS lookups counted against the RFC 7208 limit of ten, the final `all` qualifier, and warnings for common silent failures. A domain without a record returns found=false. Alignment and reporting belong to dmarc_check, signing keys to dkim_check. Anonymous, rate-limited per IP.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "dkim_check",
      "name": "dkim_check",
      "description": "Fetches and validates the DKIM public key at <selector>._domainkey.<domain>: parsed tags, key type, key size and warnings such as a revoked or malformed key. The selector is required and cannot be derived from the domain; it appears in a message's DKIM-Signature header (common provider values: google, selector1, default, k1). An unused selector returns found=false. Anonymous, rate-limited per IP.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "dmarc_check",
      "name": "dmarc_check",
      "description": "Fetches a domain's DMARC record from _dmarc.<domain> and evaluates it: raw record, parsed tags, policy and subdomain policy, percentage, and warnings for records that parse but offer no protection (p=none, missing rua). Reports the published policy, not whether real mail passes it; spf_check and dkim_check cover the mechanisms it aligns against. Anonymous, rate-limited per IP.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "dnsbl_check",
      "name": "dnsbl_check",
      "description": "Checks a public IP address against common DNS blocklists and returns, per list, whether it is listed, the list's reason code and delisting URL, plus totals and a `clean` flag. Takes an IP address, not a domain (mx_lookup or check_dns resolve one). Slow lists are skipped rather than awaited, so partial=true marks a provisional verdict. One call reflects only the current moment. Anonymous, with the strictest per-IP rate limit of the anonymous tools.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "whois",
      "name": "whois",
      "description": "Retrieves WHOIS registration data for a domain: registrar, creation, update and expiry dates, EPP status codes, nameservers and the contact roles the registry still publishes (personal data is usually redacted). tldSupported=false means the TLD has no queryable WHOIS server, which differs from an unregistered domain (found=false). domain_expiry returns the expiry with the remaining days computed. Anonymous, rate-limited per IP.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "domain_expiry",
      "name": "domain_expiry",
      "description": "Reports a domain's registration expiry from WHOIS with the remaining days, plus registrar, creation and update dates and the EPP status codes that reveal redemption or pending delete. Covers the registration, not the TLS certificate (check_ssl). tldSupported=false means the TLD has no queryable WHOIS server, not that the domain is unregistered. Anonymous, rate-limited per IP.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "http_headers",
      "name": "http_headers",
      "description": "Fetches a URL and returns its HTTP response headers verbatim as a name/value map, with the status line and every redirect hop. The response body is never returned. website_status gives a plain up/down verdict and redirect_check the redirect chain alone. Anonymous, rate-limited per IP; private and reserved addresses are refused.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "hsts_check",
      "name": "hsts_check",
      "description": "Checks a domain's HTTP Strict Transport Security setup: header presence and raw value, max-age, includeSubDomains and preload flags, whether plain HTTP redirects to HTTPS, preload-list eligibility, and warnings for ineffective values. Reports the advertised policy only; the certificate is check_ssl and the redirect chain redirect_check. Anonymous, rate-limited per IP; private and reserved addresses are refused.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "redirect_check",
      "name": "redirect_check",
      "description": "Follows a URL's redirect chain hop by hop and returns each step's status, source and target, the final URL and status, the hop count, and warnings for loops, HTTPS-to-HTTP downgrades and overly long chains. Body and headers of the destination are not returned (http_headers covers headers). Anonymous, rate-limited per IP; private and reserved addresses are refused.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "port_check",
      "name": "port_check",
      "description": "Opens TCP connections to one port or a list of up to 10 ports on a host and reports each as open, closed or filtered, with the time taken. partial=true means not every port answered within the time budget; filtered means no answer arrived, not that the port is certainly closed. TCP only, no UDP. Anonymous, rate-limited per IP; hosts resolving to private or reserved addresses are refused.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "ping_test",
      "name": "ping_test",
      "description": "Measures reachability and round-trip time with repeated TCP connections to a host port (default 443), returning every attempt, sent and received counts, packet loss and min/avg/max milliseconds. A TCP handshake, not an ICMP echo, so hosts that drop ICMP still answer. website_status gives a one-shot verdict for a website. Anonymous, rate-limited per IP; private and reserved addresses are refused.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "website_status",
      "name": "website_status",
      "description": "Checks whether a website is up right now: up/down verdict, HTTP status and text, response time, server header and number of redirects followed. The usual first call for any is-the-site-down question. A single sample from one location, not uptime; response_time, http_headers and redirect_check go deeper. Anonymous, rate-limited per IP; private and reserved addresses are refused.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "response_time",
      "name": "response_time",
      "description": "Measures how fast a URL answers over several samples, returning each sample plus min, average and max milliseconds, the HTTP status and an `up` flag. partial=true means fewer samples returned than requested. Measures the HTTP response only: no browser runs, so JavaScript, assets and Core Web Vitals are not reflected. A snapshot, not a trend. Anonymous, rate-limited per IP; private and reserved addresses are refused.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "ip_geolocation",
      "name": "ip_geolocation",
      "description": "Locates a public IP address, or a domain resolved to one, at network level: country code, registry, announced prefix, PTR hostname and autonomous systems. Registry-based, so it names the network operator's country, which for hosted or CDN addresses differs from where a visitor or business is located; it is not a street address. Private and reserved addresses have no answer. Anonymous, rate-limited per IP.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "asn_lookup",
      "name": "asn_lookup",
      "description": "Resolves a public IP address, or a domain, to the autonomous system that announces it: AS number and name, announced prefix, country code, registry and allocation date. Distinguishes hosting providers, CDNs and corporate networks; it does not identify the site owner. Private and reserved addresses have no announcing AS. ip_geolocation returns the same AS data plus country and PTR. Anonymous, rate-limited per IP.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "reverse_dns",
      "name": "reverse_dns",
      "description": "Resolves a public IP address to the PTR hostnames published for it, or returns the resolver's error where there is none. A PTR is set by whoever controls the address block, so it names the host rather than necessarily the site; a missing PTR is common and not a fault. Forward and reverse records need not agree, and this call does not check that they do. Anonymous, rate-limited per IP.",
      "tags": [
        "monitoring",
        "anonymous"
      ]
    },
    {
      "id": "list_monitors",
      "name": "list_monitors",
      "description": "Lists the monitors the caller can see across all eight families (website, dns, icmp, tcp, ftp, smtp, ssh, imap_pop), with current up/down state (`isDown`, `isRecovering`) and uptime. `kind` limits it to one family, `search` matches name, URL/hostname or customer, `customer_id` limits it to one customer. Each family returns up to 50 items per `page`; `total` is the real count across the queried families, so fewer items than `total` means more pages. Each item carries its `kind`, which monitor_status, check_history and alert_history take. Read-only.",
      "tags": [
        "monitoring",
        "authenticated"
      ],
      "requiredScope": "mcp:monitors:read",
      "securityRequirements": [
        {
          "schemes": {
            "bearer": {
              "list": []
            }
          }
        }
      ]
    },
    {
      "id": "monitor_status",
      "name": "monitor_status",
      "description": "Returns one monitor by id with its configuration, active flag (`isActive`) and last check time. The current up/down state and uptime come from list_monitors (use `search` to find the monitor there); this detail view does not carry them. Takes the `kind` from list_monitors; without it, website is assumed. Read-only.",
      "tags": [
        "monitoring",
        "authenticated"
      ],
      "requiredScope": "mcp:monitors:read",
      "securityRequirements": [
        {
          "schemes": {
            "bearer": {
              "list": []
            }
          }
        }
      ]
    },
    {
      "id": "list_incidents",
      "name": "list_incidents",
      "description": "Lists recent incidents across all of the caller's monitors, most recent first. Read-only.",
      "tags": [
        "monitoring",
        "authenticated"
      ],
      "requiredScope": "mcp:incidents:read",
      "securityRequirements": [
        {
          "schemes": {
            "bearer": {
              "list": []
            }
          }
        }
      ]
    },
    {
      "id": "check_history",
      "name": "check_history",
      "description": "Returns the check history of one monitor, newest first, optionally bounded by an ISO date range. The answer is paged (`page`, `pageCount`); pass `page` for older entries. Takes the `kind` from list_monitors; without it, website is assumed. Read-only.",
      "tags": [
        "monitoring",
        "authenticated"
      ],
      "requiredScope": "mcp:checks:read",
      "securityRequirements": [
        {
          "schemes": {
            "bearer": {
              "list": []
            }
          }
        }
      ]
    },
    {
      "id": "uptime_summary",
      "name": "uptime_summary",
      "description": "Returns uptime and average response time per day, month and year for a website monitor. Website monitors only; the other families have no uptime summary. Read-only.",
      "tags": [
        "monitoring",
        "authenticated"
      ],
      "requiredScope": "mcp:checks:read",
      "securityRequirements": [
        {
          "schemes": {
            "bearer": {
              "list": []
            }
          }
        }
      ]
    },
    {
      "id": "list_alert_channels",
      "name": "list_alert_channels",
      "description": "Lists the notification channels that can alert the caller: name, type (email, sms, webhook or a chat/on-call integration), active flag and delay in seconds. Without `website_id` it returns the organization-level channels; with it, the channels that apply to that monitor including its overrides. Channel configuration (recipients, targets, credentials) is not returned. Together with alert_history it explains whether an alert reached someone. Read-only.",
      "tags": [
        "monitoring",
        "authenticated"
      ],
      "requiredScope": "mcp:alerts:read",
      "securityRequirements": [
        {
          "schemes": {
            "bearer": {
              "list": []
            }
          }
        }
      ]
    },
    {
      "id": "alert_history",
      "name": "alert_history",
      "description": "Returns the alert history of one monitor: which alerts went out, when, over which channel, and whether delivery succeeded or failed with which error. Takes the `kind` from list_monitors (default website); paged, 25 entries by default, 100 at most. Channel configuration is not returned, but `errorMessage` is free text from the delivery attempt and can quote a mail server, a recipient or a webhook host. Read-only.",
      "tags": [
        "monitoring",
        "authenticated"
      ],
      "requiredScope": "mcp:alerts:read",
      "securityRequirements": [
        {
          "schemes": {
            "bearer": {
              "list": []
            }
          }
        }
      ]
    },
    {
      "id": "list_status_pages",
      "name": "list_status_pages",
      "description": "Lists the caller's status pages: name, slug, description, customer, published state, visibility (public, customer_members_only or password_protected), whether a password is set, hidden monitors and the custom domain. Subscriber lists, the visual design and the domain's DNS verification token are not returned. Read-only.",
      "tags": [
        "monitoring",
        "authenticated"
      ],
      "requiredScope": "mcp:statuspages:read",
      "securityRequirements": [
        {
          "schemes": {
            "bearer": {
              "list": []
            }
          }
        }
      ]
    },
    {
      "id": "list_maintenance_windows",
      "name": "list_maintenance_windows",
      "description": "Lists the caller's maintenance windows: name, start and end, IANA timezone, recurrence, active flag and covered monitors (`targets`). Monitors in a running window raise no alerts. There is no date filter: past and future windows are all returned, 25 per `page` (`total` and `pageCount` say how many there are). Read-only.",
      "tags": [
        "monitoring",
        "authenticated"
      ],
      "requiredScope": "mcp:statuspages:read",
      "securityRequirements": [
        {
          "schemes": {
            "bearer": {
              "list": []
            }
          }
        }
      ]
    },
    {
      "id": "get_organization",
      "name": "get_organization",
      "description": "Returns the caller's organization: numeric id, public id, name, account status and, for a deactivated account scheduled for deletion, the deletion date. These five fields are the whole answer; billing, payment, quota, MFA policy and notification defaults are not included. Read-only.",
      "tags": [
        "monitoring",
        "authenticated"
      ],
      "requiredScope": "mcp:organization:read",
      "securityRequirements": [
        {
          "schemes": {
            "bearer": {
              "list": []
            }
          }
        }
      ]
    },
    {
      "id": "list_users",
      "name": "list_users",
      "description": "Lists the organization members the caller may see: name, role (admin, editor or readonly), active flag and join date, plus `limits.currentSeats`, the number of members in this answer. No e-mail addresses, avatars, customer assignments or member ids are returned. For a customer-scoped token the list is narrowed to that customer's members and the caller, so it is not the organization's size. Read-only.",
      "tags": [
        "monitoring",
        "authenticated"
      ],
      "requiredScope": "mcp:organization:read",
      "securityRequirements": [
        {
          "schemes": {
            "bearer": {
              "list": []
            }
          }
        }
      ]
    },
    {
      "id": "list_customers",
      "name": "list_customers",
      "description": "Lists the organization's customers: numeric id, public id, name, status, creation date and monitor counts (total, managed, self-service, DNSBL). A customer-bound token sees only its own customer. Contact data, addresses, VAT id, cancellation dates, custom fields and the tariff are not returned. Read-only.",
      "tags": [
        "monitoring",
        "authenticated"
      ],
      "requiredScope": "mcp:organization:read",
      "securityRequirements": [
        {
          "schemes": {
            "bearer": {
              "list": []
            }
          }
        }
      ]
    },
    {
      "id": "billing_summary",
      "name": "billing_summary",
      "description": "Returns the current month's SMS usage for the organization: the total and a per-customer breakdown. No tariff, amount, currency, invoice, address or payment method is returned. Customers are named only when the connection also holds the organization scope and are otherwise identified by public id. A customer-bound token sees only its own customer. Read-only.",
      "tags": [
        "monitoring",
        "authenticated"
      ],
      "requiredScope": "mcp:billing:read",
      "securityRequirements": [
        {
          "schemes": {
            "bearer": {
              "list": []
            }
          }
        }
      ]
    }
  ]
}