Upcheck MCP

npx add-mcp 'https://mcp.upcheck.so/mcp'

Model Context Protocol

Seu monitoramento, como ferramentas que seu assistente pode chamar.

O servidor Upcheck MCP expõe as mesmas operações da API REST via Streamable HTTP. Conecte-o uma vez e pergunte o que está fora do ar, por que um alerta de certificado foi disparado, ou para adicionar o hostname que você acabou de implantar.

Conectar

O servidor está em https://mcp.upcheck.so/mcp e autentica com uma chave de API da organização em Settings → API keys, enviada como um token bearer. Uma chave Member permite que um assistente leia, mas não altere nada, que é o padrão certo para uma ferramenta de chat; use uma chave Admin quando quiser que ele aja.

Claude Code

terminal

claude mcp add --transport http upcheck https://mcp.upcheck.so/mcp \
  --header "Authorization: Bearer uck_your_key"

Cursor — em .cursor/mcp.json (projeto) ou nas configurações globais:

.cursor/mcp.json

{
  "mcpServers": {
    "upcheck": {
      "url": "https://mcp.upcheck.so/mcp",
      "headers": { "Authorization": "Bearer uck_your_key" }
    }
  }
}

VS Code — em .vscode/mcp.json:

.vscode/mcp.json

{
  "servers": {
    "upcheck": {
      "type": "http",
      "url": "https://mcp.upcheck.so/mcp",
      "headers": { "Authorization": "Bearer uck_your_key" }
    }
  }
}

Claude Desktop e outros clientes que só falam stdio podem fazer a ponte via mcp-remote:

claude_desktop_config.json

{
  "mcpServers": {
    "upcheck": {
      "command": "npx",
      "args": [
        "mcp-remote", "https://mcp.upcheck.so/mcp",
        "--header", "Authorization:Bearer uck_your_key"
      ]
    }
  }
}

Qualquer cliente que fale Streamable HTTP pode POST JSON-RPC para a URL com o mesmo cabeçalho. As respostas são JSON simples; nenhum stream SSE fica aberto.

Ferramentas

Cada ferramenta opera dentro da organização da chave. As ferramentas de leitura são marcadas como somente leitura para que um cliente possa executá-las sem perguntar; as destrutivas (remover um site, excluir uma regra) pedem que o assistente confirme com você primeiro.

Websites

Ferramenta	O que faz
list_domains	Cada site monitorado com seu estado mais recente.
get_domain	Um site com detalhes completos de certificado e registro.
add_domain	Começa a monitorar um hostname; testa-o inline.
update_domain	Renomeia o hostname ou seu rótulo.
remove_domain	Para o monitoramento e exclui o site.
refresh_domain	Testa cada verificação em um site agora.
refresh_all_domains	Enfileira um novo teste de cada site.
get_domain_monitors	Cada verificação agendada e seu resultado mais recente.
set_keyword_check	Nomeia o texto que uma página deve (ou não deve) conter.
remove_keyword_check	Esquece o texto e interrompe a verificação de palavra-chave.
set_content_check	Observa uma página, um elemento ou um número nela para mudanças.
remove_content_check	Esquece a página e interrompe a verificação de conteúdo.
set_http_check	Dá à verificação de uptime um caminho, cabeçalhos, um status esperado, texto do corpo e um limite de latência.
reset_http_check	Volta para um GET simples da raiz.
set_port_check	Nomeia as portas TCP, e opcionalmente o host, que devem aceitar uma conexão.
remove_port_check	Esquece as portas e interrompe a verificação de porta.
get_domain_history	Resultados de verificação registrados, do mais recente ao mais antigo.

Alertas

Ferramenta	O que faz
list_alert_rules	Cada regra: assunto, gatilhos, cadência, destinos.
create_alert_rule	Adiciona uma regra; avaliada imediatamente quando ativada.
update_alert_rule	Altera apenas os campos fornecidos; pausa com enabled: false.
delete_alert_rule	Remove uma regra.
list_alert_events	Alertas que foram realmente entregues.

Destinos

Ferramenta	O que faz
list_email_lists	Conjuntos nomeados de destinatários para o canal de e-mail.
create_email_list	Adiciona uma lista.
update_email_list	Renomeia uma lista ou substitui seus endereços.
delete_email_list	Remove uma lista.
list_integrations	Destinos Slack, Discord, Teams e webhook.
create_integration	Registra uma URL de webhook de entrada.
update_integration	Altera apenas os campos fornecidos; silencia com enabled: false.
delete_integration	Remove um destino.
test_integration	Envia um alerta de amostra rotulado para provar a URL.

Equipe e conta

Ferramenta	O que faz
list_team_members	Membros e convites pendentes.
invite_team_member	Cria um convite e retorna seu link de aceite.
update_team_member_role	Altera o papel de um membro.
remove_team_member	Remove um membro ou retira um convite.
get_organization	A qual organização a chave pertence e seu papel.
rename_organization	Renomeia o workspace.
get_stats	As contagens de saúde do painel.
get_activity	A trilha de auditoria, do mais recente ao mais antigo.
get_billing	Estado da assinatura e a estimativa mensal.

Coisas para perguntar

“Quais dos nossos sites estão falhando agora e desde quando?” executa get_stats e list_domains, depois get_domain_monitors nos que estão fora do ar.

“Adicione api.example.com e alerte #ops no Slack se cair” executa add_domain, list_integrations e create_alert_rule com um gatilho http_down limitado ao novo site.

“Por que recebemos um alerta de certificado ontem?” executa list_alert_events e get_domain_history.

Prefere HTTP?

As ferramentas são wrappers finos sobre a API REST, então qualquer coisa que um assistente possa fazer, você também pode scriptar. Veja o guia e a referência da API.

{"@context":"https://schema.org","@graph":[{"@type":"WebPage","@id":"https://upcheck.so/mcp","url":"https://upcheck.so/mcp","name":"Upcheck MCP Server","description":"Connect Claude, Cursor or any MCP client to your Upcheck monitoring. Ask what is failing, add websites, and manage alert rules with an organization API key.","isPartOf":{"@id":"https://upcheck.so/#website"},"about":{"@id":"https://upcheck.so/#software"},"primaryImageOfPage":"https://upcheck.so/og.png","inLanguage":"en","breadcrumb":{"@type":"BreadcrumbList","itemListElement":[{"@type":"ListItem","position":1,"name":"Home","item":"https://upcheck.so"},{"@type":"ListItem","position":2,"name":"Docs","item":"https://upcheck.so/docs"},{"@type":"ListItem","position":3,"name":"Upcheck MCP Server","item":"https://upcheck.so/mcp"}]}}]}