bradesco-rede-mcp

MCP server para consulta em tempo real a rede referenciada do Bradesco Saude. Expoe uma ferramenta search_providers que agentes LLM podem chamar para buscar medicos, hospitais, clinicas e laboratorios.

Instalacao

npm install -g bradesco-rede-mcp

Requer Node 20+. Sem necessidade de browser ou Playwright — o servidor faz chamadas HTTP diretas a API do Bradesco.

Configuracao no cliente MCP

Claude Desktop

Adicione ao claude_desktop_config.json:

{
  "mcpServers": {
    "bradesco-rede": {
      "command": "node",
      "args": ["/caminho/absoluto/bradesco-rede-mcp/dist/index.js"],
      "env": {
        "LOG_LEVEL": "info"
      }
    }
  }
}

opencode

Adicione ao opencode.json na secao mcp, mesmo padrao: command + args + env.

Caminho absoluto e obrigatorio.

Variaveis de ambiente

Todas tem defaults. Configurar e otimizacao, nao pre-requisito.

Variavel	Default	Descricao
CACHE_TTL_MS	600000 (10 min)	TTL de cache
CACHE_MAX_ENTRIES	100	Tamanho maximo do LRU
TIMEOUT_SEARCH_TOTAL_MS	60000 (60s)	Timeout por requisicao a API (evita chamadas penduradas)
LOG_LEVEL	info	debug, info, warn, error
MAX_RESULTS	50	Limite maximo por chamada
BRADESCO_URL	URL oficial	Override da URL alvo

Testes

npm test                                    # unit + integracao
RUN_LIVE_TESTS=true npm run test:live       # live (real API, lento)

Limitacoes

• Uma busca por vez (sem concorrencia). Para v1, inflight=1 + cache em memoria e a unica protecao contra excesso de requisicoes (nao ha delay minimo entre buscas).
• Cache em memoria apenas (volatil ao reiniciar).
• Coordenadas aproximadas (capitais estaduais) — distancias podem ser imprecisas.
• Token de autenticacao renovado automaticamente.
• O filtro plano e aceito mas nao aplicado em v1 (wiring exige lookup de codigoRede, fora do escopo).
• O filtro tipo e aplicado client-side apos a busca (a API nao suporta filtro direto por tipo).
• Busca por localizacao apenas (so estado/cidade) nao e suportada — informe nome (>= 3 chars) ou especialidade.

Troubleshooting

Erro	Causa	Solucao
SITE_UNREACHABLE	API fora do ar ou sem rede	Verificar conexao e tentar novamente
SEARCH_TIMEOUT	Requisicao a API excedeu TIMEOUT_SEARCH_TOTAL_MS	Tentar novamente; se persistir, aumentar o timeout
VALIDATION_ERROR	Filtros insuficientes, UF invalida ou busca por localizacao apenas	Informar nome (>= 3 chars) ou especialidade junto com a localizacao
SCRAPER_CRASH	Erro inesperado	Verificar logs com LOG_LEVEL=debug

Aviso legal

Esta ferramenta automatiza consultas a API publica de rede referenciada do Bradesco Saude para uso pessoal. Nao e afiliada ao Bradesco. O usuario e responsavel por cumprir os Termos de Uso do site alvo. Os dados retornados sao cacheados em memoria por curto periodo e nao sao persistidos ou redistribuidos.