StatusCake MCP by usefulapi is an MCP server published by io.usefulapi, hosted at statuscake.usefulapi.io. When last checked on 2026-11-22 it was working: it answers and lists its tools. It declares 21 tools, including statuscake_list_uptime_checks, statuscake_get_uptime_check, statuscake_get_uptime_history, statuscake_get_uptime_periods, statuscake_list_uptime_alerts.
Review uptime, SSL, pagespeed and heartbeat checks, alerts and maintenance windows; create checks.
4,206 connections through 5 shared values. Tap any node.
Inferred from the host name and headers: what a server runs on, not who runs it.
List uptime checks with their current status (up/down), type, URL, check rate, tags and uptime percentage. Filter by status or tags. StatusCake: GET /uptime.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page of results, starting at 1. |
| tags | string | Comma-separated tags; only checks carrying these tags are returned. |
| limit | integer | Results per page, 1-100 (default 25). |
| status | string | Only checks currently in this state. |
| matchany | boolean | With tags: return checks matching ANY of the tags instead of ALL of them. |
None yet. Changes appear after a server's second daily check.
Squares are this server's values; dots are other servers sharing them. A shared address or publisher is a lead, not proof of a common operator.
| nouptime | boolean | Skip calculating uptime percentages (faster for large accounts). |
{
"name": "statuscake_list_uptime_checks",
"title": "List uptime checks",
"description": "List uptime checks with their current status (up/down), type, URL, check rate, tags and uptime percentage. Filter by status or tags. StatusCake: GET /uptime.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page of results, starting at 1."
},
"tags": {
"type": "string",
"description": "Comma-separated tags; only checks carrying these tags are returned."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"status": {
"enum": [
"up",
"down"
],
"type": "string",
"description": "Only checks currently in this state."
},
"matchany": {
"type": "boolean",
"description": "With tags: return checks matching ANY of the tags instead of ALL of them."
},
"nouptime": {
"type": "boolean",
"description": "Skip calculating uptime percentages (faster for large accounts)."
}
}
},
"annotations": {
"title": "List uptime checks",
"readOnlyHint": true
}
}Fetch one uptime check in full — settings, current status, last test time, next location and the monitoring servers it runs on. StatusCake: GET /uptime/{test_id}.
| Parameter | Type | Description |
|---|---|---|
| test_id * | string | The uptime check id. |
{
"name": "statuscake_get_uptime_check",
"title": "Get one uptime check",
"description": "Fetch one uptime check in full — settings, current status, last test time, next location and the monitoring servers it runs on. StatusCake: GET /uptime/{test_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"test_id"
],
"properties": {
"test_id": {
"type": "string",
"minLength": 1,
"description": "The uptime check id."
}
}
},
"annotations": {
"title": "Get one uptime check",
"readOnlyHint": true
}
}Individual test runs for one uptime check — when, from which location, the status code and the response time (ms). Newest first; follow links.next (or pass before) to page back. StatusCake: GET /uptime/{test_id}/history.
| Parameter | Type | Description |
|---|---|---|
| after | integer | Only results after this UNIX timestamp (seconds). |
| limit | integer | Results per page, 1-100 (default 25). |
| before | integer | Only results before this UNIX timestamp (seconds). Use it with links.next to page back in time. |
| test_id * | string | The uptime check id. |
{
"name": "statuscake_get_uptime_history",
"title": "Get uptime check history",
"description": "Individual test runs for one uptime check — when, from which location, the status code and the response time (ms). Newest first; follow links.next (or pass before) to page back. StatusCake: GET /uptime/{test_id}/history.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"test_id"
],
"properties": {
"after": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Only results after this UNIX timestamp (seconds)."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"before": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Only results before this UNIX timestamp (seconds). Use it with links.next to page back in time."
},
"test_id": {
"type": "string",
"minLength": 1,
"description": "The uptime check id."
}
}
},
"annotations": {
"title": "Get uptime check history",
"readOnlyHint": true
}
}The up and down periods of one uptime check — when each started and ended and how long it lasted (ms). The direct answer to 'how long was it down?'. StatusCake: GET /uptime/{test_id}/periods.
| Parameter | Type | Description |
|---|---|---|
| after | integer | Only results after this UNIX timestamp (seconds). |
| limit | integer | Results per page, 1-100 (default 25). |
| before | integer | Only results before this UNIX timestamp (seconds). Use it with links.next to page back in time. |
| test_id * | string | The uptime check id. |
{
"name": "statuscake_get_uptime_periods",
"title": "Get uptime check up/down periods",
"description": "The up and down periods of one uptime check — when each started and ended and how long it lasted (ms). The direct answer to 'how long was it down?'. StatusCake: GET /uptime/{test_id}/periods.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"test_id"
],
"properties": {
"after": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Only results after this UNIX timestamp (seconds)."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"before": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Only results before this UNIX timestamp (seconds). Use it with links.next to page back in time."
},
"test_id": {
"type": "string",
"minLength": 1,
"description": "The uptime check id."
}
}
},
"annotations": {
"title": "Get uptime check up/down periods",
"readOnlyHint": true
}
}Alerts triggered by one uptime check — when, the status it changed to and the status code. StatusCake: GET /uptime/{test_id}/alerts.
| Parameter | Type | Description |
|---|---|---|
| after | integer | Only results after this UNIX timestamp (seconds). |
| limit | integer | Results per page, 1-100 (default 25). |
| before | integer | Only results before this UNIX timestamp (seconds). Use it with links.next to page back in time. |
| test_id * | string | The uptime check id. |
{
"name": "statuscake_list_uptime_alerts",
"title": "List uptime check alerts",
"description": "Alerts triggered by one uptime check — when, the status it changed to and the status code. StatusCake: GET /uptime/{test_id}/alerts.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"test_id"
],
"properties": {
"after": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Only results after this UNIX timestamp (seconds)."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"before": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Only results before this UNIX timestamp (seconds). Use it with links.next to page back in time."
},
"test_id": {
"type": "string",
"minLength": 1,
"description": "The uptime check id."
}
}
},
"annotations": {
"title": "List uptime check alerts",
"readOnlyHint": true
}
}List SSL certificate checks with the certificate's validity window (valid_from/valid_until), issuer, cipher and score, and flags such as expired, broken, revoked or mixed content. StatusCake: GET /ssl.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page of results, starting at 1. |
| limit | integer | Results per page, 1-100 (default 25). |
{
"name": "statuscake_list_ssl_checks",
"title": "List SSL checks",
"description": "List SSL certificate checks with the certificate's validity window (valid_from/valid_until), issuer, cipher and score, and flags such as expired, broken, revoked or mixed content. StatusCake: GET /ssl.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page of results, starting at 1."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
}
}
},
"annotations": {
"title": "List SSL checks",
"readOnlyHint": true
}
}Fetch one SSL certificate check in full — expiry, issuer, cipher, scores, flags and any mixed-content resources found. StatusCake: GET /ssl/{test_id}.
| Parameter | Type | Description |
|---|---|---|
| test_id * | string | The SSL check id. |
{
"name": "statuscake_get_ssl_check",
"title": "Get one SSL check",
"description": "Fetch one SSL certificate check in full — expiry, issuer, cipher, scores, flags and any mixed-content resources found. StatusCake: GET /ssl/{test_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"test_id"
],
"properties": {
"test_id": {
"type": "string",
"minLength": 1,
"description": "The SSL check id."
}
}
},
"annotations": {
"title": "Get one SSL check",
"readOnlyHint": true
}
}List pagespeed checks with their location, alert thresholds and latest stats (load time ms, page size kb, request count, latest issue). StatusCake: GET /pagespeed.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page of results, starting at 1. |
| limit | integer | Results per page, 1-100 (default 25). |
{
"name": "statuscake_list_pagespeed_checks",
"title": "List pagespeed checks",
"description": "List pagespeed checks with their location, alert thresholds and latest stats (load time ms, page size kb, request count, latest issue). StatusCake: GET /pagespeed.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page of results, starting at 1."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
}
}
},
"annotations": {
"title": "List pagespeed checks",
"readOnlyHint": true
}
}Past runs of one pagespeed check — load time (ms), file size (kb), request count, throttling and the saved HAR file location. StatusCake: GET /pagespeed/{test_id}/history.
| Parameter | Type | Description |
|---|---|---|
| after | integer | Only results after this UNIX timestamp (seconds). |
| limit | integer | Results per page, 1-100 (default 25). |
| before | integer | Only results before this UNIX timestamp (seconds). Use it with links.next to page back in time. |
| test_id * | string | The pagespeed check id. |
{
"name": "statuscake_get_pagespeed_history",
"title": "Get pagespeed check history",
"description": "Past runs of one pagespeed check — load time (ms), file size (kb), request count, throttling and the saved HAR file location. StatusCake: GET /pagespeed/{test_id}/history.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"test_id"
],
"properties": {
"after": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Only results after this UNIX timestamp (seconds)."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"before": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Only results before this UNIX timestamp (seconds). Use it with links.next to page back in time."
},
"test_id": {
"type": "string",
"minLength": 1,
"description": "The pagespeed check id."
}
}
},
"annotations": {
"title": "Get pagespeed check history",
"readOnlyHint": true
}
}List heartbeat (push) checks — jobs that must ping a StatusCake URL within a period — with their status, period and ping URL. StatusCake: GET /heartbeat.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page of results, starting at 1. |
| tags | string | Comma-separated tags; only checks carrying these tags are returned. |
| limit | integer | Results per page, 1-100 (default 25). |
| status | string | Only checks currently in this state. |
| matchany | boolean | With tags: return checks matching ANY of the tags instead of ALL of them. |
| nouptime | boolean | Skip calculating uptime percentages (faster for large accounts). |
{
"name": "statuscake_list_heartbeat_checks",
"title": "List heartbeat checks",
"description": "List heartbeat (push) checks — jobs that must ping a StatusCake URL within a period — with their status, period and ping URL. StatusCake: GET /heartbeat.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page of results, starting at 1."
},
"tags": {
"type": "string",
"description": "Comma-separated tags; only checks carrying these tags are returned."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"status": {
"enum": [
"up",
"down"
],
"type": "string",
"description": "Only checks currently in this state."
},
"matchany": {
"type": "boolean",
"description": "With tags: return checks matching ANY of the tags instead of ALL of them."
},
"nouptime": {
"type": "boolean",
"description": "Skip calculating uptime percentages (faster for large accounts)."
}
}
},
"annotations": {
"title": "List heartbeat checks",
"readOnlyHint": true
}
}Fetch one heartbeat check in full, including its ping URL, period, status and when it last received a ping. StatusCake: GET /heartbeat/{test_id}.
| Parameter | Type | Description |
|---|---|---|
| test_id * | string | The heartbeat check id. |
{
"name": "statuscake_get_heartbeat_check",
"title": "Get one heartbeat check",
"description": "Fetch one heartbeat check in full, including its ping URL, period, status and when it last received a ping. StatusCake: GET /heartbeat/{test_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"test_id"
],
"properties": {
"test_id": {
"type": "string",
"minLength": 1,
"description": "The heartbeat check id."
}
}
},
"annotations": {
"title": "Get one heartbeat check",
"readOnlyHint": true
}
}List contact groups — who gets alerted: email addresses, mobile numbers, integration ids and ping URL. Use their ids in a check's contact_groups. StatusCake: GET /contact-groups.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page of results, starting at 1. |
| limit | integer | Results per page, 1-100 (default 25). |
{
"name": "statuscake_list_contact_groups",
"title": "List contact groups",
"description": "List contact groups — who gets alerted: email addresses, mobile numbers, integration ids and ping URL. Use their ids in a check's contact_groups. StatusCake: GET /contact-groups.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page of results, starting at 1."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
}
}
},
"annotations": {
"title": "List contact groups",
"readOnlyHint": true
}
}List maintenance windows (scheduled alert silences) with their start/end, timezone, repeat interval, state and the checks or tags they cover. Only works on accounts using the newer maintenance-windows feature. StatusCake: GET /maintenance-windows.
| Parameter | Type | Description |
|---|---|---|
| page | integer | Page of results, starting at 1. |
| limit | integer | Results per page, 1-100 (default 25). |
| state | string | Only windows in this state. |
{
"name": "statuscake_list_maintenance_windows",
"title": "List maintenance windows",
"description": "List maintenance windows (scheduled alert silences) with their start/end, timezone, repeat interval, state and the checks or tags they cover. Only works on accounts using the newer maintenance-windows feature. StatusCake: GET /maintenance-windows.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 1,
"description": "Page of results, starting at 1."
},
"limit": {
"type": "integer",
"maximum": 100,
"minimum": 1,
"description": "Results per page, 1-100 (default 25)."
},
"state": {
"enum": [
"active",
"paused",
"pending"
],
"type": "string",
"description": "Only windows in this state."
}
}
},
"annotations": {
"title": "List maintenance windows",
"readOnlyHint": true
}
}Fetch one maintenance window by id. StatusCake: GET /maintenance-windows/{window_id}.
| Parameter | Type | Description |
|---|---|---|
| window_id * | string | The maintenance window id. |
{
"name": "statuscake_get_maintenance_window",
"title": "Get one maintenance window",
"description": "Fetch one maintenance window by id. StatusCake: GET /maintenance-windows/{window_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"window_id"
],
"properties": {
"window_id": {
"type": "string",
"minLength": 1,
"description": "The maintenance window id."
}
}
},
"annotations": {
"title": "Get one maintenance window",
"readOnlyHint": true
}
}List StatusCake's uptime monitoring servers — region, region code, IPv4/IPv6 and status. Use region codes in a check's regions; use the IPs for firewall allowlists. StatusCake: GET /uptime-locations.
| Parameter | Type | Description |
|---|---|---|
| region_code | string | Only servers in this region code. |
{
"name": "statuscake_list_uptime_locations",
"title": "List uptime monitoring locations",
"description": "List StatusCake's uptime monitoring servers — region, region code, IPv4/IPv6 and status. Use region codes in a check's regions; use the IPs for firewall allowlists. StatusCake: GET /uptime-locations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"region_code": {
"type": "string",
"description": "Only servers in this region code."
}
}
},
"annotations": {
"title": "List uptime monitoring locations",
"readOnlyHint": true
}
}List StatusCake's pagespeed monitoring servers — region, IPs and status. StatusCake: GET /pagespeed-locations.
| Parameter | Type | Description |
|---|---|---|
| location | string | Only servers in this country, as an ISO 3166-1 alpha-2 code, e.g. GB. |
{
"name": "statuscake_list_pagespeed_locations",
"title": "List pagespeed monitoring locations",
"description": "List StatusCake's pagespeed monitoring servers — region, IPs and status. StatusCake: GET /pagespeed-locations.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"location": {
"type": "string",
"description": "Only servers in this country, as an ISO 3166-1 alpha-2 code, e.g. GB."
}
}
},
"annotations": {
"title": "List pagespeed monitoring locations",
"readOnlyHint": true
}
}Start monitoring a URL, host or IP. Returns the new check's id as data.new_id. Faster check rates and some regions depend on the plan. StatusCake: POST /uptime.
| Parameter | Type | Description |
|---|---|---|
| host | string | Name of the hosting provider (informational). |
| name * | string | Name of the check. |
| port | integer | Destination port (TCP, SMTP, SSH checks). |
| tags | array | Tags for the check. An empty list clears them. |
| paused | boolean | true to pause the check (stops running and alerting), false to resume. |
| dns_ips | array | IP addresses the DNS record must resolve to (DNS checks). |
| regions | array | Region codes to run the check from (see statuscake_list_uptime_locations). |
| timeout | integer | Seconds to wait for the first byte, 5-75 (default 15). |
| use_jar | boolean | Enable cookie storage between requests. |
| post_raw | string | Raw HTTP POST body to send. |
| post_body | string | JSON object string submitted with the request; setting it makes the check use HTTP POST. |
| test_type * | string | Check type: HTTP, HEAD, TCP, DNS, SMTP, SSH or PING. |
| check_rate * | number | Seconds between checks: 0, 30, 60, 300, 900, 1800, 3600 or 86400. |
| dns_server | string | Nameserver to query (DNS checks). |
| user_agent | string | Custom User-Agent sent with each check. |
| do_not_find | boolean | Invert find_string: the check is down if the string IS present. |
| find_string | string | String to look for in the response; the check is down if not found. |
| website_url * | string | URL, FQDN or IP address to check. |
| confirmation | integer | Number of confirmation servers that must agree before alerting, 0-3 (default 2). |
| trigger_rate | integer | Minutes to wait before sending an alert, 0-60 (default 0). |
| custom_header | string | JSON object string of headers to send, e.g. {"X-Env":"prod"}. |
| basic_password | string | HTTP basic-auth password for the target. |
| basic_username | string | HTTP basic-auth username for the target. |
| contact_groups | array | Contact group ids to alert (see statuscake_list_contact_groups). An empty list clears them. |
| final_endpoint | string | Where the redirect chain should end (with follow_redirects). |
| include_header | boolean | Include response headers in the find_string search. |
| enable_ssl_alert | boolean | Alert when the site's SSL certificate is about to expire. |
| follow_redirects | boolean | Follow redirects when testing (off by default). |
| status_codes_csv | string | Comma-separated HTTP status codes that count as down, e.g. "500,502,503". |
{
"name": "statuscake_create_uptime_check",
"title": "Create an uptime check",
"description": "Start monitoring a URL, host or IP. Returns the new check's id as data.new_id. Faster check rates and some regions depend on the plan. StatusCake: POST /uptime.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"test_type",
"website_url",
"check_rate"
],
"properties": {
"host": {
"type": "string",
"description": "Name of the hosting provider (informational)."
},
"name": {
"type": "string",
"minLength": 1,
"description": "Name of the check."
},
"port": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Destination port (TCP, SMTP, SSH checks)."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags for the check. An empty list clears them."
},
"paused": {
"type": "boolean",
"description": "true to pause the check (stops running and alerting), false to resume."
},
"dns_ips": {
"type": "array",
"items": {
"type": "string"
},
"description": "IP addresses the DNS record must resolve to (DNS checks)."
},
"regions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Region codes to run the check from (see statuscake_list_uptime_locations)."
},
"timeout": {
"type": "integer",
"maximum": 75,
"minimum": 5,
"description": "Seconds to wait for the first byte, 5-75 (default 15)."
},
"use_jar": {
"type": "boolean",
"description": "Enable cookie storage between requests."
},
"post_raw": {
"type": "string",
"description": "Raw HTTP POST body to send."
},
"post_body": {
"type": "string",
"description": "JSON object string submitted with the request; setting it makes the check use HTTP POST."
},
"test_type": {
"enum": [
"HTTP",
"HEAD",
"TCP",
"DNS",
"SMTP",
"SSH",
"PING"
],
"type": "string",
"description": "Check type: HTTP, HEAD, TCP, DNS, SMTP, SSH or PING."
},
"check_rate": {
"enum": [
0,
30,
60,
300,
900,
1800,
3600,
86400
],
"type": "number",
"description": "Seconds between checks: 0, 30, 60, 300, 900, 1800, 3600 or 86400."
},
"dns_server": {
"type": "string",
"description": "Nameserver to query (DNS checks)."
},
"user_agent": {
"type": "string",
"description": "Custom User-Agent sent with each check."
},
"do_not_find": {
"type": "boolean",
"description": "Invert find_string: the check is down if the string IS present."
},
"find_string": {
"type": "string",
"description": "String to look for in the response; the check is down if not found."
},
"website_url": {
"type": "string",
"minLength": 1,
"description": "URL, FQDN or IP address to check."
},
"confirmation": {
"type": "integer",
"maximum": 3,
"minimum": 0,
"description": "Number of confirmation servers that must agree before alerting, 0-3 (default 2)."
},
"trigger_rate": {
"type": "integer",
"maximum": 60,
"minimum": 0,
"description": "Minutes to wait before sending an alert, 0-60 (default 0)."
},
"custom_header": {
"type": "string",
"description": "JSON object string of headers to send, e.g. {\"X-Env\":\"prod\"}."
},
"basic_password": {
"type": "string",
"description": "HTTP basic-auth password for the target."
},
"basic_username": {
"type": "string",
"description": "HTTP basic-auth username for the target."
},
"contact_groups": {
"type": "array",
"items": {
"type": "string"
},
"description": "Contact group ids to alert (see statuscake_list_contact_groups). An empty list clears them."
},
"final_endpoint": {
"type": "string",
"description": "Where the redirect chain should end (with follow_redirects)."
},
"include_header": {
"type": "boolean",
"description": "Include response headers in the find_string search."
},
"enable_ssl_alert": {
"type": "boolean",
"description": "Alert when the site's SSL certificate is about to expire."
},
"follow_redirects": {
"type": "boolean",
"description": "Follow redirects when testing (off by default)."
},
"status_codes_csv": {
"type": "string",
"description": "Comma-separated HTTP status codes that count as down, e.g. \"500,502,503\"."
}
}
},
"annotations": {
"title": "Create an uptime check",
"destructiveHint": true
}
}Change an uptime check's settings. Only the fields you pass are changed; list fields (tags, contact_groups, regions, dns_ips) are REPLACED, and an empty list clears them. Pass paused=true to pause a check and paused=false to resume it. StatusCake: PUT /uptime/{test_id}.
| Parameter | Type | Description |
|---|---|---|
| host | string | Name of the hosting provider (informational). |
| name | string | New name for the check. |
| port | integer | Destination port (TCP, SMTP, SSH checks). |
| tags | array | Tags for the check. An empty list clears them. |
| paused | boolean | true to pause the check (stops running and alerting), false to resume. |
| dns_ips | array | IP addresses the DNS record must resolve to (DNS checks). |
| regions | array | Region codes to run the check from (see statuscake_list_uptime_locations). |
| test_id * | string | The uptime check id. |
| timeout | integer | Seconds to wait for the first byte, 5-75 (default 15). |
| use_jar | boolean | Enable cookie storage between requests. |
| post_raw | string | Raw HTTP POST body to send. |
| post_body | string | JSON object string submitted with the request; setting it makes the check use HTTP POST. |
| check_rate | number | Seconds between checks: 0, 30, 60, 300, 900, 1800, 3600 or 86400. |
| dns_server | string | Nameserver to query (DNS checks). |
| user_agent | string | Custom User-Agent sent with each check. |
| do_not_find | boolean | Invert find_string: the check is down if the string IS present. |
| find_string | string | String to look for in the response; the check is down if not found. |
| website_url | string | New URL, FQDN or IP address to check. |
| confirmation | integer | Number of confirmation servers that must agree before alerting, 0-3 (default 2). |
| trigger_rate | integer | Minutes to wait before sending an alert, 0-60 (default 0). |
| custom_header | string | JSON object string of headers to send, e.g. {"X-Env":"prod"}. |
| basic_password | string | HTTP basic-auth password for the target. |
| basic_username | string | HTTP basic-auth username for the target. |
| contact_groups | array | Contact group ids to alert (see statuscake_list_contact_groups). An empty list clears them. |
| final_endpoint | string | Where the redirect chain should end (with follow_redirects). |
| include_header | boolean | Include response headers in the find_string search. |
| enable_ssl_alert | boolean | Alert when the site's SSL certificate is about to expire. |
| follow_redirects | boolean | Follow redirects when testing (off by default). |
| status_codes_csv | string | Comma-separated HTTP status codes that count as down, e.g. "500,502,503". |
{
"name": "statuscake_update_uptime_check",
"title": "Update an uptime check",
"description": "Change an uptime check's settings. Only the fields you pass are changed; list fields (tags, contact_groups, regions, dns_ips) are REPLACED, and an empty list clears them. Pass paused=true to pause a check and paused=false to resume it. StatusCake: PUT /uptime/{test_id}.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"test_id"
],
"properties": {
"host": {
"type": "string",
"description": "Name of the hosting provider (informational)."
},
"name": {
"type": "string",
"minLength": 1,
"description": "New name for the check."
},
"port": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0,
"description": "Destination port (TCP, SMTP, SSH checks)."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags for the check. An empty list clears them."
},
"paused": {
"type": "boolean",
"description": "true to pause the check (stops running and alerting), false to resume."
},
"dns_ips": {
"type": "array",
"items": {
"type": "string"
},
"description": "IP addresses the DNS record must resolve to (DNS checks)."
},
"regions": {
"type": "array",
"items": {
"type": "string"
},
"description": "Region codes to run the check from (see statuscake_list_uptime_locations)."
},
"test_id": {
"type": "string",
"minLength": 1,
"description": "The uptime check id."
},
"timeout": {
"type": "integer",
"maximum": 75,
"minimum": 5,
"description": "Seconds to wait for the first byte, 5-75 (default 15)."
},
"use_jar": {
"type": "boolean",
"description": "Enable cookie storage between requests."
},
"post_raw": {
"type": "string",
"description": "Raw HTTP POST body to send."
},
"post_body": {
"type": "string",
"description": "JSON object string submitted with the request; setting it makes the check use HTTP POST."
},
"check_rate": {
"enum": [
0,
30,
60,
300,
900,
1800,
3600,
86400
],
"type": "number",
"description": "Seconds between checks: 0, 30, 60, 300, 900, 1800, 3600 or 86400."
},
"dns_server": {
"type": "string",
"description": "Nameserver to query (DNS checks)."
},
"user_agent": {
"type": "string",
"description": "Custom User-Agent sent with each check."
},
"do_not_find": {
"type": "boolean",
"description": "Invert find_string: the check is down if the string IS present."
},
"find_string": {
"type": "string",
"description": "String to look for in the response; the check is down if not found."
},
"website_url": {
"type": "string",
"minLength": 1,
"description": "New URL, FQDN or IP address to check."
},
"confirmation": {
"type": "integer",
"maximum": 3,
"minimum": 0,
"description": "Number of confirmation servers that must agree before alerting, 0-3 (default 2)."
},
"trigger_rate": {
"type": "integer",
"maximum": 60,
"minimum": 0,
"description": "Minutes to wait before sending an alert, 0-60 (default 0)."
},
"custom_header": {
"type": "string",
"description": "JSON object string of headers to send, e.g. {\"X-Env\":\"prod\"}."
},
"basic_password": {
"type": "string",
"description": "HTTP basic-auth password for the target."
},
"basic_username": {
"type": "string",
"description": "HTTP basic-auth username for the target."
},
"contact_groups": {
"type": "array",
"items": {
"type": "string"
},
"description": "Contact group ids to alert (see statuscake_list_contact_groups). An empty list clears them."
},
"final_endpoint": {
"type": "string",
"description": "Where the redirect chain should end (with follow_redirects)."
},
"include_header": {
"type": "boolean",
"description": "Include response headers in the find_string search."
},
"enable_ssl_alert": {
"type": "boolean",
"description": "Alert when the site's SSL certificate is about to expire."
},
"follow_redirects": {
"type": "boolean",
"description": "Follow redirects when testing (off by default)."
},
"status_codes_csv": {
"type": "string",
"description": "Comma-separated HTTP status codes that count as down, e.g. \"500,502,503\"."
}
}
},
"annotations": {
"title": "Update an uptime check",
"destructiveHint": true
}
}Start monitoring a site's SSL certificate for expiry and problems. Returns the new id as data.new_id. StatusCake: POST /ssl.
| Parameter | Type | Description |
|---|---|---|
| paused | boolean | Create the check paused. |
| alert_at * | array | Exactly three day counts before expiry at which to alert, e.g. [30, 7, 1]. |
| hostname | string | Hostname of the server under test, if different from the URL. |
| check_rate * | number | Seconds between checks: 300, 600, 1800, 3600, 86400 or 2073600. |
| user_agent | string | Custom User-Agent sent when testing. |
| alert_mixed | boolean | Alert when mixed content is found. |
| website_url * | string | URL of the server under test; must begin with https://. |
| alert_broken | boolean | Alert when certificate problems are found. |
| alert_expiry | boolean | Alert when the certificate is about to expire. |
| alert_reminder | boolean | Send alert reminders. |
| contact_groups | array | Contact group ids to alert (see statuscake_list_contact_groups). An empty list clears them. |
| follow_redirects | boolean | Follow redirects when testing (off by default). |
{
"name": "statuscake_create_ssl_check",
"title": "Create an SSL check",
"description": "Start monitoring a site's SSL certificate for expiry and problems. Returns the new id as data.new_id. StatusCake: POST /ssl.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"website_url",
"check_rate",
"alert_at"
],
"properties": {
"paused": {
"type": "boolean",
"description": "Create the check paused."
},
"alert_at": {
"type": "array",
"items": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": 0
},
"maxItems": 3,
"minItems": 3,
"description": "Exactly three day counts before expiry at which to alert, e.g. [30, 7, 1]."
},
"hostname": {
"type": "string",
"description": "Hostname of the server under test, if different from the URL."
},
"check_rate": {
"enum": [
300,
600,
1800,
3600,
86400,
2073600
],
"type": "number",
"description": "Seconds between checks: 300, 600, 1800, 3600, 86400 or 2073600."
},
"user_agent": {
"type": "string",
"description": "Custom User-Agent sent when testing."
},
"alert_mixed": {
"type": "boolean",
"description": "Alert when mixed content is found."
},
"website_url": {
"type": "string",
"pattern": "^https:\\/\\/",
"description": "URL of the server under test; must begin with https://."
},
"alert_broken": {
"type": "boolean",
"description": "Alert when certificate problems are found."
},
"alert_expiry": {
"type": "boolean",
"description": "Alert when the certificate is about to expire."
},
"alert_reminder": {
"type": "boolean",
"description": "Send alert reminders."
},
"contact_groups": {
"type": "array",
"items": {
"type": "string"
},
"description": "Contact group ids to alert (see statuscake_list_contact_groups). An empty list clears them."
},
"follow_redirects": {
"type": "boolean",
"description": "Follow redirects when testing (off by default)."
}
}
},
"annotations": {
"title": "Create an SSL check",
"destructiveHint": true
}
}Create a heartbeat (push) check for a cron job or worker: it goes down if StatusCake is not pinged within `period` seconds. Returns the new id as data.new_id; fetch it with statuscake_get_heartbeat_check to get the ping URL. StatusCake: POST /heartbeat.
| Parameter | Type | Description |
|---|---|---|
| host | string | Name of the hosting provider (informational). |
| name * | string | Name of the check. |
| tags | array | Tags for the check. An empty list clears them. |
| paused | boolean | Create the check paused. |
| period * | integer | Seconds since the last ping before the check is down, 30-172800 (e.g. 1800). |
| contact_groups | array | Contact group ids to alert (see statuscake_list_contact_groups). An empty list clears them. |
{
"name": "statuscake_create_heartbeat_check",
"title": "Create a heartbeat check",
"description": "Create a heartbeat (push) check for a cron job or worker: it goes down if StatusCake is not pinged within `period` seconds. Returns the new id as data.new_id; fetch it with statuscake_get_heartbeat_check to get the ping URL. StatusCake: POST /heartbeat.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"period"
],
"properties": {
"host": {
"type": "string",
"description": "Name of the hosting provider (informational)."
},
"name": {
"type": "string",
"minLength": 1,
"description": "Name of the check."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags for the check. An empty list clears them."
},
"paused": {
"type": "boolean",
"description": "Create the check paused."
},
"period": {
"type": "integer",
"maximum": 172800,
"minimum": 30,
"description": "Seconds since the last ping before the check is down, 30-172800 (e.g. 1800)."
},
"contact_groups": {
"type": "array",
"items": {
"type": "string"
},
"description": "Contact group ids to alert (see statuscake_list_contact_groups). An empty list clears them."
}
}
},
"annotations": {
"title": "Create a heartbeat check",
"destructiveHint": true
}
}Schedule a maintenance window that silences alerts for the given uptime checks (by id and/or tag). start_at/end_at are RFC3339; only the date and time are used and are read as local time in `timezone`. At least one of tests or tags is required. Only works on accounts using the newer maintenance-windows feature. StatusCake: POST /maintenance-windows.
| Parameter | Type | Description |
|---|---|---|
| name * | string | Name of the maintenance window. |
| tags | array | Include every uptime check carrying these tags. |
| tests | array | Uptime check ids to include. |
| end_at * | string | End, RFC3339, e.g. 2026-10-04T06:00:00Z. |
| start_at * | string | Start, RFC3339, e.g. 2026-10-04T01:30:00Z. |
| timezone * | string | IANA timezone the times are read in, e.g. UTC or Europe/London. |
| repeat_interval | string | How often it repeats: never, 1d, 1w, 2w or 1m. |
{
"name": "statuscake_create_maintenance_window",
"title": "Create a maintenance window",
"description": "Schedule a maintenance window that silences alerts for the given uptime checks (by id and/or tag). start_at/end_at are RFC3339; only the date and time are used and are read as local time in `timezone`. At least one of tests or tags is required. Only works on accounts using the newer maintenance-windows feature. StatusCake: POST /maintenance-windows.",
"inputSchema": {
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"start_at",
"end_at",
"timezone"
],
"properties": {
"name": {
"type": "string",
"minLength": 1,
"description": "Name of the maintenance window."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Include every uptime check carrying these tags."
},
"tests": {
"type": "array",
"items": {
"type": "string"
},
"description": "Uptime check ids to include."
},
"end_at": {
"type": "string",
"minLength": 1,
"description": "End, RFC3339, e.g. 2026-10-04T06:00:00Z."
},
"start_at": {
"type": "string",
"minLength": 1,
"description": "Start, RFC3339, e.g. 2026-10-04T01:30:00Z."
},
"timezone": {
"type": "string",
"minLength": 1,
"description": "IANA timezone the times are read in, e.g. UTC or Europe/London."
},
"repeat_interval": {
"enum": [
"never",
"1d",
"1w",
"2w",
"1m"
],
"type": "string",
"description": "How often it repeats: never, 1d, 1w, 2w or 1m."
}
}
},
"annotations": {
"title": "Create a maintenance window",
"destructiveHint": true
}
}Tools for StatusCake, hosted by usefulapi.io. If the user is new or asks what this server can do, suggest requests such as: "Are any of my website uptime checks down right now?"; "Which SSL certificates on my sites expire in the next 30 days?"; "How did my main website's uptime look over the last week?". Read-only tools never change data; ask the user before a tool that creates, changes or deletes StatusCake data. Free plan: 50 tool calls per month. Run statuscake_usage_status to see the calls used this month. If the user asks for something none of these tools can do, tell the user and, with their OK, run statuscake_request_feature to record the request. Paid plans: Pro (10,000 tool calls a month, $9/month or $90/year, for normal use) and Pro+ (100,000 tool calls a month, $39/month or $390/year, for automations and heavy use). A plan can be cancelled at any time and then runs to the end of the paid period, so it also suits a one-time job. When the user wants more calls or reaches the limit, run statuscake_upgrade without a plan: it returns both plans, each with a payment link for the user to open. statuscake_cancel_subscription cancels Pro at the end of the paid period.
Names, descriptions and schemas were written by the server and are shown as data.
Shared addresses on big platforms (Cloudflare, Vercel and the like) put unrelated servers together; those are marked shared_infrastructure. A match is a pivot, not a link between operators.