compras_healthcheck
Probe upstream routes of the MCP server to verify each functional module, detecting silent failures like missing contract fields, and report ok, degraded, or down status before demos.
Instructions
Diz, em ~30 segundos, o que está de pé neste servidor agora.
Estende compras_versao: além de versão e configuração, dispara um
probe paralelo (timeout curto) contra as rotas upstream reais e
devolve a situação por módulo funcional.
Por que existe: em 04/08/2026 a tool de pesquisa de preço de material estava quebrada havia semanas e ninguém sabia — a SEGES trocou a assinatura da rota sem versionar. A descoberta veio de um analista tentando usar a ferramenta. Antes de uma demonstração ou de instruir processo, rode isto: o objetivo é que a descoberta aconteça aqui, não no palco.
Args:
profundidade: basico responde só versão/config (instantâneo);
rotas (padrão) executa o probe upstream.
modulo: restringe o probe a um módulo (ex.: pesquisa_preco,
atas, pncp). Sem isso, testa todos.
Situação por módulo:
- ok: todas as rotas responderam com os campos esperados.
- degradado: alguma rota caiu, ou respondeu 200 sem os campos
do contrato (ex.: rota de preço sem precoUnitario) — o modo de
falha silencioso que só o contrato de campos pega.
- fora: todas as rotas testáveis do módulo falharam.
- pulado: faltou credencial (ex.: TRANSPARENCIA_API_KEY).
Rota que estoura o relógio é reexecutada em série antes de virar
fora: com dezenas de rotas em paralelo, uma rota apenas lenta seria
reportada como quebrada. Quando passa na segunda tentativa, o campo
problemas do módulo registra "lenta sob carga" em vez de escondê-lo.
O campo pronto_para_uso é o resumo honesto: False quando existe
qualquer módulo fora ou degradado.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| modulo | No | Restringe o probe a um módulo funcional: 'pesquisa_preco', 'catalogo', 'organizacoes', 'atas', 'contratacoes', 'contratos', 'fornecedores', 'indicadores', 'legado', 'planejamento', 'pncp', 'sancoes', 'comprasnet', 'enriquecimento'. Sem valor, testa todos. | |
| profundidade | No | 'rotas' (padrão) testa as rotas upstream reais em paralelo e devolve situação por módulo (ok/degradado/fora) em ~30s. 'basico' devolve só versão e configuração, sem tocar a rede. | rotas |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||