Una clave para la API REST y el servidor MCP

Inicio rápido

Cada solicitud se autentica con una clave de API que creas en la app. 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 (también funciona una cabecera x-api-key). Una clave ausente, revocada o desconocida devuelve 401.

Crea y revoca claves en API access dentro de la app. Las claves empiezan por rlv_ y se muestran una sola vez al crearlas. Cada clave es read-only (todo lo que lee: sitios, salud, rendimiento, ejecuciones, monitores, actualizaciones, actividad, informes de corrección, ajustes de alertas) o full access (además añade y configura sitios y monitores, los ejecuta, revisa resultados y aplica las correcciones propuestas). Las claves creadas antes de que existieran los alcances tienen acceso completo. Trátalas como una contraseña.

Endpoints REST

Cada endpoint se limita a la cuenta de la clave y devuelve JSON. URL base https://app.relvato.com/api/v1.

Ejemplo: listar sitios

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

Ejemplo: ejecuciones recientes

Una ejecución que falló pero se resolvió después (línea base aceptada o ignorada) informa 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 llegan en metrics.items. Una ejecución grande se compacta en lugar de cortarse: las series largas pasan a ser resúmenes y lo que se omitió aparece 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: el 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: el stack del sitio, qué cambió justo antes, el error y los hallazgos y, para Google / Bing Search, la evidencia que descarta causas. Pásalo a tu propio modelo o léelo tú.

{
  "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 tasa

Las solicitudes se limitan por minuto y por cuenta, sumando REST y MCP. Tu plan fija el máximo:

Cada respuesta incluye X-RateLimit-Limit, X-RateLimit-Remaining y X-RateLimit-Reset. Al superar el límite se devuelve 429 con una cabecera Retry-After.

Códigos de estado

Servidor MCP (para agentes de IA)

Relvato también es un servidor remoto Model Context Protocol con 57 herramientas, así un agente como Claude puede hacer en una conversación lo que harías en el panel: añadir un sitio y guiarte para conectarlo, elegir y configurar sus monitores (hasta las páginas que revisa el monitor visual), ejecutarlos, explicar los resultados y, si estás de acuerdo, aceptar un cambio intencionado o darte el enlace para aplicar en WordPress la corrección que propone una ejecución. Se conecta iniciando sesión en Relvato o con una clave de API; en ambos casos comparte el límite de la API REST. Aprobar cambios de integridad de archivos, scripts y DNS, quién recibe las alertas, los secretos y borrar se quedan en el panel.

Incluido en el GitHub MCP Registry ↗.

Inicia sesión, sin clave. Añade el endpoint como conector en Claude (claude.ai, Desktop o Claude Code), ChatGPT o VS Code. El cliente abre el inicio de sesión de Relvato; le permites leer tus sitios y resultados y hacer cambios: añadir sitios y monitores, cambiar horarios y lanzar escaneos. El inicio de sesión funciona en clientes compatibles con Client ID Metadata Documents; Cursor y el gateway MCP de Docker aún no lo son, así que usan una clave de API.

Si perteneces a una organización, eliges uno de sus espacios de trabajo en la pantalla de inicio de sesión; tu espacio personal no aparece ahí. Para conectar tu espacio personal, usa una clave de API.

Cosas que puedes pedir a un agente conectado a Relvato:

• «¿Por qué falló anoche el checkout de mi tienda y cómo lo arreglo?»
• «Configura la monitorización de example.com y dime qué tengo que hacer para conectarlo».
• «¿Quién recibe una alerta cuando un monitor de Security encuentra un problema, y por qué canales?»
• «Añade mis páginas de precios y del blog al monitor visual y ejecútalo».
• «¿Qué tan rápida es mi tienda para visitantes reales y qué la ralentiza?»

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

En un cliente que lee un mcp.json, basta con el endpoint: el cliente te pide iniciar sesión la primera vez:

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

Para usar una clave de API en su lugar (un script, un cliente sin inicio de sesión o tu espacio personal si estás en una organización), añade la cabecera. Una clave de solo lectura solo recibe las herramientas de lectura:

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

Plugin para Claude Code

En Claude Code, el plugin de Relvato añade el servidor y tres skills para trabajar desde el repositorio de tu sitio. Instálalo desde nuestro marketplace, luego ejecuta /mcp e inicia sesión:

claude plugin marketplace add Relvato/relvato-mcp
claude plugin install relvato@relvato

• /relvato:setup añade el sitio que despliega este repositorio, demuestra que es tuyo (puede añadir la metaetiqueta de verificación a tu código), elige monitores y lanza las primeras ejecuciones.
• /relvato:check-after-deploy ejecuta los monitores del sitio tras un despliegue, dice cuánto tardarán e informa de lo que pasó y lo que falló.
• /relvato:fix-failure lee una ejecución fallida, encuentra la causa en tu código, aplica la corrección más pequeña con tu visto bueno y vuelve a ejecutar ese monitor.

Perplexity

Con un plan Pro, Max o Enterprise de Perplexity, añade Relvato como conector personalizado: Settings → Connectors → + Custom connector → Remote. Usa el endpoint de arriba como URL del servidor MCP y Streamable HTTP como transporte.

En Authentication, elige API key y pega una clave de API de Relvato (créala en API access, en la app; una clave de solo lectura solo recibe las herramientas de lectura). La opción OAuth de Perplexity aún no funciona con el inicio de sesión de Relvato: necesita que el servidor registre Perplexity automáticamente, y Relvato no lo ofrece.

Webhooks

La API responde cuando preguntas. Para enterarte en cuanto un monitor encuentra un problema, añade un webhook: Relvato envía un evento JSON firmado a tu URL con cada alerta (Pro y superiores). Configurar un webhook →

Preguntas frecuentes