UptimeRobot
Monitorea sitios, APIs, servidores y certificados SSL con UptimeRobot: gestiona monitores, incidentes y estadísticas.
Documentación
UptimeRobot para agentes de IA
Este repositorio es la fuente única de verdad de UptimeRobot para integraciones de agentes de IA. Publica:
**llms.txt**y**AGENTS.md**— descubrimiento y orientación para LLMs y agentes de codificación.**.claude-plugin/****,**.cursor-plugin/**y ****.codex-plugin/**— manifiestos de plugin instalables para Claude Code, Cursor y Codex.**skills/**— archivos de skill autocontenidos que cubren todas las herramientas MCP de UptimeRobot además de flujos de trabajo de incorporación y runbook.**rules/**— reglas compartidas cargadas tanto por Cursor como por Claude Code.**mcp.json**— configuración del servidor MCP en formato Cursor (nombre de archivo sin punto).**.mcp.json**— configuración del servidor MCP de Claude Code (con prefijo de punto para que Claude Code registre automáticamente el servidor cuando se carga el plugin).**codex.mcp.json**— configuración del servidor MCP en formato Codex (clavemcp_serversen snake_case, referenciada explícitamente por el manifiesto de Codex).**.agents/plugins/marketplace.json**— marketplace de Codex con alcance de repositorio para instalación y pruebas locales; Codex descubre automáticamente este archivo cuando el repositorio está abierto.**assets/logo.png**— logotipo del marketplace, declarado comoiconen los manifiestos de Cursor y Codex (el manifiesto de plugin de Claude Code no tiene campo de icono; el listado del directorio proporciona su icono en el momento del envío).
Los archivos mcp.json, .mcp.json y codex.mcp.json registran todos el mismo lanzador mcp-remote que actúa como proxy hacia https://mcp.uptimerobot.com/mcp y ejecuta el flujo de navegador OAuth. Los tres nombres de archivo existen solo porque Claude Code, Cursor y Codex esperan cada uno su propia convención (y Codex requiere mcp_servers en snake_case en lugar de mcpServers).
El mismo contenido se replica en uptimerobot.com/ para el descubrimiento por rastreadores (uptimerobot.com/llms.txt, uptimerobot.com/AGENTS.md, etc.).
Instalación
Claude Code
Desde el marketplace (una vez publicado)
UptimeRobot se está enviando al marketplace de plugins comunitario de Anthropic. Una vez aceptado, añade ese marketplace una vez e instala:
/plugin marketplace add anthropics/claude-plugins-community
/plugin install uptimerobot@claude-community
O ejecuta /plugin, abre la pestaña Discover, encuentra UptimeRobot e instálalo. (El marketplace comunitario debe añadirse primero — no viene integrado. Solo el marketplace oficial curado de Anthropic aparece en /plugin sin configuración.)
El servidor MCP se registra automáticamente mediante .mcp.json en cuanto se carga el plugin. La primera vez que se conecta, se abre un navegador para que inicies sesión en UptimeRobot y autorices el acceso (OAuth) — no hay ninguna clave API que pegar. Los tokens se almacenan en caché localmente, así que solo tienes que hacer esto una vez.
Clon local (instalación manual del plugin)
Para ejecutar el plugin completo (skills, reglas, comandos y el servidor MCP auto-registrado) directamente desde un checkout local — sin necesidad de marketplace — clona el repositorio y cárgalo con la bandera --plugin-dir:
git clone https://github.com/uptimerobot/ai.git
claude --plugin-dir ./ai
--plugin-dir <path> carga el plugin desde un directorio (el que contiene .claude-plugin/plugin.json) solo para esa sesión. La bandera es repetible y también acepta un .zip. Usa una ruta absoluta si lanzas Claude Code desde otro lugar:
claude --plugin-dir /absolute/path/to/ai
En la primera conexión se abre un navegador para el flujo OAuth. Ejecuta /plugin para confirmar que el plugin está cargado y uptimerobot MCP Server muestra ✓ connected.
Solo servidor MCP (mediante script)
Si solo quieres las herramientas MCP sin el resto del plugin (dotfiles, bootstrap de CI), consulta [skills/setup/SKILL.md](skills/setup/SKILL.md). Versión corta:
claude mcp add uptimerobot -- npx -y mcp-remote@latest https://mcp.uptimerobot.com/mcp
Luego sal y relanza Claude Code, completando el flujo de navegador OAuth cuando aparezca. Ejecuta /plugin para confirmar que uptimerobot MCP Server muestra ✓ connected.
Cursor
Desde el Marketplace (una vez publicado)
Explora el Cursor Marketplace, encuentra UptimeRobot y haz clic en Add to Cursor. Autoriza mediante el flujo de navegador OAuth cuando el servidor MCP se conecte por primera vez — no se necesita clave API.
Instalación local (para desarrollo y pruebas previas al envío)
Sigue la documentación de plugins de Cursor:
# Clone or symlink this repo into Cursor's local plugin folder
git clone https://github.com/uptimerobot/ai.git ~/.cursor/plugins/local/uptimerobot-ai
Lanza Cursor y ejecuta Developer: Reload Window desde la paleta de comandos.
Verifica que el plugin se detecta:
- Settings → Rules, Skills, Subagents — la regla
uptimerobot.mdcy cada entradaskills/*/SKILL.mddeberían aparecer listadas. - Settings → Tools & MCPs —
uptimerobotdebería aparecer con 32 herramientas una vez que el servidor MCP se conecte. Completa el flujo de navegador OAuth en la primera conexión.
Codex
Instalación local (para desarrollo y pruebas previas al envío)
Clona el repositorio y ábrelo en Codex. El marketplace con alcance de repositorio en .agents/plugins/marketplace.json se detecta automáticamente, así que UptimeRobot (local) aparecerá en el directorio de plugins de Codex sin configuración adicional. Instala el plugin y luego completa el flujo de navegador OAuth en la primera conexión MCP.
Si quieres que Codex rastree la fuente explícitamente:
codex plugin marketplace add ./
Verifica que el plugin está cargado: las 24 skills deberían estar disponibles y el servidor MCP uptimerobot debería aparecer con 32 herramientas una vez conectado.
Otros agentes / MCP directo
El servidor está listado en el registro oficial de MCP como com.uptimerobot/uptimerobot, por lo que cualquier cliente compatible con el registro puede descubrirlo e instalarlo sin un envío de plugin por cliente. Los metadatos viven en server.json:
curl -s "https://registry.modelcontextprotocol.io/v0.1/servers?search=com.uptimerobot/uptimerobot"
Los clientes sin soporte de registro pueden conectarse mediante el mismo lanzador mcp-remote (OAuth en el primer uso):
{
"mcpServers": {
"uptimerobot": {
"command": "npx",
"args": ["-y", "mcp-remote@latest", "https://mcp.uptimerobot.com/mcp"]
}
}
}
Headless / CI (sin navegador)
Cuando el flujo de navegador OAuth no puede ejecutarse, conéctate por HTTP simple con una clave API principal desde el panel (Integrations & API):
{
"mcpServers": {
"uptimerobot": {
"type": "http",
"url": "https://mcp.uptimerobot.com/mcp",
"headers": { "Authorization": "Bearer YOUR_API_KEY" }
}
}
}
Qué proporciona el plugin
32 herramientas vía MCP, agrupadas por recurso — lista completa y payloads en [AGENTS.md](AGENTS.md) y [skills/](skills/):
Monitores
| Herramienta | Propósito |
|---|---|
create-monitor | Crear monitores HTTP, KEYWORD, PING, PORT, HEARTBEAT, DNS, API o UDP |
update-monitor | Cambiar nombre, URL, intervalo, contactos de alerta, etiquetas, ajustes HTTP |
update-monitor-status | Pausar o reanudar un monitor |
list-monitors | Lista paginada con búsqueda + filtros de estado |
get-monitor-details | Configuración completa + estado actual de un monitor |
get-monitor-stats | Conteos agregados activo/inactivo/pausado + % de uptime |
get-response-times | Datos de tiempo de respuesta en series temporales con buckets |
Grupos de monitores (según plan: monitor-groups)
| Herramienta | Propósito |
|---|---|
create-monitor-group | Crear un grupo y asignar monitores a él |
update-monitor-group | Renombrar un grupo existente |
get-monitor-group | Obtener un solo grupo por ID |
list-monitor-groups | Lista paginada de grupos |
Páginas de estado (PSP)
| Herramienta | Propósito |
|---|---|
create-psp | Crear una página de estado pública a partir de monitores, grupos o etiquetas |
update-psp | Cambiar nombre, dominio, orden de clasificación, visibilidad o estado de publicación |
get-psp | Obtener una sola página de estado por ID |
list-psps | Lista paginada de páginas de estado |
Anuncios de PSP
| Herramienta | Propósito |
|---|---|
create-psp-announcement | Publicar un anuncio (info/mantenimiento/incidencia) en una página de estado |
update-psp-announcement | Editar título, contenido, fechas, tipo o estado de publicación |
pin-psp-announcement | Fijar un anuncio en la parte superior de la página |
unpin-psp-announcement | Desfijar un anuncio |
get-psp-announcement | Obtener un solo anuncio por ID |
list-psp-announcements | Lista paginada de anuncios para una página de estado |
Ventanas de mantenimiento (según plan: maintenance-window)
| Herramienta | Propósito |
|---|---|
create-maintenance-window | Programar una ventana única o recurrente que suprime alertas |
update-maintenance-window | Cambiar programación, duración, monitores o pausar/reanudar la ventana |
get-maintenance-window | Obtener una sola ventana por ID |
list-maintenance-windows | Lista paginada de ventanas |
Incidentes
| Herramienta | Propósito |
|---|---|
list-incidents | Incidentes en todos los monitores, con rango de tiempo + filtro de monitor |
get-incident-details | Ubicaciones de los comprobadores por incidente, registros, traceroute |
Comentarios de incidentes (según plan: incident-comments)
| Herramienta | Propósito |
|---|---|
create-incident-comment | Añadir un comentario a un incidente |
update-incident-comment | Editar un comentario existente |
list-incident-comments | Lista paginada de comentarios en un incidente |
Integraciones y etiquetas
| Herramienta | Propósito |
|---|---|
list-integrations | Integraciones de contactos de alerta disponibles |
list-tags | Lista paginada de etiquetas en la cuenta |
Sin necesidad de cuenta
La skill quick-monitor-setup crea un monitor HTTPS gratuito solo con el correo electrónico de alguien, sin cuenta, clave API ni OAuth: el agente llama a una API de prueba de trabajo no autenticada y el propietario confirma haciendo clic en un enlace de un correo de activación. Guía: https://uptimerobot.com/quick-monitor-setup/.
Requisitos del plan
Los planes de UptimeRobot son Free, Solo, Team, Enterprise. La disponibilidad de tipos de monitor, los intervalos mínimos y los límites de monitores dependen del plan activo — el servidor MCP los aplica y devuelve el código de error -28002 (subscription_limit_exceeded) cuando una llamada los excedería. Consulta [skills/errors/SKILL.md](skills/errors/SKILL.md).
Solución de problemas
Las herramientas no aparecen en Claude / Cursor
El handshake de MCP a veces se completa después de que el cliente capture su lista de herramientas al inicio de la sesión, por lo que las herramientas parecen ausentes aunque el servidor esté conectado. Solución: sal completamente del cliente (cierra la terminal, no solo /exit) y relanza. Ejecuta claude mcp list para confirmar que uptimerobot muestra ✓ Connected antes de relanzar.
Problemas de autenticación
| Síntoma | Solución |
|---|---|
| El navegador OAuth no se abrió | Copia la URL de autorización que mcp-remote imprime en la terminal y ábrela manualmente |
Las herramientas devuelven -31001 user_not_found | Borra los tokens en caché con rm -rf ~/.mcp-auth, luego sal completamente y relanza para volver a ejecutar el flujo OAuth |
Las herramientas de escritura devuelven -31002 access_denied | Vuelve a autenticarte (rm -rf ~/.mcp-auth) con una cuenta que tenga permiso de escritura |
Códigos de error de API
| Código | Significado | Qué hacer |
|---|---|---|
-28001 | Límite de monitores alcanzado | Elimina monitores no utilizados o mejora tu plan |
-28002 | Límite de suscripción | Intervalo demasiado agresivo para tu plan, o tipo de monitor no incluido: amplía el intervalo o mejora el plan |
-29001 | Parámetros no válidos | El mensaje de error indica los campos problemáticos; corrígelos y vuelve a intentarlo |
-31001 | Autenticación fallida | Consulta los problemas de autenticación más arriba |
HTTP 429 | Límite de frecuencia | Retrocede y reintenta con retraso exponencial |
Para la referencia completa de errores y recetas de recuperación, consulta skills/errors/SKILL.md.
Contribuciones
Este repositorio es generado / curado. Reporta problemas en https://github.com/uptimerobot/ai/issues. Para errores del servidor MCP, usa https://uptimerobot.com/contact.
Privacidad y Términos
Licencia
MIT. Consulta LICENSE.