CoreDash Uptime API en MCP-tools: monitors en checks

Uptime-monitors via de CoreDash API

Lees en wijzig de uptime-monitors van je CoreDash-projecten via REST, met de API-key die je al gebruikt voor je RUM-data. Een AI-agent leest ze via MCP.

curl https://app.coredash.app/api/uptime/monitors \
  -H "Authorization: Bearer cdk_your_key"

API-keys voor uptime-monitors

De uptime-endpoints accepteren de keys van de CoreDash API en de Agency API.

Maak een project-key aan op de Connect Your AI-pagina in de sidebar van je project: geef hem een naam en klik op Generate API key. Dezelfde keys vind je in je projectinstellingen onder API Keys (MCP). Alleen projecteigenaren kunnen ze aanmaken. Een master-key vind je op de Agency API-pagina in de sidebar, bij agency-accounts. Is een project verlopen, dan krijgt de project-key een 401 op elke call.

Een gast op een project kan de monitors inzien. Voor toevoegen, wijzigen, verplaatsen en verwijderen moet je eigenaar van het project zijn.

Het OAuth-token van een AI-koppeling zoals Claude (mcp_at_) kan alleen lezen. Een POST, PATCH of DELETE hiermee krijgt een 403.

Uptime-endpoints

Het origin-IP en de header-waarden zijn geheim. Ze komen terug bij POST, PATCH en GET /api/uptime/monitors/:id. De lijst en de MCP-tools laten origin_ip weg en tonen elke header-waarde als ••••.

Het monitor-object

De velden summary en rum

Zowel de lijst als de individuele monitor bevat een summary: rounds_7d en down_rounds_7d tellen de rondes van de afgelopen 7 dagen, uptime_7d is het percentage van die rondes zonder down-check, en recent bevat de laatste 48 rondes (oudste eerst), elk met de slechtste uitkomst van die ronde. Heeft een monitor geen checks gehad in de afgelopen 7 dagen, dan is summary: null.

De individuele monitor bevat ook rum: de TTFB op p75 die je echte bezoekers in de afgelopen 7 dagen kregen, uit de RUM-data van het project, om te vergelijken met de ttfb_ms van de checker. Dit veld is null zolang het project geen RUM-data heeft.

GET /api/uptime/monitors/:id

curl "https://app.coredash.app/api/uptime/monitors/6ad68c7a844fad80b752fd16?limit=2" \
  -H "Authorization: Bearer cdk_your_key"

{
  "monitor": {
    "id": "6ad68c7a844fad80b752fd16",
    "name": "Checkout",
    "url": "https://www.example.com/checkout/",
    "project_id": "655f1f77bcf86cd799439011",
    "paused": false,
    "expect_status": 200,
    "origin_check": true,
    "origin_ip": "203.0.113.10",
    "headers": [{ "name": "X-Staging-Auth", "value": "k7Qp2vX9mR4tL8wZ" }],
    "state": "up",
    "last_check_at": "2026-10-20T08:00:09.000Z",
    "last_up_at": "2026-10-20T08:00:09.000Z",
    "down_since": null,
    "last_down": { "from": "2026-10-18T19:00:11.000Z", "to": "2026-10-18T20:00:10.000Z" },
    "check_requested_at": null,
    "last": {
      "edge": { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "edge", "outcome": "up", "status": 200, "ttfb_ms": 212, "total_ms": 388, "connect_ms": 14, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": true, "cache_status": "DYNAMIC" },
      "origin": { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "origin", "outcome": "up", "status": 200, "ttfb_ms": 640, "total_ms": 702, "connect_ms": 9, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": false, "cache_status": null },
      "origin_is_cdn": false
    },
    "cert_expires": "2027-01-02T23:59:59.000Z",
    "created_at": "2026-10-06T09:12:41.000Z"
  },
  "summary": {
    "rounds_7d": 336,
    "down_rounds_7d": 2,
    "uptime_7d": 99.4,
    "recent": [
      { "at": "2026-10-20T07:30:10.000Z", "outcome": "up" },
      { "at": "2026-10-20T08:00:09.000Z", "outcome": "up" }
    ]
  },
  "checks": [
    { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "edge", "outcome": "up", "status": 200, "ttfb_ms": 212, "total_ms": 388, "connect_ms": 14, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": true, "cache_status": "DYNAMIC" },
    { "at": "2026-10-20T08:00:09.000Z", "server": "scan1", "mode": "origin", "outcome": "up", "status": 200, "ttfb_ms": 640, "total_ms": 702, "connect_ms": 9, "redirects": 0, "final_url": "https://www.example.com/checkout/", "error": null, "error_text": null, "cloudflare": false, "cache_status": null }
  ],
  "rum": { "ttfb_p75": 1920, "rating": "poor", "period": "last 7 days" }
}

In de echte response bevat recent 48 rondes; dit voorbeeld toont de laatste twee.

Het check-object en de uitkomsten

Elke 30 minuten checkt één ronde alle monitors, afwisselend vanaf twee servers: scan1 om :00, scan2 om :30. Een ronde checkt de URL altijd zoals bezoekers die bereiken: via DNS en je CDN (edge). Met een origin-IP checkt hij ook direct je server (origin). De API heeft geen call om een monitor tussen rondes door te checken. Checks worden 30 dagen bewaard.

Elke check stuurt de user-agent CoreDash/1.0 (uptime; +https://www.coredash.app/bot) mee. Staat de URL van de monitor op de eigen site van je project (de host, met of zonder www, of een subdomein), dan stuurt de check ook de header X-CoreDash-Bot mee met de geheime waarde van je project, uit het tabblad CoreDash bot token in je projectinstellingen. Een monitor op een andere site krijgt geen token mee. Bij een redirect volgt het token de regel voor de headers die je instelt: het gaat alleen mee zolang de redirect op de host van de monitor blijft. Een eigen header met de naam X-CoreDash-Bot wordt genegeerd. Op de CoreDash bot-pagina lees je meer over beide.

Hoe de uitkomst van een check wordt bepaald

De slechtste uitkomst van de checks in een ronde bepaalt de state van de monitor, van slecht naar goed: down, blocked, warn, up.

Monitor-states

Een monitor in een project waarvan het abonnement is afgelopen, behoudt zijn instellingen en laatste state. Hij wordt niet gecheckt totdat er weer voor het project is betaald.

Een monitor toevoegen, wijzigen en verwijderen

POST /api/uptime/monitors

curl -X POST https://app.coredash.app/api/uptime/monitors \
  -H "Authorization: Bearer cdk_master_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "url": "https://www.example.com/checkout/",
    "name": "Checkout",
    "project_id": "655f1f77bcf86cd799439011",
    "origin_ip": "203.0.113.10",
    "headers": [{ "name": "X-Staging-Auth", "value": "k7Qp2vX9mR4tL8wZ" }],
    "expect_status": 200
  }'

Het antwoord is 201 met de nieuwe monitor, inclusief origin-IP en header-waarden:

{
  "monitor": {
    "id": "6ad68c7a844fad80b752fd16",
    "name": "Checkout",
    "url": "https://www.example.com/checkout/",
    "project_id": "655f1f77bcf86cd799439011",
    "paused": false,
    "expect_status": 200,
    "origin_check": true,
    "origin_ip": "203.0.113.10",
    "headers": [{ "name": "X-Staging-Auth", "value": "k7Qp2vX9mR4tL8wZ" }],
    "state": "pending",
    "last_check_at": null,
    "last_up_at": null,
    "down_since": null,
    "last_down": null,
    "check_requested_at": "2026-10-20T09:12:41.000Z",
    "last": {},
    "cert_expires": null,
    "created_at": "2026-10-20T09:12:41.000Z"
  }
}

PATCH /api/uptime/monitors/:id

Stuur alleen de velden mee die je wijzigt. headers vervangt de hele lijst, dus stuur elke header mee die je wilt behouden. Hiermee pauzeer je een monitor:

curl -X PATCH https://app.coredash.app/api/uptime/monitors/6ad68c7a844fad80b752fd16 \
  -H "Authorization: Bearer cdk_your_key" \
  -H "Content-Type: application/json" \
  -d '{ "paused": true }'

Bij een master-key verplaatst project_id de monitor, volgens dezelfde regels als bij POST.

DELETE /api/uptime/monitors/:id

curl -X DELETE https://app.coredash.app/api/uptime/monitors/6ad68c7a844fad80b752fd16 \
  -H "Authorization: Bearer cdk_your_key"

Dit kun je niet ongedaan maken. Wil je de checks stoppen maar de historie bewaren, stuur dan { "paused": true } mee via PATCH.

Errors en limieten van de Uptime API

Errors komen terug als { "error": "..." } met een van deze statussen:

Limieten: 25 monitors per project, 5 extra headers per monitor, 2100 checks per GET van één monitor, en een check-historie van 30 dagen.

Uptime MCP-tools

De CoreDash MCP-server op https://app.coredash.app/api/mcp heeft naast de RUM-tools twee uptime-tools, plus list_projects voor de projecten waar je key bij kan. Alle drie kunnen ze alleen lezen. Wil je een monitor toevoegen, wijzigen of verwijderen, gebruik dan de app of de bovenstaande REST-endpoints met een CoreDash API-key. De tools hebben geen project_id nodig: een project-key leest het eigen project, een master-key of een OAuth-koppeling zoals Claude leest elk project waarvan je eigenaar bent of waarvoor je bent uitgenodigd.

curl -X POST https://app.coredash.app/api/mcp \
  -H "Authorization: Bearer cdk_your_key" \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/call",
    "params": {
      "name": "get_uptime_monitor",
      "arguments": { "monitor_id": "6ad68c7a844fad80b752fd16", "limit": 48 }
    }
  }'

Het antwoord is de JSON-RPC-wrapper van de CoreDash API, met het resultaat als JSON-string in result.content[0].text. Een onbekende monitor levert daar { "error": "Monitor not found" } op, en result.isError is true.

Meer over uptime en de CoreDash API

• Uptime-monitoring: wat CoreDash checkt en wat je ziet in de app.
• CoreDash API: project-keys, het JSON-RPC-formaat en de RUM-tools.
• Agency API: master-keys en projecten via REST.
• CoreDash bot: de user-agent, de header X-CoreDash-Bot en de IP-adressen.
• Laat CoreDash door je firewall: voor een monitor die op Blocked staat.