Relvato

npx add-mcp 'https://app.relvato.com/api/mcp'

Inicio rápido

Cada solicitud se autentica con una clave de API que creas en la aplicación. Apunta curl, tu CI o cualquier cliente HTTP a https://app.relvato.com/api/v1.

# 1 — Confirm your key works and see the endpoints
curl https://app.relvato.com/api/v1 \
  -H "Authorization: Bearer rlv_your_key"

# 2 — List the sites Relvato monitors for you
curl https://app.relvato.com/api/v1/sites \
  -H "Authorization: Bearer rlv_your_key"

# 3 — Read recent runs (optionally scoped to one site)
curl "https://app.relvato.com/api/v1/runs?limit=10" \
  -H "Authorization: Bearer rlv_your_key"

# 4 — One run in detail, then the fix brief Relvato's AI would answer
curl https://app.relvato.com/api/v1/runs/RUN_ID \
  -H "Authorization: Bearer rlv_your_key"
curl https://app.relvato.com/api/v1/runs/RUN_ID/fix-prompt \
  -H "Authorization: Bearer rlv_your_key"

# 5 — Trigger an on-demand scan of a site (full-access key)
curl -X POST https://app.relvato.com/api/v1/sites/SITE_ID/scan \
  -H "Authorization: Bearer rlv_your_key"

Autenticación

Envía tu clave en cada solicitud como Authorization: Bearer rlv_your_key (un encabezado x-api-key también funciona). Una clave faltante, revocada o desconocida devuelve 401.

Crea y revoca claves en Acceso a la API en la aplicación. Las claves comienzan con rlv_ y se muestran una sola vez al crearlas. Cada clave es read-only (sitios, ejecuciones, el resumen del sitio, informes de corrección y configuraciones de alertas) o full access (también agrega sitios y verificaciones, cambia horarios y ejecuta escaneos). Las claves creadas antes de que existieran los alcances tienen acceso completo. Trata las claves como una contraseña.

Endpoints REST

Cada endpoint está limitado a la cuenta detrás de la clave y devuelve JSON. URL base https://app.relvato.com/api/v1.

Método	Endpoint	Descripción
GET	/api/v1	Confirma la clave y lista los endpoints disponibles.
GET	/api/v1/sites	Lista los sitios web que Relvato monitorea por ti.
GET	/api/v1/sites/:id/overview	El veredicto de salud de un sitio: qué necesita atención, la última ejecución de cada verificación y el uso del plan.
GET	/api/v1/runs	Ejecuciones de verificación recientes, de más reciente a más antigua: parámetros de consulta opcionales siteId y limit (1–100).
GET	/api/v1/runs/:id	Una ejecución en detalle: pasos, advertencias, hallazgos y métricas (compactados cuando son grandes).
GET	/api/v1/runs/:id/fix-prompt	Para una ejecución que encontró un problema: el informe que responde la propia IA de Relvato: pila tecnológica, qué cambió, el error y la evidencia.
GET	/api/v1/alert-settings	Quién recibe qué información: frecuencia, gravedad, canales y enrutamiento. Nunca URLs ni secretos.
POST	/api/v1/sites/:id/scan	Pone en cola un escaneo bajo demanda de un sitio y devuelve los IDs de ejecución. Necesita una clave de acceso completo; cuenta contra tu cuota mensual de ejecuciones.

Ejemplo: listar sitios

{
  "sites": [
    {
      "id": "st_1a2b3c",
      "name": "style4street",
      "url": "https://style4street.com",
      "connectionType": "wordpress"
    }
  ]
}

Ejemplo: ejecuciones recientes

Una ejecución que falló pero luego se resolvió (línea base aceptada o ignorada) reporta status: "passed" con resolved: true.

{
  "runs": [
    {
      "id": "rn_9f8e7d",
      "siteId": "st_1a2b3c",
      "checkId": "ck_4d5e6f",
      "journey": "checkout",
      "checkName": "Checkout",
      "status": "passed",
      "resolved": false,
      "trigger": "schedule",
      "startedAt": "2026-08-31T09:15:00.000Z",
      "durationMs": 4210,
      "error": null,
      "warning": null
    }
  ]
}

Ejemplo: una ejecución en detalle

Los hallazgos vienen en metrics.items. Una ejecución grande se compacta en lugar de cortarse: las series largas se convierten en resúmenes, y lo que se omitió se lista en metricsTrimmed: el titular y los hallazgos siempre se conservan.

{
  "runId": "rn_9f8e7d",
  "runUrl": "https://app.relvato.com/runs/rn_9f8e7d",
  "check": { "key": "google-search", "name": "Google Search" },
  "status": "passed",
  "warning": "https://style4street.com/category/topuri/hanorace/ lost 57% of its Google impressions",
  "metrics": {
    "headline": { "tone": "warn", "text": "🔎 1 thing to review on Google Search (as of 2026-09-24)" },
    "items": [
      { "text": "https://style4street.com/category/topuri/hanorace/ lost 57% of its Google impressions — 98 in the 7 days to 2026-09-24, against 226 in an average week before", "tone": "warn" }
    ],
    "search": { "engine": "google", "tiles": [ … ], "dailies": [ { "label": "Impressions per day", "days": 84, "last7Total": 2196, "usualLast7Total": 2583 } ], … }
  },
  "metricsTrimmed": {
    "note": "Large parts were left out to keep this short — the run page has everything.",
    "omitted": ["search.dailies (the per-day values — summarized)", "search.tiles[].weekly (the 8 weekly bars)"]
  }
}

Ejemplo: informe de corrección de una ejecución

Para una ejecución que encontró un problema, fix-prompt devuelve el informe que responde la propia IA de Relvato: la pila tecnológica del sitio, qué cambió justo antes, el error y los hallazgos, y para Google / Bing Search la evidencia que descarta causas. Entrégalo a tu propio modelo o léelo tú mismo.

{
  "runId": "rn_9f8e7d",
  "runUrl": "https://app.relvato.com/runs/rn_9f8e7d",
  "hasIssue": true,
  "prompt": "# Help me understand a Google Search change on my WordPress site\n\nYou are a senior SEO specialist. … ## Evidence Relvato already has …"
}

Límites de velocidad

Las solicitudes se limitan por minuto, por cuenta, combinando REST y MCP. Tu plan establece el límite:

Plan	Solicitudes / min
Gratis	30
Pro	120
Business	600
Agencia	2,400

Cada respuesta incluye X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset. Superar el límite devuelve 429 con un encabezado Retry-After.

Códigos de estado

Estado	Significado
200	Éxito.
400	La solicitud falta algo o no se puede realizar: el mensaje indica qué.
401	Clave de API faltante, desconocida o revocada.
403	La clave es de solo lectura y la solicitud cambiaría algo o ejecutaría un escaneo.
404	Sitio o ejecución no encontrado para esta cuenta.
409	El sitio está deshabilitado, o aún no has demostrado que lo posees (dominio no verificado, o el plugin de WordPress nunca se conectó).
429	Se alcanzó el límite de velocidad, o la cuota mensual de ejecuciones está agotada.

Servidor MCP (para agentes de IA)

Relvato también es un servidor Model Context Protocol remoto, por lo que un agente como Claude puede configurar monitoreo en una conversación: agregar un sitio, guiarte para conectarlo, elegir sus verificaciones, ejecutarlas y explicar los resultados. Usa la misma clave y el mismo límite de velocidad que la API REST. Aceptar líneas base, ignorar advertencias y correcciones permanecen en el panel, contigo mirando. Una clave de solo lectura solo obtiene las herramientas de lectura.

Cosas que puedes pedirle a un agente conectado a Relvato:

• "¿Por qué falló el pago en mi tienda anoche y cómo lo arreglo?"
• "Configura monitoreo para example.com y dime qué necesito hacer para conectarlo."
• "¿Quién recibe alertas cuando falla una verificación de Seguridad y en qué canales?"

Endpoint https://app.relvato.com/api/mcp

Herramienta	Qué hace
list_sites	Lista los sitios web de la cuenta y si cada uno está listo para ejecutar verificaciones.
add_site	Agrega un sitio web y obtén su paso de configuración: conectar el plugin de WordPress o verificar el dominio.
verify_site	Verifica ese paso de configuración: la conexión del plugin, o el registro DNS o la metaetiqueta de verificación del dominio.
site_overview	Veredicto de salud en lenguaje sencillo: qué necesita atención, cada verificación con su última ejecución y horario, y uso del plan.
list_checks	Las verificaciones que puedes agregar a un sitio: qué detecta cada una, si tu plan la incluye y cuáles se recomiendan.
add_checks	Agrega verificaciones a un sitio; cada una informa agregada, ya existente o por qué no.
update_check	Activa o desactiva una verificación, o cambia su horario.
trigger_scan	Ejecuta las verificaciones de un sitio ahora, o una sola verificación, y devuelve los IDs de ejecución (usa la cuota mensual).
list_runs	Lista ejecuciones recientes, de más reciente a más antigua: opcionalmente para un solo sitio.
get_run	Una ejecución en detalle: estado, error, advertencias, pasos, comparaciones visuales y el enlace al panel.
get_fix_prompt	Para una ejecución que encontró un problema: el mismo informe que responde la propia IA de Relvato, para razonar sobre la causa probable y las correcciones.
get_alert_settings	Quién recibe qué información: frecuencia, gravedad, estado de cada canal y enrutamiento: sin URLs ni secretos.

Agrégalo como un conector HTTP remoto. En un cliente que lee un mcp.json, la entrada se ve así:

{
  "mcpServers": {
    "relvato": {
      "type": "http",
      "url": "https://app.relvato.com/api/mcp",
      "headers": {
        "Authorization": "Bearer rlv_your_key"
      }
    }
  }
}

Webhooks

La API responde cuando preguntas. Para que te avisen en el momento en que falla una verificación, agrega un webhook: Relvato envía un evento JSON firmado a tu URL para cada alerta (Pro y superiores). Configurar un webhook →

Preguntas frecuentes

¿Qué planes incluyen acceso a API y MCP?

Todos, incluido Gratis: solo difiere el límite de velocidad por minuto. Gratis permite 30 solicitudes por minuto; los planes de pago permiten más.

¿Cómo obtengo una clave?

Inicia sesión y abre Acceso a la API en la aplicación. Elige solo lectura o acceso completo para cada clave; puedes crear varias y revocar cualquiera en cualquier momento.

¿Qué puede hacer una clave de solo lectura?

Todo lo que solo lee: sitios, ejecuciones, el resumen de salud del sitio, informes de corrección, configuraciones de alertas y el catálogo de verificaciones, tanto por REST como por MCP. Un cliente MCP conectado con una clave de solo lectura solo ve las herramientas de lectura. Agregar sitios o verificaciones, cambiar horarios y ejecutar escaneos devuelve 403 y necesita una clave de acceso completo.

¿Ejecutar un escaneo usa mi cuota?

Sí. Los escaneos bajo demanda, por REST o MCP, usan la misma cuota mensual de ejecuciones que las verificaciones programadas.

¿Puede un agente agregar sitios y cambiar verificaciones?

Sí, dentro de los límites de tu plan, igual que en el panel. No puede omitir la propiedad: un sitio nuevo solo se ejecuta una vez que su plugin de WordPress está conectado o su dominio está verificado. Aceptar nuevas líneas base, ignorar advertencias y aplicar correcciones no están disponibles por MCP.