Skip to main content
The Checkly MCP Server lets MCP clients connect to Checkly over Streamable HTTP and use Checkly tools from your conversation. Use the production MCP endpoint in your client:
OAuth is the recommended way to connect. The OAuth flow only supports Checkly-approved clients listed in setup. User and service API keys are available for clients that can send custom headers when OAuth is unavailable or a workflow needs a stable service identity.
Use it when your agent needs live Checkly account context, check status, check results, test sessions, root cause analyses, result assets, status pages, incidents, account environment variables, or when it needs to trigger existing checks.
Use Checkly Skills and the Checkly CLI when your agent needs to create, edit, test, bundle, or deploy check code. The MCP server runs remotely and cannot access your local filesystem.

​
What you can do

  • Inspect account membership, plan, and feature entitlements.
  • Check which checks are passing, failing, muted, or deactivated.
  • Read compact check results and test-session results.
  • Fetch normalized result asset manifests and bounded text assets.
  • Start or read Rocky AI root cause analyses.
  • Trigger existing deployed checks on demand.
  • Manage account-level environment variables and secrets.
  • Read status pages and manage status page incidents.

​
Quick start

Before connecting an MCP client, ensure you have:
  • A Checkly user account.
  • Access to the Checkly account you want the MCP client to use.
  • A supported OAuth MCP client, or an MCP client that can send custom HTTP headers for API-key authentication.
Choose an authentication method and add the Checkly MCP endpoint to your client. Complete OAuth or configure an API-key header, then ask your client to verify the connection.
Prompt
If you belong to more than one Checkly account, tell your client which account to use in your prompt. To always use the same account, set the X-Checkly-Account header when your client supports custom MCP headers. See Set up the MCP server for client configuration examples.

​
Example prompts

Basic prompts:
Prompt
Prompt
Prompt
Advanced prompts:
Prompt
Prompt
Prompt

​
MCP, Skills, and CLI

MCP, Checkly Skills, and the Checkly CLI are complementary. Use the MCP Server for quick access to live Checkly data and account actions. OAuth is the recommended connection method; use an API key when OAuth is unavailable or when automation needs an account-scoped service identity. Use Checkly Skills with the CLI when your agent needs to create, edit, test, or deploy code from your local project. See Skills, MCP, and the CLI for a full comparison of when to use each.

​
Learn more