Skip to content
MCP server

Healthchecks.io MCP by usefulapi

Manage cron/heartbeat checks, read pings and flips, pause/resume/delete on…

Install
Runs
Remotely
Version
1.40.0
Listing updated
4 days ago

About Healthchecks.io MCP by usefulapi

Healthchecks.io MCP by usefulapi is an MCP server. It runs as a hosted remote server, so there is nothing to install locally.

Manage cron/heartbeat checks, read pings and flips, pause/resume/delete on Healthchecks.io.

Install

Run in a terminal

claude mcp add --transport http healthchecksio https://healthchecksio.usefulapi.io/mcp

Add to Settings → Connectors → Add custom connector

https://healthchecksio.usefulapi.io/mcp
Install in CursorOpens Cursor, which asks you to confirm. Or add it by hand:

Add to ~/.cursor/mcp.json

{
  "mcpServers": {
    "healthchecksio": {
      "url": "https://healthchecksio.usefulapi.io/mcp"
    }
  }
}
Install in VS CodeOpens VS Code, which asks you to confirm. Or add it by hand:

Add to .vscode/mcp.json

{
  "servers": {
    "healthchecksio": {
      "type": "http",
      "url": "https://healthchecksio.usefulapi.io/mcp"
    }
  }
}

Add to ~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "healthchecksio": {
      "serverUrl": "https://healthchecksio.usefulapi.io/mcp"
    }
  }
}

Add to your client's MCP settings (most use this shape)

{
  "mcpServers": {
    "healthchecksio": {
      "type": "http",
      "url": "https://healthchecksio.usefulapi.io/mcp"
    }
  }
}

Tools this server provides (12)

Read directly from the server.

healthchecksio_list_checks
List all checks in the project, optionally filtered by slug and/or tags. Returns {checks:[...]} — each check's status, schedule, last ping, and ping URL. Healthchecks: GET /checks/.
healthchecksio_get_check
Get a single check by its UUID (or its unique read-only key). Returns the check's full state — status, timeout/schedule, grace, tags, last ping. Healthchecks: GET /checks/{uuid}.
healthchecksio_list_pings
List a check's logged pings (100 on the free plan, 1000 on paid), most recent first. Each ping: type, date, n, scheme, remote_addr, method, ua, rid, duration, body_url. Healthchecks: GET /checks/{uuid}/pings/.
healthchecksio_get_ping_body
Get the logged request body of a single ping, returned as PLAIN TEXT (verbatim, not JSON). Healthchecks: GET /checks/{uuid}/pings/{n}/body.
healthchecksio_list_flips
List a check's status changes ("flips") over time — [{timestamp, up}]. Optionally scope by a lookback window or an explicit start/end range. Healthchecks: GET /checks/{uuid}/flips/.
healthchecksio_list_integrations
List the project's notification integrations ("channels") — {channels:[{id, name, kind}]}. The ids are what you assign to a check's `channels` field. Needs a read-write API key: a read-only key gets HTTP 401. Healthchecks: GET /channels/.
healthchecksio_list_badges
List the project's status-badge URLs per tag (plus "*" for the overall status) — {badges:{...}}. Healthchecks: GET /badges/.
healthchecksio_create_check
CREATES a new check — this MODIFIES live monitoring config. Provide a `timeout` (simple period-based check) OR a `schedule` + `tz` (cron-based check); the two are mutually exclusive. Use `unique` to avoid creating duplicates. Assign notifications via `channels`. Healthchecks: POST /checks/. Returns the created check (201) or the existing match (200).
healthchecksio_update_check
UPDATES an existing check by UUID — this MODIFIES live monitoring config. Send only the fields you want to change (timeout and schedule remain mutually exclusive). Healthchecks: POST /checks/{uuid}. Returns the updated check.
healthchecksio_pause_check
PAUSES a check — disables monitoring without deleting it (it stops going down for missed pings until it next receives a ping or is resumed). This MODIFIES live monitoring config. Healthchecks: POST /checks/{uuid}/pause (empty body).
healthchecksio_resume_check
RESUMES a paused check — re-enables monitoring. This MODIFIES live monitoring config. Returns HTTP 409 (surfaced cleanly) if the check is not currently paused. Healthchecks: POST /checks/{uuid}/resume (empty body).
healthchecksio_delete_check
PERMANENTLY DELETES a check by UUID — this MODIFIES live monitoring config and cannot be undone. Healthchecks: DELETE /checks/{uuid}. Returns the deleted check's last known state.

Healthchecks.io MCP by usefulapi FAQ

How do I add Healthchecks.io MCP by usefulapi to Claude Code?

Run this command in your terminal: claude mcp add --transport http healthchecksio https://healthchecksio.usefulapi.io/mcp