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).

destructive

Argument	Type	Description
tz	string	Server's timezone for the cron `schedule`, e.g. "Europe/Riga".
desc	string	Free-form description of the check.
name	string	Human-readable name for the check.
slug	string	URL slug (used for slug-based ping URLs).
tags	string	Space-separated list of tags, e.g. "prod db backups".
grace	integer	Grace time in seconds after the deadline before the check goes down.
unique	array	Dedupe fields — if a check already matches on these (e.g. ["name"]), it is returned instead of created.
methods	string	Allowed ping HTTP methods: "" (any) or "POST" (POST-only).
timeout	integer	Expected period between pings, in seconds (60..31536000). Mutually exclusive with `schedule`.
channels	string	Integrations to assign: "*" for all, or a comma-separated list of integration ids.
schedule	string	Cron expression for the expected ping schedule (e.g. "15 5 * * *"). Mutually exclusive with `timeout`; requires `tz`.
manual_resume	boolean	If true, a paused check does not auto-resume on the next ping (resume manually).

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "tz": {
      "type": "string",
      "description": "Server's timezone for the cron `schedule`, e.g. \"Europe/Riga\"."
    },
    "desc": {
      "type": "string",
      "description": "Free-form description of the check."
    },
    "name": {
      "type": "string",
      "description": "Human-readable name for the check."
    },
    "slug": {
      "type": "string",
      "description": "URL slug (used for slug-based ping URLs)."
    },
    "tags": {
      "type": "string",
      "description": "Space-separated list of tags, e.g. \"prod db backups\"."
    },
    "grace": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Grace time in seconds after the deadline before the check goes down."
    },
    "unique": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Dedupe fields — if a check already matches on these (e.g. [\"name\"]), it is returned instead of created."
    },
    "methods": {
      "type": "string",
      "description": "Allowed ping HTTP methods: \"\" (any) or \"POST\" (POST-only)."
    },
    "timeout": {
      "type": "integer",
      "maximum": 31536000,
      "minimum": 60,
      "description": "Expected period between pings, in seconds (60..31536000). Mutually exclusive with `schedule`."
    },
    "channels": {
      "type": "string",
      "description": "Integrations to assign: \"*\" for all, or a comma-separated list of integration ids."
    },
    "schedule": {
      "type": "string",
      "description": "Cron expression for the expected ping schedule (e.g. \"15 5 * * *\"). Mutually exclusive with `timeout`; requires `tz`."
    },
    "manual_resume": {
      "type": "boolean",
      "description": "If true, a paused check does not auto-resume on the next ping (resume manually)."
    }
  }
}

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.

destructive

Argument	Type	Description
uuid*	string	The check's UUID to delete.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "uuid"
  ],
  "properties": {
    "uuid": {
      "type": "string",
      "description": "The check's UUID to delete."
    }
  }
}

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}.

read-only

Argument	Type	Description
uuid*	string	The check's UUID, or its unique read-only key.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "uuid"
  ],
  "properties": {
    "uuid": {
      "type": "string",
      "description": "The check's UUID, or its unique read-only key."
    }
  }
}

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.

read-only

Argument	Type	Description
n*	integer	The ping's sequence number (the `n` field from list_pings).
uuid*	string	The check's UUID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "uuid",
    "n"
  ],
  "properties": {
    "n": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "The ping's sequence number (the `n` field from list_pings)."
    },
    "uuid": {
      "type": "string",
      "description": "The check's UUID."
    }
  }
}

healthchecksio_list_badges

List the project's status-badge URLs per tag (plus "*" for the overall status) — {badges:{...}}. Healthchecks: GET /badges/.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

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/.

read-only

Argument	Type	Description
tag	array	Filter to checks carrying ALL of these tags (each is sent as a separate `tag` query param).
slug	string	Filter to checks with this exact slug.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {
    "tag": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "description": "Filter to checks carrying ALL of these tags (each is sent as a separate `tag` query param)."
    },
    "slug": {
      "type": "string",
      "description": "Filter to checks with this exact slug."
    }
  }
}

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/.

read-only

Argument	Type	Description
end	integer	Return only flips at/before this Unix timestamp.
uuid*	string	The check's UUID.
start	integer	Return only flips at/after this Unix timestamp.
seconds	integer	Return only flips from the last N seconds.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "uuid"
  ],
  "properties": {
    "end": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Return only flips at/before this Unix timestamp."
    },
    "uuid": {
      "type": "string",
      "description": "The check's UUID."
    },
    "start": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Return only flips at/after this Unix timestamp."
    },
    "seconds": {
      "type": "integer",
      "maximum": 9007199254740991,
      "minimum": -9007199254740991,
      "description": "Return only flips from the last N seconds."
    }
  }
}

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. Healthchecks: GET /channels/.

read-only

No arguments.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "properties": {}
}

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/.

read-only

Argument	Type	Description
uuid*	string	The check's UUID.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "uuid"
  ],
  "properties": {
    "uuid": {
      "type": "string",
      "description": "The check's UUID."
    }
  }
}

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).

destructive

Argument	Type	Description
uuid*	string	The check's UUID to pause.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "uuid"
  ],
  "properties": {
    "uuid": {
      "type": "string",
      "description": "The check's UUID to pause."
    }
  }
}

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).

destructive

Argument	Type	Description
uuid*	string	The check's UUID to resume.

Input schema (JSON)

{
  "type": "object",
  "$schema": "https://json-schema.org/draft/2020-12/schema",
  "required": [
    "uuid"
  ],
  "properties": {
    "uuid": {
      "type": "string",
      "description": "The check's UUID to resume."
    }
  }
}

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.

destructive

Argument	Type	Description
tz	string	Server's timezone for the cron `schedule`, e.g. "Europe/Riga".
desc	string	Free-form description of the check.
name	string	Human-readable name for the check.
slug	string	URL slug (used for slug-based ping URLs).
tags	string	Space-separated list of tags, e.g. "prod db backups".
uuid*	string	The check's UUID to update.
grace	integer	Grace time in seconds after the deadline before the check goes down.
unique	array	Dedupe fields — if a check already matches on these (e.g. ["name"]), it is returned instead of created.
methods

Healthchecks.io MCP by usefulapi

Try it

healthchecksio_create_check Destructive

Healthchecks.io MCP by usefulapi

Try it

healthchecksio_create_check Destructive

Tools (12)