Healthchecksio MCP 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)