io.github.nguyenhuy158/healthchecksio-mcp
MCP server for Healthchecks.io API
Open source Open in the app JSON README (API)
About
MCP server for Healthchecks.io API
Details
- Kind
- MCP servers
- Topic
- Government & public data
- Publisher
- nguyenhuy158
- Origin
- official
- Category
- ferramentas
- Transport
- local
- Version
- 1.0.0
- Last push
- 2026-08-05T14:22:27Z
- Repository state
- ativo
- Language
- JavaScript
- Added
- 2026-08-29 04:00:53
- Updated
- 2026-08-29 04:00:53
- Origin id
io.github.nguyenhuy158/healthchecksio-mcp
README
# healthchecksio-mcp
<!-- mcp-name: io.github.nguyenhuy158/healthchecksio-mcp -->
🇬🇧 English · [🇻🇳 Tiếng Việt](./README-vi.md)
MCP server for the Healthchecks.io API. Lets Claude manage checks, channels, badges, and send pings.
## Install (dev)
```bash
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):
```bash
claude mcp add healthchecksio -e HEALTHCHECKS_API_KEY=your-key -- pnpm dlx github:nguyenhuy158/healthchecksio-mcp
```
npm also works:
```bash
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`:
```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)