Skip to main content
Use the production MCP endpoint in your client: 
https://api.checklyhq.com/mcp
The Checkly MCP Server only supports the clients listed below. Clients that use Dynamic Client Registration (DCR) are rejected.

​
Supported clients

The public Checkly MCP Server currently supports:
  • ChatGPT
  • Claude Desktop
  • Claude Code
  • Antigravity
  • Cursor
  • VS Code
Each supported client uses OAuth Client ID Metadata Documents (CIMD) and must be allowed by Checkly in Auth0 before it can connect. Clients that rely on DCR are not supported. If you want Checkly to support another CIMD-capable client, share feedback or requests.

​
ChatGPT

Follow OpenAI’s Developer mode and MCP apps in ChatGPT guide. Use the Checkly MCP endpoint from this page as the MCP server endpoint.

​
Claude Desktop

Follow Claude’s custom connectors using remote MCP guide. Use the Checkly MCP endpoint from this page as the remote MCP server URL.

​
Claude Code

Add the server with the HTTP transport:
Terminal
claude mcp add --transport http checkly https://api.checklyhq.com/mcp
Start a Claude Code session and complete the OAuth flow when prompted.

​
Antigravity

Follow Google’s Antigravity MCP integration guide. Use the Checkly MCP endpoint from this page as the MCP server URL.

​
Cursor

Add the server to .cursor/mcp.json in your project, or to ~/.cursor/mcp.json for all projects:
mcp.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: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"
        ]
      }
    }
  }
}
Restart Cursor after changing the configuration.

​
VS Code

Add the server to .vscode/mcp.json in your workspace, or to your VS Code user profile:
mcp.json
{
  "servers": {
    "checkly": {
      "type": "http",
      "url": "https://api.checklyhq.com/mcp"
    }
  }
}
Restart VS Code after changing the configuration.

​
Known client limitations

Some MCP clients support remote MCP servers but do not work with the public Checkly MCP Server yet. If your preferred CIMD-capable client is missing, share feedback or requests.

​
Cline

Cline is not currently supported for Checkly MCP OAuth because of its current OAuth limitation. You can follow or upvote the Checkly Cline support request.

​
Windsurf / Devin Desktop

Windsurf / Devin Desktop is not currently supported for Checkly MCP OAuth because of its current OAuth limitation. You can follow or upvote the Checkly Devin support request.

​
Devin CLI

Devin CLI is not currently supported for Checkly MCP OAuth because of its current OAuth limitation. You can follow or upvote the Checkly Devin support request.

​
Use a specific account

If you belong to multiple Checkly accounts, tell your MCP client which account you want to use in your prompt:
Prompt
Use Checkly to show the accounts I can access, then show failing checks for <account-name>.
To make every request from an MCP server configuration use the same account, set the X-Checkly-Account header when your client supports custom MCP headers. For Claude Code, add the header when you register the server:
Terminal
claude mcp add --transport http checkly https://api.checklyhq.com/mcp --header "X-Checkly-Account: <account-id>"
For clients that use an mcpServers JSON configuration, add headers to the Checkly server entry:
mcp.json
{
  "mcpServers": {
    "checkly": {
      "url": "https://api.checklyhq.com/mcp",
      "headers": {
        "X-Checkly-Account": "<account-id>"
      }
    }
  }
}
Use the account ID from Checkly. Omit the header when you want to choose the account in your prompts.

​
Verify the connection

After authentication, ask your MCP client:
Prompt
Use Checkly to show which accounts I can access.
Then verify tool access:
Prompt
Use Checkly to list the tools available to this session.
The visible tools depend on the OAuth permissions granted to your MCP session. See Security and permissions for details.