# Healthchecksio MCP

> Healthchecksio MCP is an open-source MCP server for cloud and infrastructure. MCP server letting Claude manage Healthchecks.io cron and uptime checks. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Open source
- **Platforms:** CLI, Self-hosted
- **Repository:** https://github.com/nguyenhuy158/healthchecksio-mcp
- **MCP Registry name:** io.github.nguyenhuy158/healthchecksio-mcp
- **Categories:** [cloud and infrastructure](https://ai-powered.com/categories/cloud-and-infrastructure)
- **Listing updated:** 2026-11-18

## About

The README says this server connects Claude to the Healthchecks.io API so an assistant can work with monitoring checks directly. Through it you can list, inspect, create, update, pause, resume and delete checks, review up/down status history, look at notification channels and badge URLs, and send heartbeat pings.

It runs over stdio and is started with an API key from the Healthchecks.io Settings > API Access page. Installation is shown through pnpm or npm, either straight from the GitHub repository or from a local build registered in Claude Code or Claude Desktop config files.

The server suits developers and operators who already use Healthchecks.io for cron jobs or service heartbeats and want to manage them from a chat session. Self-hosted Healthchecks instances are supported by overriding the API and ping URLs.

## Features

- **Check management:** Create, read, update, pause, resume and delete monitoring checks through the API.
- **Status history:** Retrieve up and down flip history for a check.
- **Heartbeat pings:** Send success, failure, start or log pings to a check.
- **Tag and status filtering:** List checks filtered by tag or current status.
- **Channel and badge lookup:** View notification channels and badge URLs.
- **Self-hosting support:** Override the API and ping base URLs for a self-hosted Healthchecks instance.

## Good for

- Pausing or resuming cron job monitors during planned maintenance
- Checking which services are currently down from a chat session
- Creating new heartbeat checks while setting up scheduled jobs
- Reviewing status history when investigating recurring failures

## Install

### Claude Code (Terminal)

```sh
claude mcp add healthchecksio-mcp --env HEALTHCHECKS_API_KEY='<HEALTHCHECKS_API_KEY>' -- npx -y healthchecksio-mcp
```

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "healthchecksio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "healthchecksio-mcp"
      ],
      "env": {
        "HEALTHCHECKS_API_KEY": "<HEALTHCHECKS_API_KEY>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "healthchecksio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "healthchecksio-mcp"
      ],
      "env": {
        "HEALTHCHECKS_API_KEY": "<HEALTHCHECKS_API_KEY>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "healthchecksio-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "healthchecksio-mcp"
      ],
      "env": {
        "HEALTHCHECKS_API_KEY": "<HEALTHCHECKS_API_KEY>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "healthchecksio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "healthchecksio-mcp"
      ],
      "env": {
        "HEALTHCHECKS_API_KEY": "<HEALTHCHECKS_API_KEY>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "healthchecksio-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "healthchecksio-mcp"
      ],
      "env": {
        "HEALTHCHECKS_API_KEY": "<HEALTHCHECKS_API_KEY>"
      }
    }
  }
}
```

## Tools

- `list_checks`: List checks, filter by tag/status
- `get_check`: Get a single check's details
- `create_check`: Create a new check
- `update_check`: Update a check
- `pause_check`: Pause a check
- `resume_check`: Resume a check
- `delete_check`: Delete a check
- `list_check_flips`: Up/down status history
- `list_channels`: Notification channels
- `list_badges`: Badge URLs
- `ping`: Send a heartbeat ping (success/fail/start/log)

## FAQ

### What do I need to run Healthchecksio MCP?

A Healthchecks.io API key set as HEALTHCHECKS_API_KEY. The README says the key comes from Settings > API Access on healthchecks.io.

### Can Healthchecksio MCP be used with a self-hosted Healthchecks instance?

Yes. The README says to change HEALTHCHECKS_API_URL and HEALTHCHECKS_PING_URL when self-hosting.

### How is Healthchecksio MCP installed?

The README shows installing from GitHub with pnpm dlx or npx, or running a local build registered in Claude Code or Claude Desktop config.

### Is Healthchecksio MCP free?

Yes. Healthchecksio MCP is open source, so you can use and self-host it for free.

### How do I add Healthchecksio MCP to Claude Code?

Run this command in your terminal: claude mcp add healthchecksio-mcp --env HEALTHCHECKS_API_KEY='<HEALTHCHECKS_API_KEY>' -- npx -y healthchecksio-mcp

### What are the best alternatives to Healthchecksio MCP?

The closest alternatives to Healthchecksio MCP are UptimeX, Uptrack MCP, OpenUptime, Monitor Hub and Drumbeats.

## Where this comes from

- Description: written from the project's README and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [UptimeX](https://ai-powered.com/mcp/uptimex): UptimeX is a freemium MCP server for cloud and infrastructure.
- [Uptrack MCP](https://ai-powered.com/mcp/uptrack-mcp): Uptrack MCP is a freemium MCP server for cloud and infrastructure.
- [OpenUptime](https://ai-powered.com/mcp/openuptime): OpenUptime is an open-source MCP server for cloud and infrastructure.
- [Monitor Hub](https://ai-powered.com/mcp/monitor-hub): Monitor Hub is a freemium MCP server for cloud and infrastructure.
- [Drumbeats](https://ai-powered.com/mcp/drumbeats): Drumbeats is a freemium MCP server for developer tools.
- [Fettle](https://ai-powered.com/mcp/fettle): Fettle is a freemium MCP server for cloud and infrastructure.
- [Okokumo](https://ai-powered.com/mcp/okokumo): Okokumo is a freemium MCP server for cloud and infrastructure.
- [Watchgoose](https://ai-powered.com/mcp/watchgoose): Watchgoose is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/healthchecksio-mcp
