Skip to main content

At a glance

Credentials

Set these per environment. See Connect an integration.

Setup

  1. Sign up for Checkly: Create a free account at https://app.checklyhq.com (the free Hobby plan includes API access) and create at least one check.
  2. Create an API key: Go to User Settings → API keys (https://app.checklyhq.com/settings/user/api-keys), create a key, and add it to your .env as CHECKLY_API_KEY.
  3. Copy your account ID: Find the account ID under Account Settings → General and add it as CHECKLY_ACCOUNT_ID.
  4. Verify access: Run List Checks, then List Check Statuses.

Provider notes

  • Every request needs both ‘Authorization: Bearer <api key>’ and the ‘X-Checkly-Account: <account id>’ header
  • Raw check results are kept for 30 days, and a results query window (from/to) may span at most 6 hours
  • Check results use the newer /v2 path; checks and statuses use /v1
Provider API reference.

Tools

Verify the connection

Call a read tool such as checkly__list_checks with arguments for your account. Confirm that the result comes from the intended account or workspace before enabling write tools.