UptimeRobot

UptimeRobot para agentes de IA

Este repositório é a fonte única de verdade da UptimeRobot para integrações com agentes de IA. Ele publica:

• **llms.txt** e **AGENTS.md** — descoberta e orientação para LLMs e agentes de codificação.
• **.claude-plugin/****, **.cursor-plugin/**, e ****.codex-plugin/** — manifests de plugin instaláveis para Claude Code, Cursor e Codex.
• **skills/** — arquivos de skill autocontidos cobrindo todas as ferramentas MCP da UptimeRobot, além de fluxos de onboarding e runbook.
• **rules/** — regras compartilhadas carregadas tanto pelo Cursor quanto pelo Claude Code.
• **mcp.json** — configuração do servidor MCP no formato Cursor (nome de arquivo sem ponto).
• **.mcp.json** — configuração do servidor MCP do Claude Code (com prefixo de ponto para que o Claude Code registre automaticamente o servidor quando o plugin carregar).
• **codex.mcp.json** — configuração do servidor MCP no formato Codex (chave snake_case mcp_servers, referenciada explicitamente pelo manifesto do Codex).
• **.agents/plugins/marketplace.json** — marketplace do Codex com escopo de repositório para instalação e teste local; o Codex descobre automaticamente este arquivo quando o repositório está aberto.
• **assets/logo.png** — logotipo do marketplace, declarado como icon nos manifestos do Cursor e do Codex (o manifesto do plugin do Claude Code não tem campo de ícone; a listagem do diretório fornece o ícone no momento da submissão).

Os arquivos mcp.json, .mcp.json e codex.mcp.json registram todos o mesmo lançador mcp-remote que faz proxy para https://mcp.uptimerobot.com/mcp e executa o fluxo de navegador OAuth. Os três nomes de arquivo existem apenas porque Claude Code, Cursor e Codex cada um espera sua própria convenção (e o Codex exige mcp_servers em snake_case em vez de mcpServers).

O mesmo conteúdo é espelhado em uptimerobot.com/ para descoberta por crawlers (uptimerobot.com/llms.txt, uptimerobot.com/AGENTS.md, etc.).

Instalação

Claude Code

Pelo marketplace (quando publicado)

A UptimeRobot está sendo submetida ao marketplace de plugins comunitário da Anthropic. Uma vez aceito, adicione esse marketplace uma vez e instale:

/plugin marketplace add anthropics/claude-plugins-community
/plugin install uptimerobot@claude-community

Ou execute /plugin, abra a aba Descobrir, encontre UptimeRobot e instale. (O marketplace comunitário deve ser adicionado primeiro — não é integrado. Apenas o marketplace oficial curado da Anthropic aparece em /plugin sem configuração.)

O servidor MCP se registra automaticamente via .mcp.json assim que o plugin carrega. Na primeira conexão, um navegador abre para você fazer login na UptimeRobot e autorizar o acesso (OAuth) — não há chave de API para colar. Os tokens são armazenados em cache localmente, então você só faz isso uma vez.

Clone local (instalação manual do plugin)

Para executar o plugin completo (skills, regras, comandos e o servidor MCP registrado automaticamente) diretamente de um checkout local — sem necessidade de marketplace — clone o repositório e carregue-o com a flag --plugin-dir:

git clone https://github.com/uptimerobot/ai.git
claude --plugin-dir ./ai

--plugin-dir <path> carrega o plugin de um diretório (o que contém .claude-plugin/plugin.json) apenas para essa sessão. A flag é repetível e também aceita um .zip. Use um caminho absoluto se você iniciar o Claude Code de outro local:

claude --plugin-dir /absolute/path/to/ai

Na primeira conexão, um navegador abre para o fluxo OAuth. Execute /plugin para confirmar que o plugin está carregado e uptimerobot MCP Server mostra ✓ conectado.

Apenas servidor MCP (via script)

Se você quiser apenas as ferramentas MCP sem o restante do plugin (dotfiles, bootstrap de CI), veja [skills/setup/SKILL.md](skills/setup/SKILL.md). Versão resumida:

claude mcp add uptimerobot -- npx -y mcp-remote@latest https://mcp.uptimerobot.com/mcp

Em seguida, saia e reinicie o Claude Code, completando o fluxo de navegador OAuth quando ele aparecer. Execute /plugin para confirmar que uptimerobot MCP Server mostra ✓ conectado.

Cursor

Pelo Marketplace (quando publicado)

Navegue pelo Cursor Marketplace, encontre UptimeRobot e clique em Adicionar ao Cursor. Autorize pelo fluxo de navegador OAuth quando o servidor MCP conectar pela primeira vez — nenhuma chave de API é necessária.

Instalação local (para desenvolvimento e testes pré-submissão)

Siga a documentação de plugins do 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

Inicie o Cursor e execute Developer: Reload Window na paleta de comandos.

Verifique se o plugin foi descoberto:

• Configurações → Regras, Skills, Subagentes — a regra uptimerobot.mdc e cada entrada skills/*/SKILL.md devem estar listadas.
• Configurações → Ferramentas e MCPs — uptimerobot deve aparecer com 32 ferramentas assim que o servidor MCP conectar. Complete o fluxo de navegador OAuth na primeira conexão.

Codex

Instalação local (para desenvolvimento e testes pré-submissão)

Clone o repositório e abra-o no Codex. O marketplace com escopo de repositório em .agents/plugins/marketplace.json é descoberto automaticamente, então UptimeRobot (local) aparecerá no diretório de plugins do Codex sem configuração extra. Instale o plugin e complete o fluxo de navegador OAuth na primeira conexão MCP.

Se você quiser que o Codex rastreie a fonte explicitamente:

codex plugin marketplace add ./

Verifique se o plugin está carregado: as 24 skills devem estar disponíveis e o servidor MCP uptimerobot deve aparecer com 32 ferramentas assim que conectar.

Outros agentes / MCP direto

O servidor está listado no Registro MCP oficial como com.uptimerobot/uptimerobot, então qualquer cliente que conheça o registro pode descobri-lo e instalá-lo sem uma submissão de plugin por cliente. Os metadados estão em server.json:

curl -s "https://registry.modelcontextprotocol.io/v0.1/servers?search=com.uptimerobot/uptimerobot"

Clientes sem suporte a registro podem conectar via o mesmo lançador mcp-remote (OAuth no primeiro uso):

{
  "mcpServers": {
    "uptimerobot": {
      "command": "npx",
      "args": ["-y", "mcp-remote@latest", "https://mcp.uptimerobot.com/mcp"]
    }
  }
}

Headless / CI (sem navegador)

Onde o fluxo de navegador OAuth não pode ser executado, conecte via HTTP simples com uma chave de API principal do painel (Integrações e API) em vez disso:

{
  "mcpServers": {
    "uptimerobot": {
      "type": "http",
      "url": "https://mcp.uptimerobot.com/mcp",
      "headers": { "Authorization": "Bearer YOUR_API_KEY" }
    }
  }
}

O que o plugin oferece

32 ferramentas via MCP, agrupadas por recurso — lista completa e payloads em [AGENTS.md](AGENTS.md) e [skills/](skills/):

Monitores

Ferramenta	Propósito
create-monitor	Criar monitores HTTP, KEYWORD, PING, PORT, HEARTBEAT, DNS, API ou UDP
update-monitor	Alterar nome, URL, intervalo, contatos de alerta, tags, configurações HTTP
update-monitor-status	Pausar ou retomar um monitor
list-monitors	Lista paginada com pesquisa + filtros de estado
get-monitor-details	Configuração completa + estado atual de um monitor
get-monitor-stats	Contagens agregadas de ativo/inativo/pausado + % de uptime
get-response-times	Dados de tempo de resposta em série temporal com buckets

Grupos de monitores (limitado por plano: monitor-groups)

Ferramenta	Propósito
create-monitor-group	Criar um grupo e atribuir monitores a ele
update-monitor-group	Renomear um grupo existente
get-monitor-group	Buscar um único grupo por ID
list-monitor-groups	Lista paginada de grupos

Páginas de status (PSPs)

Ferramenta	Propósito
create-psp	Criar uma página de status pública a partir de monitores, grupos ou tags
update-psp	Alterar nome, domínio, ordem de classificação, visibilidade ou status de publicação
get-psp	Buscar uma única página de status por ID
list-psps	Lista paginada de páginas de status

Anúncios de PSP

Ferramenta	Propósito
create-psp-announcement	Publicar um anúncio (info/manutenção/problema) em uma página de status
update-psp-announcement	Editar título, conteúdo, datas, tipo ou status de publicação
pin-psp-announcement	Fixar um anúncio no topo da página
unpin-psp-announcement	Desafixar um anúncio
get-psp-announcement	Buscar um único anúncio por ID
list-psp-announcements	Lista paginada de anúncios para uma página de status

Janelas de manutenção (limitado por plano: maintenance-window)

Ferramenta	Propósito
create-maintenance-window	Agendar uma janela única ou recorrente que suprime alertas
update-maintenance-window	Alterar agendamento, duração, monitores ou pausar/retomar a janela
get-maintenance-window	Buscar uma única janela por ID
list-maintenance-windows	Lista paginada de janelas

Incidentes

Ferramenta	Propósito
list-incidents	Incidentes em todos os monitores, com intervalo de tempo + filtro de monitor
get-incident-details	Localizações de verificadores por incidente, logs, traceroute

Comentários de incidentes (limitado por plano: incident-comments)

Ferramenta	Propósito
create-incident-comment	Adicionar um comentário a um incidente
update-incident-comment	Editar um comentário existente
list-incident-comments	Lista paginada de comentários em um incidente

Integrações e tags

Ferramenta	Propósito
list-integrations	Integrações de contato de alerta disponíveis
list-tags	Lista paginada de tags na conta

Sem necessidade de conta

A skill quick-monitor-setup cria um monitor HTTPS gratuito apenas com o e-mail de alguém, sem conta, chave de API ou OAuth: o agente chama uma API de prova de trabalho não autenticada e o proprietário confirma clicando em um link em um e-mail de ativação. Guia: https://uptimerobot.com/quick-monitor-setup/.

Requisitos de plano

Os planos da UptimeRobot são Free, Solo, Team, Enterprise. A disponibilidade de tipos de monitor, intervalos mínimos e limites de monitores dependem do plano ativo — o servidor MCP aplica esses limites e retorna o código de erro -28002 (subscription_limit_exceeded) quando uma chamada os excederia. Veja [skills/errors/SKILL.md](skills/errors/SKILL.md).

Solução de problemas

Ferramentas não aparecendo no Claude / Cursor

O handshake do MCP às vezes é concluído depois que o cliente captura sua lista de ferramentas no início da sessão, então as ferramentas parecem ausentes mesmo com o servidor conectado. Correção: saia completamente do cliente (feche o terminal, não apenas /exit) e reinicie. Execute claude mcp list para confirmar que uptimerobot mostra ✓ Connected antes de reiniciar.

Problemas de autenticação

Sintoma	Correção
O navegador OAuth não abriu	Copie a URL de autorização que mcp-remote imprime no terminal e abra-a manualmente
Ferramentas retornam -31001 user_not_found	Limpe os tokens em cache com rm -rf ~/.mcp-auth, depois saia completamente e reinicie para executar novamente o fluxo OAuth
Ferramentas de escrita retornam -31002 access_denied	Reautentique (rm -rf ~/.mcp-auth) com uma conta que tenha permissão de escrita

Códigos de erro da API

Código	Significado	O que fazer
-28001	Limite de monitores atingido	Exclua monitores não utilizados ou faça upgrade do seu plano
-28002	Limite da assinatura	Intervalo agressivo demais para o seu plano, ou tipo de monitor não incluído — aumente o intervalo ou faça upgrade
-29001	Parâmetros inválidos	A mensagem de erro indica os campos problemáticos; corrija-os e tente novamente
-31001	Falha na autenticação	Consulte Problemas de autenticação acima
HTTP 429	Limite de taxa	Aguarde e tente novamente com atraso exponencial

Para a referência completa de erros e receitas de recuperação, consulte skills/errors/SKILL.md.

Contribuindo

Este repositório é gerado / curado. Registre problemas em https://github.com/uptimerobot/ai/issues. Para bugs do servidor MCP, use https://uptimerobot.com/contact.

Privacidade e Termos

• Política de Privacidade
• Termos de Serviço

Licença

MIT. Consulte LICENSE.