mcpField
H
healthchecksio-mcp

healthchecksio-mcp

Local
github.com/nguyenhuy158Cloud & Infra0Updated 12w ago
Repository

About healthchecksio-mcp

healthchecksio-mcp is an MCP server for the Healthchecks.io API, allowing Claude to manage checks, channels, and badges and send pings. It supports check lookup, creation, updates, pausing, resuming, and deletion.

Key features

  1. 01List and filter checks
  2. 02Create, update, and delete checks
  3. 03Pause or resume checks
  4. 04Review status-change history
  5. 05List notification channels and badges
  6. 06Send success, failure, or start pings

Use cases

  1. 01Find checks by tag or status
  2. 02Adjust or pause an existing check
  3. 03Review service status-change history
  4. 04Send a heartbeat to Healthchecks.io

MCP support

The MCP server connects to the Healthchecks.io API and exposes check, channel, badge, and ping operations to MCP clients. It requires HEALTHCHECKS_API_KEY.

Configuration

Local server config is the same for every client. Copy it into your client’s MCP config file.

mcp.json · Universal config
{
  "mcpServers": {
    "nguyenhuy158-healthchecksio": {
      "command": "npx",
      "args": [
        "-y",
        "healthchecksio-mcp"
      ],
      "env": {
        "HEALTHCHECKS_API_KEY": "<HEALTHCHECKS_API_KEY>"
      }
    }
  }
}
Run commandnpx -y healthchecksio-mcp
Environment variables to set
HEALTHCHECKS_API_KEYSecretHealthchecks.io API key

Local servers need a runtime on your machine (e.g. Node.js 18+). Config file locations differ by client; see your client’s docs.

Packages
npmhealthchecksio-mcp1.0.0

Tools

11

Saved tool list · updated 2w ago

ParameterTypeRequiredDescription
tagsarrayNoOnly return checks having all of these tags
statusarrayNoOnly return checks with one of these statuses

Details

From the project README

healthchecksio-mcp

🇬🇧 English · 🇻🇳 Tiếng Việt

MCP server for the Healthchecks.io API. Lets Claude manage checks, channels, badges, and send pings.

Install (dev)

pnpm install
pnpm run build

(npm also works: npm install && npm run build)

Env config

  • HEALTHCHECKS_API_KEY (required) — API key from Settings > API Access on healthchecks.io.
  • HEALTHCHECKS_API_URL (optional) — defaults to https://healthchecks.io/api/v3. Change if self-hosting.
  • HEALTHCHECKS_PING_URL (optional) — defaults to https://hc-ping.com. Change if self-hosting.

Register with Claude Code

Install straight from GitHub, no clone needed (pnpm preferred):

claude mcp add healthchecksio -e HEALTHCHECKS_API_KEY=your-key -- pnpm dlx github:nguyenhuy158/healthchecksio-mcp

npm also works:

claude mcp add healthchecksio -e HEALTHCHECKS_API_KEY=your-key -- npx -y github:nguyenhuy158/healthchecksio-mcp

Or run from a local build, adding to .mcp.json / claude_desktop_config.json:

{
  "mcpServers": {
    "healthchecksio": {
      "command": "node",
      "args": ["/path/to/healthchecksio-mcp/build/index.js"],
      "env": {
        "HEALTHCHECKS_API_KEY": "your-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 / resume_check
  • delete_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)

Comments

Markdown supported

New to MCP?

From what the protocol is to installing your first server, these answers cover most first questions.

An open protocol that defines how AI applications connect to external tools and data in a uniform way. Clients talk to the model; MCP servers provide tools, resources and prompt templates. They exchange standard messages, so one server can be reused by many clients.