Query Checkly synthetic monitoring — checks, statuses, results, alerts, reporting and dashboards.
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
MODIFIES THE CHECKLY ACCOUNT: schedules a maintenance window that silences alerts for a time range (e.g. during a deploy). Omit repeatUnit for a one-off window. Public API: POST /v1/maintenance-windows.
Maintenance window name.
End time, ISO-8601.
Start time, ISO-8601 (e.g. 2026-07-15T22:00:00.000Z).
Tags of checks/groups to include in the window.
For a recurring window: DAY, WEEK, or MONTH. Omit for one-off.
Optional description.
Silence alerts for ALL checks (overrides tag scoping).
The server marks this tool as destructive. Running it may delete or overwrite data on the server or in any account you connected with your headers.
MODIFIES THE CHECKLY ACCOUNT: schedules a maintenance window that silences alerts for a time range (e.g. during a deploy). Omit repeatUnit for a one-off window. Public API: POST /v1/maintenance-windows.
| Argument | Type | Description |
|---|---|---|
| name* | string | Maintenance window name. |
| tags | array | Tags of checks/groups to include in the window. |
| endsAt* | string | End time, ISO-8601. |
| startsAt* | string | Start time, ISO-8601 (e.g. 2026-07-15T22:00:00.000Z). |
| repeatUnit | string | For a recurring window: DAY, WEEK, or MONTH. Omit for one-off. |
| description | string | Optional description. |
| silenceAllAlerts | boolean | Silence alerts for ALL checks (overrides tag scoping). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"name",
"startsAt",
"endsAt"
],
"properties": {
"name": {
"type": "string",
"description": "Maintenance window name."
},
"tags": {
"type": "array",
"items": {
"type": "string"
},
"description": "Tags of checks/groups to include in the window."
},
"endsAt": {
"type": "string",
"description": "End time, ISO-8601."
},
"startsAt": {
"type": "string",
"description": "Start time, ISO-8601 (e.g. 2026-07-15T22:00:00.000Z)."
},
"repeatUnit": {
"enum": [
"DAY",
"WEEK",
"MONTH"
],
"type": "string",
"description": "For a recurring window: DAY, WEEK, or MONTH. Omit for one-off."
},
"description": {
"type": "string",
"description": "Optional description."
},
"silenceAllAlerts": {
"type": "boolean",
"description": "Silence alerts for ALL checks (overrides tag scoping)."
}
}
}MODIFIES THE CHECKLY ACCOUNT: creates a new account-level environment variable. Additive (does not overwrite existing keys). Public API: POST /v1/variables.
| Argument | Type | Description |
|---|---|---|
| key* | string | The variable key (cannot be changed later). |
| value* | string | The variable value. |
| locked | boolean | Hide the value like a password in the UI. |
| secret | boolean | Mark as secret — value becomes write-only after creation. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"key",
"value"
],
"properties": {
"key": {
"type": "string",
"description": "The variable key (cannot be changed later)."
},
"value": {
"type": "string",
"description": "The variable value."
},
"locked": {
"type": "boolean",
"description": "Hide the value like a password in the UI."
},
"secret": {
"type": "boolean",
"description": "Mark as secret — value becomes write-only after creation."
}
}
}Fetch details of the Checkly account tied to your credentials. Public API: GET /v1/accounts/me.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Retrieve a single check's full configuration by id. Public API: GET /v1/checks/{id}.
| Argument | Type | Description |
|---|---|---|
| id* | string | The check id. |
| includeDependencies | boolean | Include dependent resources (snippets, alert channels). |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"description": "The check id."
},
"includeDependencies": {
"type": "boolean",
"description": "Include dependent resources (snippets, alert channels)."
}
}
}List alert notifications for one specific check. Public API: GET /v1/check-alerts/{checkId}.
| Argument | Type | Description |
|---|---|---|
| to | integer | End of range as a Unix timestamp (seconds). |
| from | integer | Start of range as a Unix timestamp (seconds). |
| page | integer | 1-based page number. |
| limit | integer | Page size. |
| checkId* | string | The check id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"checkId"
],
"properties": {
"to": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "End of range as a Unix timestamp (seconds)."
},
"from": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Start of range as a Unix timestamp (seconds)."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "1-based page number.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page size.",
"exclusiveMinimum": 0
},
"checkId": {
"type": "string",
"description": "The check id."
}
}
}Retrieve a single check group by id. Public API: GET /v1/check-groups/{id}.
| Argument | Type | Description |
|---|---|---|
| id* | integer | The check group id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"id"
],
"properties": {
"id": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "The check group id."
}
}
}Retrieve a single check-run result in full. Public API: GET /v1/check-results/{checkId}/{checkResultId}.
| Argument | Type | Description |
|---|---|---|
| checkId* | string | The check id. |
| checkResultId* | string | The check result id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"checkId",
"checkResultId"
],
"properties": {
"checkId": {
"type": "string",
"description": "The check id."
},
"checkResultId": {
"type": "string",
"description": "The check result id."
}
}
}Retrieve the current status details for a single check. Public API: GET /v1/check-statuses/{checkId}.
| Argument | Type | Description |
|---|---|---|
| checkId* | string | The check id. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"checkId"
],
"properties": {
"checkId": {
"type": "string",
"description": "The check id."
}
}
}Aggregated availability / performance / SLA report across checks and groups. Public API: GET /v1/reporting.
| Argument | Type | Description |
|---|---|---|
| to | integer | End of range as a Unix timestamp (seconds). |
| from | integer | Start of range as a Unix timestamp (seconds). |
| timezone | string | IANA timezone, e.g. Europe/Berlin. |
| quickRange | string | Preset range, e.g. last24Hrs, last7Days, last30Days, thisWeek, thisMonth, lastWeek, lastMonth. |
| granularity | string | Bucket size for time series. |
| filterByTags | string | Filter by a tag. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"to": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "End of range as a Unix timestamp (seconds)."
},
"from": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Start of range as a Unix timestamp (seconds)."
},
"timezone": {
"type": "string",
"description": "IANA timezone, e.g. Europe/Berlin."
},
"quickRange": {
"type": "string",
"description": "Preset range, e.g. last24Hrs, last7Days, last30Days, thisWeek, thisMonth, lastWeek, lastMonth."
},
"granularity": {
"enum": [
"day",
"week",
"month"
],
"type": "string",
"description": "Bucket size for time series."
},
"filterByTags": {
"type": "string",
"description": "Filter by a tag."
}
}
}List all alert channels (email, Slack, webhook, PagerDuty, etc.) configured in the account. Public API: GET /v1/alert-channels.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Page size. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "1-based page number.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page size.",
"exclusiveMinimum": 0
}
}
}List recent alert notifications fired across the whole account. Public API: GET /v1/check-alerts.
| Argument | Type | Description |
|---|---|---|
| to | integer | End of range as a Unix timestamp (seconds). |
| from | integer | Start of range as a Unix timestamp (seconds). |
| page | integer | 1-based page number. |
| limit | integer | Page size. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"to": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "End of range as a Unix timestamp (seconds)."
},
"from": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Start of range as a Unix timestamp (seconds)."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "1-based page number.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page size.",
"exclusiveMinimum": 0
}
}
}List all check groups (shared config for a set of checks). Public API: GET /v1/check-groups.
| Argument | Type | Description |
|---|---|---|
| tag | string | Filter by a tag. |
| name | string | Filter by group name. |
| page | integer | 1-based page number. |
| limit | integer | Page size. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"tag": {
"type": "string",
"description": "Filter by a tag."
},
"name": {
"type": "string",
"description": "Filter by group name."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "1-based page number.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page size.",
"exclusiveMinimum": 0
}
}
}List individual run results for a check (latency, success, location, response). Public API: GET /v1/check-results/{checkId}.
| Argument | Type | Description |
|---|---|---|
| to | integer | End of range as a Unix timestamp (seconds). |
| from | integer | Start of range as a Unix timestamp (seconds). |
| page | integer | 1-based page number. |
| limit | integer | Page size. |
| checkId* | string | The check id. |
| location | string | Filter by run location, e.g. eu-west-1. |
| resultType | string | FINAL, ATTEMPT, or ALL. |
| hasFailures | boolean | Only return results that contain failures. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"checkId"
],
"properties": {
"to": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "End of range as a Unix timestamp (seconds)."
},
"from": {
"type": "integer",
"maximum": 9007199254740991,
"minimum": -9007199254740991,
"description": "Start of range as a Unix timestamp (seconds)."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "1-based page number.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page size.",
"exclusiveMinimum": 0
},
"checkId": {
"type": "string",
"description": "The check id."
},
"location": {
"type": "string",
"description": "Filter by run location, e.g. eu-west-1."
},
"resultType": {
"enum": [
"FINAL",
"ATTEMPT",
"ALL"
],
"type": "string",
"description": "FINAL, ATTEMPT, or ALL."
},
"hasFailures": {
"type": "boolean",
"description": "Only return results that contain failures."
}
}
}List the current pass/fail/degraded status of every check — the 'what's down right now' view. Public API: GET /v1/check-statuses.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}List all synthetic monitoring checks (API, browser, URL, heartbeat, etc.) in the account. Public API: GET /v1/checks.
| Argument | Type | Description |
|---|---|---|
| tag | string | Filter by a tag. |
| page | integer | 1-based page number. |
| limit | integer | Page size. |
| search | string | Free-text search across check names. |
| checkType | string | Filter by check type, e.g. API, BROWSER, URL, HEARTBEAT. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"tag": {
"type": "string",
"description": "Filter by a tag."
},
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "1-based page number.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page size.",
"exclusiveMinimum": 0
},
"search": {
"type": "string",
"description": "Free-text search across check names."
},
"checkType": {
"type": "string",
"description": "Filter by check type, e.g. API, BROWSER, URL, HEARTBEAT."
}
}
}List all public/private status dashboards. Public API: GET /v1/dashboards.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Page size. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "1-based page number.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page size.",
"exclusiveMinimum": 0
}
}
}List all public checking locations Checkly can run checks from. Public API: GET /v1/locations.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}List all maintenance windows (periods where alerts are silenced). Public API: GET /v1/maintenance-windows.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Page size. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "1-based page number.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page size.",
"exclusiveMinimum": 0
}
}
}List all private (self-hosted) checking locations. Public API: GET /v1/private-locations.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}List all supported runtimes (Node versions + bundled dependencies) for browser/API checks. Public API: GET /v1/runtimes.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}List all reusable code snippets. Public API: GET /v1/snippets.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Page size. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "1-based page number.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page size.",
"exclusiveMinimum": 0
}
}
}List all account-level environment variables. Note: secret variable values are redacted by the API. Public API: GET /v1/variables.
| Argument | Type | Description |
|---|---|---|
| page | integer | 1-based page number. |
| limit | integer | Page size. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"page": {
"type": "integer",
"maximum": 9007199254740991,
"description": "1-based page number.",
"exclusiveMinimum": 0
},
"limit": {
"type": "integer",
"maximum": 9007199254740991,
"description": "Page size.",
"exclusiveMinimum": 0
}
}
}