Relvato

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

Início rápido

Toda solicitação é autenticada com uma chave de API que você cria no aplicativo. Aponte curl, seu CI ou qualquer cliente HTTP para 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"

Autenticação

Envie sua chave em toda solicitação como Authorization: Bearer rlv_your_key (um cabeçalho x-api-key também funciona). Uma chave ausente, revogada ou desconhecida retorna 401.

Crie e revogue chaves em Acesso à API no aplicativo. As chaves começam com rlv_ e são exibidas uma única vez na criação. Cada chave é read-only (sites, execuções, visão geral do site, briefs de correção e configurações de alertas) ou full access (também adiciona sites e verificações, altera agendamentos e executa varreduras). Chaves criadas antes da existência dos escopos têm acesso total. Trate as chaves como uma senha.

Endpoints REST

Todo endpoint é limitado à conta por trás da chave e retorna JSON. URL base https://app.relvato.com/api/v1.

Método	Endpoint	Descrição
GET	/api/v1	Confirma a chave e lista os endpoints disponíveis.
GET	/api/v1/sites	Lista os sites que o Relvato monitora para você.
GET	/api/v1/sites/:id/overview	Verdict de saúde de um site: o que precisa de atenção, a última execução de cada verificação e o uso do plano.
GET	/api/v1/runs	Execuções de verificação recentes, das mais novas para as mais antigas — parâmetros de consulta opcionais siteId e limit (1–100).
GET	/api/v1/runs/:id	Uma execução em detalhes: etapas, avisos, descobertas e métricas (compactadas quando grandes).
GET	/api/v1/runs/:id/fix-prompt	Para uma execução que encontrou um problema: o brief que a própria IA do Relvato responde — stack, o que mudou, o erro e as evidências.
GET	/api/v1/alert-settings	Quem é avisado sobre o quê: frequência, gravidade, canais e roteamento. Nunca URLs ou segredos.
POST	/api/v1/sites/:id/scan	Enfileira uma varredura sob demanda de um site e retorna os IDs das execuções. Requer chave de acesso total; conta contra sua cota mensal de execuções.

Exemplo: listar sites

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

Exemplo: execuções recentes

Uma execução que falhou, mas foi resolvida posteriormente (baseline aceita ou ignorada), reporta status: "passed" com 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
    }
  ]
}

Exemplo: uma execução em detalhes

As descobertas vêm em metrics.items. Uma execução grande é compactada em vez de cortada: séries longas viram resumos, e o que foi omitido é listado em metricsTrimmed — o título e as descobertas são sempre mantidos.

{
  "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)"]
  }
}

Exemplo: brief de correção de uma execução

Para uma execução que encontrou um problema, fix-prompt retorna o brief que a própria IA do Relvato responde: o stack do site, o que mudou logo antes, o erro e as descobertas, e, para Google / Bing Search, as evidências que descartam causas. Entregue ao seu próprio modelo ou leia você mesmo.

{
  "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 …"
}

Limites de taxa

As solicitações são limitadas por minuto, por conta, combinando REST e MCP. Seu plano define o teto:

Plano	Solicitações / min
Gratuito	30
Pro	120
Business	600
Agência	2.400

Toda resposta carrega X-RateLimit-Limit, X-RateLimit-Remaining e X-RateLimit-Reset. Acima do limite, retorna 429 com um cabeçalho Retry-After.

Códigos de status

Status	Significado
200	Sucesso.
400	A solicitação está faltando algo ou não pode ser feita — a mensagem diz o quê.
401	Chave de API ausente, desconhecida ou revogada.
403	A chave é somente leitura e a solicitação alteraria algo ou executaria uma varredura.
404	Site ou execução não encontrado para esta conta.
409	Site desativado, ou você ainda não provou que é o dono (domínio não verificado, ou plugin WordPress nunca conectado).
429	Limite de taxa atingido, ou a cota mensal de execuções foi esgotada.

Servidor MCP (para agentes de IA)

O Relvato também é um servidor Model Context Protocol remoto, então um agente como o Claude pode configurar monitoramento em uma conversa: adicionar um site, orientar você na conexão, escolher as verificações, executá-las e explicar os resultados. Ele usa a mesma chave e o mesmo limite de taxa da API REST. Aceitar baselines, ignorar avisos e correções permanecem no painel, com você acompanhando. Uma chave somente leitura obtém apenas as ferramentas de leitura.

Coisas que você pode pedir a um agente conectado ao Relvato:

• "Por que o checkout falhou na minha loja ontem à noite e como corrijo?"
• "Configure o monitoramento para example.com e me diga o que preciso fazer para conectá-lo."
• "Quem é alertado quando uma verificação de Segurança falha e em quais canais?"

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

Ferramenta	O que faz
list_sites	Lista os sites da conta e se cada um está pronto para executar verificações.
add_site	Adiciona um site e obtém a etapa de configuração: conectar o plugin WordPress ou verificar o domínio.
verify_site	Verifica essa etapa de configuração: a conexão do plugin ou o registro DNS / meta tag de verificação de domínio.
site_overview	Verdict de saúde em linguagem simples: o que precisa de atenção, cada verificação com sua última execução e agendamento, e uso do plano.
list_checks	As verificações que você pode adicionar a um site: o que cada uma detecta, se seu plano inclui e quais são recomendadas.
add_checks	Adiciona verificações a um site; cada uma reporta adicionada, já existente ou o motivo pelo qual não foi possível.
update_check	Ativa ou desativa uma verificação, ou altera seu agendamento.
trigger_scan	Executa as verificações de um site agora — ou uma única verificação — e retorna os IDs das execuções (usa a cota mensal).
list_runs	Lista execuções recentes, das mais novas para as mais antigas — opcionalmente para um site.
get_run	Uma execução em detalhes: status, erro, avisos, etapas, comparações visuais e o link do painel.
get_fix_prompt	Para uma execução que encontrou um problema: o mesmo brief que a própria IA do Relvato responde, para raciocinar sobre a causa provável e as correções.
get_alert_settings	Quem é avisado sobre o quê: frequência, gravidade, estado de cada canal e roteamento — sem URLs ou segredos.

Adicione-o como um conector HTTP remoto. Em um cliente que lê um mcp.json, a entrada fica assim:

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

Webhooks

A API responde quando você pergunta. Para ser avisado no momento em que uma verificação falha, adicione um webhook: o Relvato envia um evento JSON assinado para sua URL a cada alerta (Pro e superior). Configurar um webhook →

Perguntas frequentes

Quais planos incluem acesso à API e ao MCP?

Todos, incluindo o Gratuito — apenas o limite por minuto difere. O Gratuito permite 30 solicitações por minuto; os planos pagos permitem mais.

Como obtenho uma chave?

Entre e abra Acesso à API no aplicativo. Escolha somente leitura ou acesso total para cada chave; você pode criar várias e revogar qualquer uma a qualquer momento.

O que uma chave somente leitura pode fazer?

Tudo o que apenas lê: sites, execuções, visão geral de saúde do site, briefs de correção, configurações de alertas e o catálogo de verificações — via REST e MCP. Um cliente MCP conectado com uma chave somente leitura vê apenas as ferramentas de leitura. Adicionar sites ou verificações, alterar agendamentos e executar varreduras retornam 403 e exigem uma chave de acesso total.

Disparar uma varredura usa minha cota?

Sim. Varreduras sob demanda — via REST ou MCP — consomem a mesma cota mensal de execuções que as verificações agendadas.

Um agente pode adicionar sites e alterar verificações?

Sim — dentro dos limites do seu plano, igual ao painel. Ele não pode pular a propriedade: um novo site só executa depois que o plugin WordPress é conectado ou o domínio é verificado. Aceitar novas baselines, ignorar avisos e aplicar correções não estão disponíveis via MCP.