CoreDash-Uptime-API und MCP-Tools: Monitore und Checks
Uptime-Monitore mit deinem CoreDash-API-Key auflisten, hinzufügen, ändern und löschen, ihre Checks auslesen oder das einen KI-Agenten über MCP erledigen lassen.
Arjen Karel - linkedin
Last update: 2026-10-19
Trusted by market leaders · Client results
Authentifizierung
Die Uptime-Endpunkte akzeptieren dieselben Bearer-Token wie der Rest der CoreDash-API:
- Projekt-API-Key (
cdk_...): sieht die Monitore, die mit diesem RUM-Projekt verknüpft sind. Erstellst du damit einen Monitor, ist er mit diesem Projekt verknüpft. - Master-Key (
cdk_master_..., Agency-API): alle Monitore im Account plus die Monitore von Projekten, die der Account öffnen kann. - MCP-OAuth-Token: derselbe Scope wie ein Projekt-Key.
Endpunkte
| Methode und Pfad | Funktion |
|---|---|
GET /api/uptime/monitors | Alle Monitore mit Status, letztem Check, Uptime über 7 Tage und dem Ergebnis der letzten 48 Checks. |
POST /api/uptime/monitors | Erstellt einen Monitor. Gibt 201 und den Monitor zurück. Der erste Check läuft innerhalb einer Minute. |
GET /api/uptime/monitors/:id | Ein Monitor mit den letzten Checks, neueste zuerst. ?limit= bis zu 2100 (7 Tage mit Origin-Check). |
PATCH /api/uptime/monitors/:id | Ändert die Felder, die du sendest. paused: true stoppt die Checks. |
DELETE /api/uptime/monitors/:id | Löscht den Monitor und seinen Check-Verlauf. |
POST /api/uptime/monitors/:id/check | Fordert sofort einen Check an. Gibt 202 zurück; das Ergebnis liegt nach etwa einer Minute vor. |
Monitor hinzufügen
| Feld | Bedeutung |
|---|---|
url | Erforderlich. Eine vollständige HTTP- oder HTTPS-URL. |
name | Anzeigename. Standard: der Host der URL. |
project_id | Nur mit Master-Key: verknüpft den Monitor für den TTFB-Vergleich mit einem RUM-Projekt. |
origin_ip | Öffentliche IP deines Servers. Aktiviert den Origin-Check, der DNS und CDN umgeht. Ein leerer String entfernt ihn. |
headers | Bis zu 5 Request-Header, [{ "name", "value" }], für eine Firewall-Regel, die den Checker durchlässt. |
expect_status | Der Status, der als up gilt. Standard: 200. |
paused | Nur für PATCH. true stoppt die Checks, false startet sie wieder. |
So sieht ein Monitor aus
state ist einer dieser Werte:
up: der letzte Check war erfolgreich.failing: der letzte Check schlug fehl, der davor war erfolgreich.down: zwei fehlgeschlagene Checks in Folge, beide Server sahen den Ausfall.blocked: ein 403, ein 429 oder eine Cloudflare-Challenge. Siehe Checker durchlassen.warn: jeder andere Status als der, der als up gilt.pendingoderpaused.
Ein fehlgeschlagener Check liefert einen error: dns, connect, connect_timeout, timeout (30 Sekunden), tls, redirects oder network. Origin-IP und Header-Werte liefert nur GET /api/uptime/monitors/:id zurück. Listen und MCP-Antworten maskieren sie.
MCP-Tools
Der CoreDash-MCP-Server hat neben den RUM-Tools sechs Uptime-Tools. Mit einem Master-Key brauchen sie keine project_id.
| Tool | Einsatzzweck |
|---|---|
list_uptime_monitors | „Ist alles up?“ |
get_uptime_monitor | „War der Checkout diese Woche down und seit wann?“ Gibt die letzten Checks und deren Uptime zurück. |
create_uptime_monitor | „Überwache auch unsere Login-Seite.“ |
update_uptime_monitor | URL, Origin-IP oder Header ändern oder einen Monitor pausieren. |
delete_uptime_monitor | Einen Monitor und seinen Verlauf löschen. |
check_uptime_now | „Prüfe es jetzt noch mal.“ |
