← Back to Skills Marketplace
captain-cole

PingHarbor

by captain-cole · GitHub ↗ · v1.0.2 · MIT-0
cross-platform ✓ Security Clean
137
Downloads
1
Stars
0
Active Installs
3
Versions
Install in OpenClaw
/install pingharbor
Description
Query uptime monitors, heartbeat monitors, manage sites, retrieve incidents, create monitors, and fetch SLA reports from your PingHarbor account.
README (SKILL.md)

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:

PINGHARBOR_API_KEY=ph_your_api_key_here

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

MCP Endpoint

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

Pass the key as a Bearer token:

Authorization: Bearer $PINGHARBOR_API_KEY

Available Tools

Tool Description
list_monitors List all monitors and their current status
get_incidents Retrieve recent incidents and downtime events
create_monitor Create a new uptime monitor programmatically
get_monitor_report Fetch SLA and response time report for a monitor
list_heartbeat_monitors List all heartbeat monitors and their health status
create_heartbeat_monitor Create a new heartbeat monitor with webhook URL
list_sites List all sites for the authenticated account
create_site Create 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)

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

Or via environment variable injection:

{
  "skills": {
    "entries": {
      "pingharbor": {
        "enabled": true,
        "env": {
          "PINGHARBOR_API_KEY": "ph_your_api_key_here"
        }
      }
    }
  }
}
Usage Guidance
This skill appears coherent and limited to PingHarbor API use. Before installing: (1) Prefer providing the API key via environment variable rather than saving it in ~/.openclaw/openclaw.json to avoid plaintext persistence. (2) Use a minimally-scoped API key (if PingHarbor supports scopes) and rotate/revoke it if compromised. (3) Be aware the skill can create monitors and heartbeat monitors that may call arbitrary webhook URLs—only create webhooks you trust. (4) Confirm the MCP endpoint (https://api.pingharbor.com) matches your PingHarbor account region/official docs. If you need stronger assurance, request the skill author or publisher identity and verify against PingHarbor's official integration guidance.
Capability Analysis
Type: OpenClaw Skill Name: pingharbor Version: 1.0.2 The PingHarbor skill bundle is a standard integration for an uptime monitoring service. It provides tools to manage monitors, heartbeat checks, and incidents via a documented MCP endpoint (api.pingharbor.com). The SKILL.md file contains legitimate usage instructions and configuration examples without any evidence of malicious intent, data exfiltration, or prompt injection.
Capability Tags
requires-oauth-token
Capability Assessment
Purpose & Capability
Name/description match the required environment variable and the documented MCP API endpoint. Requesting a single PINGHARBOR_API_KEY is appropriate for interacting with the PingHarbor API.
Instruction Scope
SKILL.md is instruction-only and confines runtime actions to calls against https://api.pingharbor.com/functions/v1/mcp using the Bearer token. It also documents writing the API key into ~/.openclaw/openclaw.json; that is expected but worth noting because it stores the key in plaintext if used.
Install Mechanism
No install spec or code files are included (instruction-only), so nothing is downloaded or written to disk by an installer step.
Credentials
Only one credential (PINGHARBOR_API_KEY) is required and it is the primary credential for the stated functionality. No unrelated secrets or config paths are requested.
Persistence & Privilege
always is false and the skill is user-invocable; it does not request elevated or persistent platform-wide privileges beyond storing its own API key in OpenClaw config if the user chooses to do so.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install pingharbor
  3. After installation, invoke the skill by name or use /pingharbor
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.2
- Updated MCP endpoint to https://api.pingharbor.com/functions/v1/mcp. - Reordered and grouped the "Available Tools" list for improved clarity.
v1.0.1
- Expanded functionality to support heartbeat monitors and site management. - Added tools: list_sites, create_site, list_heartbeat_monitors, and create_heartbeat_monitor. - Updated documentation and example usage for new heartbeat and site management capabilities. - Description now reflects monitoring of uptime, heartbeat checks, and site grouping.
v1.0.0
pingharbor 1.0.0 - Initial release. - Connects to your PingHarbor account to monitor website uptime, query incidents, create monitors, and retrieve SLA reports. - Requires a PingHarbor API key for authentication via environment variable. - Supports listing monitors, retrieving incidents, creating monitors, and fetching monitor reports.
Metadata
Slug pingharbor
Version 1.0.2
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 3
Frequently Asked Questions

What is PingHarbor?

Query uptime monitors, heartbeat monitors, manage sites, retrieve incidents, create monitors, and fetch SLA reports from your PingHarbor account. It is an AI Agent Skill for Claude Code / OpenClaw, with 137 downloads so far.

How do I install PingHarbor?

Run "/install pingharbor" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is PingHarbor free?

Yes, PingHarbor is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does PingHarbor support?

PingHarbor is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created PingHarbor?

It is built and maintained by captain-cole (@captain-cole); the current version is v1.0.2.

💬 Comments