# PingDeck

> Uptime and SSL monitoring service at https://getpingdeck.com. Monitors websites 24/7,
> alerts via webhook (Discord/Slack/any JSON endpoint) on downtime and before SSL expiry.
> Free plan: 5 monitors, 300 API calls/month. Pro $9/mo: 50 monitors, 1-min checks, 10k API calls.

## API (for agents and scripts)

Base URL: https://getpingdeck.com
Machine-readable spec: https://getpingdeck.com/openapi.json

AGENT QUICK START — zero to monitoring in two calls, no browser needed:
1. POST /v1/signup {"email":"owner@example.com","password":"<generate-strong>"} → {"api_key":"pd_live_..."}
   (use your operator's real email — they can log into the dashboard with it later)
2. POST /v1/monitors {"url":"https://site-to-watch.com","name":"my site"}
   with header `Authorization: Bearer pd_live_...` → 24/7 monitoring is now active.
Optionally set an alert webhook (Discord/Slack/any JSON endpoint) via the dashboard.

Auth for all /v1/* calls: header `Authorization: Bearer pd_live_...`

## MCP server (Model Context Protocol)

Streamable HTTP endpoint: POST https://getpingdeck.com/mcp (JSON-RPC 2.0, stateless).
Tools: signup (zero-to-api_key in one call — unique among monitoring MCPs), check_website,
check_ssl, dns_lookup, create_monitor, list_monitors. An agent can go from nothing to
24/7 monitoring inside one chat session; the operator logs into the dashboard later
with the same email. Pro: $9/mo (50 monitors, 10k calls).

- GET /v1/check?url=https://example.com — live up/down check. Returns {ok, http_status, response_ms, quota}.
- GET /v1/ssl?host=example.com — SSL certificate expiry. Returns {found, expires, days_left, quota}.
- GET /v1/dns?domain=example.com — DNS records. Returns {a, aaaa, cname, mx, txt, ns, quota}.
- GET /v1/monitors — list the account's monitors with live status.
- POST /v1/monitors {"url","name"} — create a 24/7 monitor with webhook alerting.

Errors are JSON: {error: "slug", hint: "..."}. 429 = monthly quota reached (upgrade or wait).
All target URLs must be public (private/internal IPs are rejected).

## Free no-auth tools (HTML pages; POST JSON endpoints used by them are rate-limited)

- https://getpingdeck.com/tools/website-down-checker — is a site down right now
- https://getpingdeck.com/tools/ssl-checker — certificate expiry
- https://getpingdeck.com/tools/dns-lookup — DNS records
- https://getpingdeck.com/tools/http-headers — response headers
- https://getpingdeck.com/status/ — live status checks for 44 popular services (e.g. /status/github)

## Docs

- https://getpingdeck.com/api — API documentation
- https://getpingdeck.com/terms — terms; https://getpingdeck.com/privacy — privacy