API de uptime y herramientas MCP de CoreDash: monitores y comprobaciones
Lista, añade, modifica y elimina monitores de uptime con tu API key de CoreDash, consulta sus comprobaciones o deja que un agente de IA lo haga a través de MCP.
Arjen Karel - linkedin
Last update: 2026-10-19
Trusted by market leaders · Client results
Autenticación
Los endpoints de uptime admiten los mismos tokens Bearer que el resto de la API de CoreDash:
- API key de proyecto (
cdk_...): ve los monitores vinculados a ese proyecto de RUM. Los monitores que creas con ella quedan vinculados a ese proyecto. - Master key (
cdk_master_..., API de Agency): todos los monitores de la cuenta, más los vinculados a proyectos que la cuenta puede abrir. - Token OAuth de MCP: el mismo alcance que una API key de proyecto.
Endpoints
| Método y ruta | Qué hace |
|---|---|
GET /api/uptime/monitors | Todos los monitores con su estado, última comprobación, uptime de los últimos 7 días y el resultado de las últimas 48 comprobaciones. |
POST /api/uptime/monitors | Añade un monitor. Devuelve 201 y el monitor. La primera comprobación se ejecuta en menos de un minuto. |
GET /api/uptime/monitors/:id | Un monitor con sus comprobaciones recientes, las más recientes primero. ?limit= de hasta 2100 (7 días con comprobación de origen). |
PATCH /api/uptime/monitors/:id | Modifica los campos que envías. paused: true detiene las comprobaciones. |
DELETE /api/uptime/monitors/:id | Elimina el monitor y su historial de comprobaciones. |
POST /api/uptime/monitors/:id/check | Solicita una comprobación inmediata. Devuelve 202; el resultado llega en aproximadamente un minuto. |
Añadir un monitor
| Campo | Significado |
|---|---|
url | Obligatorio. Una URL completa con http o https. |
name | Nombre visible. Por defecto: el host de la URL. |
project_id | Solo con master key: vincula el monitor a un proyecto de RUM para comparar el TTFB. |
origin_ip | IP pública del servidor. Añade la comprobación de origen, que esquiva el DNS y la CDN. Una cadena vacía la elimina. |
headers | Hasta 5 cabeceras de petición, [{ "name", "value" }], para una regla de firewall que permita el paso del comprobador. |
expect_status | El código de estado que cuenta como up. Por defecto, 200. |
paused | Solo para PATCH. true detiene las comprobaciones; false las reanuda. |
Estructura de un monitor
state puede ser:
up: la última comprobación fue correcta.failing: la última comprobación falló, pero la anterior fue correcta.down: dos comprobaciones fallidas seguidas; ambos servidores detectaron el fallo.blocked: un 403, un 429 o un challenge de Cloudflare. Consulta cómo permitir el paso del comprobador.warn: cualquier estado distinto al que cuenta como up.pendingopaused.
Una comprobación fallida incluye un error: dns, connect, connect_timeout, timeout (30 segundos), tls, redirects o network. La IP de origen y los valores de las cabeceras solo se devuelven en GET /api/uptime/monitors/:id. Los listados y las respuestas de MCP los enmascaran.
Herramientas MCP
El servidor MCP de CoreDash incluye seis herramientas de uptime junto a las herramientas de RUM. Con una master key no necesitan project_id.
| Herramienta | Para qué sirve |
|---|---|
list_uptime_monitors | "¿Está todo levantado?" |
get_uptime_monitor | "¿Estuvo caído el checkout esta semana y desde cuándo?" Devuelve las comprobaciones recientes y el uptime correspondiente. |
create_uptime_monitor | "Monitoriza también la página de login." |
update_uptime_monitor | Cambia la URL, la IP de origen o las cabeceras, o pausa un monitor. |
delete_uptime_monitor | Elimina un monitor y su historial. |
check_uptime_now | "Vuelve a comprobarlo ahora." |
