Skip to main content
Watch: I Built an AI App Without Leaving Databricks

Observability - official Checkly server

Checkly MCP server

Hosted MCP server that connects MCP clients to a Checkly account over Streamable HTTP to read check status, results, test sessions and root cause analyses, create and update checks and groups, trigger existing checks, manage account environment variables and manage status page incidents. Checkly hosts it at https://api.checklyhq.com/mcp with OAuth or API key auth.

Last verified 15 tools5 sources

Install

Claude Code

About Claude Code
Terminal
claude mcp add --transport http checkly https://api.checklyhq.com/mcp

Codex

About Codex
Terminal
export CHECKLY_API_KEY="<checkly-api-key>"
codex mcp add checkly --url https://api.checklyhq.com/mcp --bearer-token-env-var CHECKLY_API_KEY

Cursor

About Cursor
JSON
{
  "mcpServers": {
    "checkly": {
      "type": "http",
      "url": "https://api.checklyhq.com/mcp",
      "auth": {
        "CLIENT_ID": "tpc_6UZKE6SnYVKGZKExoSK3FT",
        "scopes": [
          "checkly:account:read",
          "checkly:account:invite",
          "checkly:checks:read",
          "checkly:checks:write",
          "checkly:checks:run",
          "checkly:incidents:read",
          "checkly:incidents:write",
          "checkly:environment-variables:read",
          "checkly:environment-variables:write",
          "checkly:status-pages:read",
          "checkly:rca:read",
          "checkly:rca:run",
          "checkly:test-sessions:read",
          "checkly:assets:read",
          "checkly:usage:read"
        ]
      }
    }
  }
}

VS Code

JSON
{
  "servers": {
    "checkly": {
      "type": "http",
      "url": "https://api.checklyhq.com/mcp"
    }
  }
}

Tools

whoami
Return the authenticated user and account memberships visible to the MCP session.
get-account-entitlements
Return the resolved account plan and feature entitlement state.
prepare-local-check-authoring
Return an account-aware runbook for creating, testing, and deploying check code with the local Checkly CLI.
list-check-stats
Paginated, filterable list of checks with current pass, fail, and degraded status, optionally with reliability metrics.
get-check
Return the full configuration of one check.
create-check
Create a standalone check of any supported type from a JSON configuration.
update-check
Update shared check properties or a partial type-specific configuration.
delete-check
Permanently delete a check and its result history; requires confirmation.
list-check-results
List recent compact results for one check.
trigger-checks
Run existing deployed checks on demand and record the run as a test session.
list-test-sessions
List recent test sessions with filters and cursor ordering.
fetch-check-result-asset
Fetch one selected check-result asset, inline for small text or as a download link.
trigger-root-cause-analysis
Trigger a new Rocky AI root cause analysis for a check or test-session error group.
create-account-environment-variable
Create an account-level variable or secret.
create-status-page-incident
Create a new status page incident and optionally notify subscribers.

As documented on October 17, 2026. A running server reports its current list through tools/list.

Notes and caveats

  • Remote-only; cannot access the local filesystem (use Checkly Skills and CLI for project files).
  • OAuth works only with Checkly-approved clients (ChatGPT, Claude Desktop, Claude Code, Mistral Vibe, Devin CLI, Antigravity, OpenCode, Cursor, VS Code); Dynamic Client Registration clients are rejected.
  • Codex, Cline and Windsurf have no approved OAuth client, so Codex uses an API key.
  • API keys go in an Authorization: Bearer header: user keys (cu_...) or service keys (sv_...), service keys require a Starter, Team or Enterprise plan.
  • Optional X-Checkly-Account header pins an account.
  • First version launched in the June 2026 changelog; docs call the endpoint the production endpoint and the tool list the v1 surface.
  • Supports protocol versions 2026-07-28 and 2025-06-18.
  • No public source repo found.

More MCP servers for observability

Related reading

FAQ

What does the Checkly MCP server do?

Hosted MCP server that connects MCP clients to a Checkly account over Streamable HTTP to read check status, results, test sessions and root cause analyses, create and update checks and groups, trigger existing checks, manage account environment variables and manage status page incidents. The vendor documents 15 tools, including whoami, get-account-entitlements, prepare-local-check-authoring and list-check-stats.

How do I add the Checkly MCP server to Claude Code?

Run claude mcp add --transport http checkly https://api.checklyhq.com/mcp, copied from Checkly's docs. This page also has snippets for Codex, Cursor and VS Code.

Does the Checkly MCP server need authentication?

Yes, OAuth or API key. Transport: Streamable HTTP. Status: Unlabelled, last checked October 17, 2026.

Sources

Last verified against 5 Checkly pages, then re-checked independently.

Newsletter

New MCP servers, the week they ship

One email per week. New official MCP servers, the coding tools that support them and how developers wire them up.