PingHarbor — Uptime & Heartbeat Monitoring#

Connect to your PingHarbor account to monitor website uptime, track cron jobs via heartbeat monitors, manage sites, query incidents, and pull SLA reports — all via the PingHarbor MCP server.

Authentication#

Set your PingHarbor API key as an environment variable:

text

PINGHARBOR_API_KEY=ph_your_api_key_here

Generate a key at: Administration → API Keys inside your PingHarbor dashboard.

MCP Endpoint#

text

https://api.pingharbor.com/functions/v1/mcp

Pass the key as a Bearer token:

text

Authorization: Bearer $PINGHARBOR_API_KEY

Available Tools#

ToolDescriptionlist_monitorsList all monitors and their current statusget_incidentsRetrieve recent incidents and downtime eventscreate_monitorCreate a new uptime monitor programmaticallyget_monitor_reportFetch SLA and response time report for a monitorlist_heartbeat_monitorsList all heartbeat monitors and their health statuscreate_heartbeat_monitorCreate a new heartbeat monitor with webhook URLlist_sitesList all sites for the authenticated accountcreate_siteCreate a new site to group monitors together

Example Usage#

"List all my monitors and show me which ones are currently down."

"Get incidents from the last 7 days for monitor ID xyz."

"Create a monitor for https://example.com with a 60-second check interval."

"Show me the SLA report for my main API monitor."

"List my heartbeat monitors and show which ones have missed a heartbeat."

"Create a heartbeat monitor for my nightly database backup that runs every 24 hours with a 60-minute grace period."

"List all my sites."

"Create a new site called 'Production' for https://myapp.com."

Config (~/.openclaw/openclaw.json)#

json

{
  "skills": {
    "entries": {
      "pingharbor": {
        "enabled": true,
        "apiKey": "ph_your_api_key_here"
      }
    }
  }
}

Or via environment variable injection:

json

{
  "skills": {
    "entries": {
      "pingharbor": {
        "enabled": true,
        "env": {
          "PINGHARBOR_API_KEY": "ph_your_api_key_here"
        }
      }
    }
  }
}